Appearance
マークアップページの要素(値)
値によって見た目(色・記号・長さ)が決まる要素。
すべての要素に共通するルール(構造の表記、配置の属性、デザイントークン)は、要素一覧を参照してください。
Delta
増減を、向きの記号(↑↓→)と色で表示します。見た目は、KPI チャートの比較(前期間比)と同じです。前月比や前年比のように、符号で良し悪しが分かる値に使います。
構造
| 項目 | 内容 |
|---|---|
| 区分 | inline |
| 親 | Text | Span |
| 子 | なし(/> で閉じる) |
SqlView の子孫 | 可 |
使い方
- 大きさは親に従います。大きな値の横に小さく表示するときは、
<Span size="…">で包みます - 良し悪しの境目は 0 で固定です。目標などと比べるときは、差(実績 − 目標)を SQL で求めて渡します
属性
| 属性 | 値 | 内容 |
|---|---|---|
value(必須) | 数値 式:単一式 | 増減の値。正の値は ↑ と +、負の値は ↓、0 は → を薄い色で表示します。NULL や実行時エラーのときは ― と表示されます |
format | d3-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 の外の値は、端に表示します |
format | d3-format の書式 | 値の書式(".1%"・"{,d}円" など)。未指定時は、閲覧者の言語設定の既定の書式です。fraction では value と max の両方、percent では比(未指定時は ".0%")に適用します |
variant | default / compact既定: default | 見た目。default は棒の右に文字を表示します。compact は文字に細い棒を添える形で、表のセルに使います |
textType | fraction / value / percent / none | 棒と一緒に表示する文字。fraction(15 / 50)、value(15)、percent(30%)、none(なし)。未指定時は、variant が default のときは fraction、compact のときは value です |
color | default / 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 で、線をそこで切ります。上限を超える並びや、数値でない要素があるときは、何も描きません |
variant | default / area / bar既定: default | 見た目。default は折れ線、area は面、bar は棒です |
min | 数値 式:単一式 | 縦の範囲の下端。未指定時は、default は値の最小、area と bar は 0 と値の最小の小さい方です。範囲の外の値は端に寄せます |
max | 数値 式:単一式 | 縦の範囲の上端。未指定時は、default は値の最大、area と bar は 0 と値の最大の大きい方です。表の行ごとに並べて見比べるときは、全行の最大(max="{{ r.max_sales }}")を渡して縮尺を揃えます |
color | default / muted / danger / warning / success既定: default式:単一式 | 線・面・棒の色 |
height | px(例: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>