Skip to content

マークアップページの要素(値) ​

値によって見た目(色・記号・長さ)が決まる要素。

すべての要素に共通するルール(構造の表記、配置の属性、デザイントークン)は、要素一覧を参照してください。

Delta ​

増減を、向きの記号(↑↓→)と色で表示します。見た目は、KPI チャートの比較(前期間比)と同じです。前月比や前年比のように、符号で良し悪しが分かる値に使います。

構造 ​

項目内容
区分inline
親Text | Span
子なし(/> で閉じる)
SqlView の子孫可

使い方 ​

  • 大きさは親に従います。大きな値の横に小さく表示するときは、<Span size="…"> で包みます
  • 良し悪しの境目は 0 で固定です。目標などと比べるときは、差(実績 − 目標)を SQL で求めて渡します

属性 ​

属性値内容
value(必須)数値
式:単一式
増減の値。正の値は ↑ と +、負の値は ↓、0 は → を薄い色で表示します。NULL や実行時エラーのときは ― と表示されます
formatd3-format の書式値の書式(".1%"・"{,d}円" など)。未指定時は、閲覧者の言語設定の既定の書式です。書式で符号を指定しなくても、正の値には + が付きます
downIsGood真偽値
式:単一式
減少を良い(success)、増加を悪い(danger)として表示します。解約率のような指標に使います

例 ​

html
<Text size="sm">前月比 <Delta value="0.082" format=".1%" /></Text>
<Text size="sm">解約率 <Delta value="0.004" format=".1%" downIsGood /></Text>

Progress ​

値と上限の比を横棒で表示します。目標に対する進み具合と、表のセルの棒(データバー)に使います。

構造 ​

項目内容
区分block
親子に block を取る要素
子なし(/> で閉じる)
SqlView の子孫可

使い方 ​

  • 前年差のように正負に振れる値は、min に負の値を書きます(min="{{ -r.max_abs }}" max="{{ r.max_abs }}")。色は color に式で書き分けます
  • 値の文字は折り返し表示されないため、狭い場所に桁の大きい値を表示する場合は、format="~s"(1.2M など)や textType="percent" を指定します

属性 ​

属性値内容
value(必須)数値
式:単一式
値。棒は 0 の位置から値まで伸びます。min より小さい値は min、max より大きい値は max まで表示します。NULL や実行時エラーのときは、空の棒と ― が表示されます
max(必須)数値
式:単一式
棒を満たす値。目標(max="1000000")や、列の最大値(max="{{ max(rows, 'sales') }}")を書きます
min数値
既定:0
式:単一式
棒の左端の値。負の値を表示するときは、0 より小さい値を書きます
target数値
式:単一式
目標の値。その位置に縦の線を表示します。min・max の外の値は、端に表示します
formatd3-format の書式値の書式(".1%"・"{,d}円" など)。未指定時は、閲覧者の言語設定の既定の書式です。fraction では value と max の両方、percent では比(未指定時は ".0%")に適用します
variantdefault / compact
既定:default
見た目。default は棒の右に文字を表示します。compact は文字に細い棒を添える形で、表のセルに使います
textTypefraction / value / percent / none棒と一緒に表示する文字。fraction(15 / 50)、value(15)、percent(30%)、none(なし)。未指定時は、variant が default のときは fraction、compact のときは value です
colordefault / muted / danger / warning / success
既定:default
式:単一式
棒の色。文字の色は変わりません

例 ​

html
<Text>今月の売上目標</Text>
<Progress value="650000" max="1000000" target="750000" format="{,d}円" />
html
<SqlView id="…" page="…" sql="…">
  <Table>
    <For as="r" limit="10">
      <TableRow>
        <TableCell><Text>{{ r.region }}</Text></TableCell>
        <TableCell>
          <Progress
            value="{{ r.sales }}"
            max="{{ max(rows, 'sales') }}"
            variant="compact"
            format=",d"
            color="{{ r.sales < r.target ? 'warning' : 'default' }}"
          />
        </TableCell>
      </TableRow>
    </For>
  </Table>
</SqlView>

Sparkline ​

値の並びを、軸や目盛りのない小さな図で表示します。表の行やカードに、推移を添えるのに使います。

構造 ​

項目内容
区分block
親子に block を取る要素
子なし(/> で閉じる)
SqlView の子孫可

使い方 ​

  • 値の並びは SQL で作ります。BigQuery なら STRING_AGG(CAST(sales AS STRING), ',' ORDER BY month) のように、並べたい順に連結します。配列の列はそのまま参照できません
  • 値は表示されません。最新の値などは、隣に <Text> や <Delta> で表示します
  • 軸、凡例、複数の系列、日付の間隔を反映した横軸が要るときは、ドキュメントページでチャートを作り、<Chart> で表示します

属性 ​

属性値内容
values(必須)数値の並び(カンマ区切り、100 個まで)
式:単一式
値の並び。カンマ区切りの数値(values="3,5,,8")か、それを返す式(values="{{ r.trend }}")です。空の要素は NULL で、線をそこで切ります。上限を超える並びや、数値でない要素があるときは、何も描きません
variantdefault / area / bar
既定:default
見た目。default は折れ線、area は面、bar は棒です
min数値
式:単一式
縦の範囲の下端。未指定時は、default は値の最小、area と bar は 0 と値の最小の小さい方です。範囲の外の値は端に寄せます
max数値
式:単一式
縦の範囲の上端。未指定時は、default は値の最大、area と bar は 0 と値の最大の大きい方です。表の行ごとに並べて見比べるときは、全行の最大(max="{{ r.max_sales }}")を渡して縮尺を揃えます
colordefault / muted / danger / warning / success
既定:default
式:単一式
線・面・棒の色
heightpx(例:320px)
既定:24px
高さ

例 ​

html
<Sparkline values="3,5,4,8,6,9,12" variant="area" />
html
<SqlView id="…" page="…" sql="…">
  <Card title="売上(日次)">
    <Columns gap="md">
      <Text size="2xl" weight="bold" grow="0">{{ formatNumber(row.sales_latest, "compact") }}</Text>
      <Sparkline values="{{ row.sales_trend }}" height="40px" />
    </Columns>
  </Card>
</SqlView>
html
<SqlView id="…" page="…" sql="…">
  <Table>
    <For as="r">
      <TableRow>
        <TableCell><Text>{{ r.region }}</Text></TableCell>
        <TableCell>
          <Sparkline
            values="{{ r.trend }}"
            variant="bar"
            max="{{ r.max_sales }}"
            color="{{ r.mom < 0 ? 'danger' : 'success' }}"
          />
        </TableCell>
      </TableRow>
    </For>
  </Table>
</SqlView>

Codatum CLI AIエージェントのための分析環境