Skip to content

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

中身の一部を、閲覧者の操作で表示・非表示にする要素。開閉や選んでいるタブは閲覧者ごとの表示の状態で、保存や共有はされません。

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

Tabs ​

タブで中身を切り替えます。

構造 ​

項目内容
区分block
親子に block を取る要素
子Tab+
SqlView の子孫可

使い方 ​

  • 少なくとも 1 つの <Tab> に中身を書きます
  • すべてのタブのクエリは、ページと一緒に実行されます。タブを切り替えても再実行されません
  • 値を選ぶだけなら、<Select> を使います
  • タブで切り替わる範囲が分かりにくいときは、<Card> で囲むと区別できます(Tabs と後ろの要素は、区切りなく続けて表示されます)
  • <For> の中では as を書けません。開いているタブは、繰り返しの 1 回ごとに持ちます

属性 ​

属性値内容
as識別子選んだタブの値(value)を、式で view.<名前> として参照するための名前。同じ名前の要素は、状態を共有します
variantdefault / segmented
既定:default
切り替えの見た目。default はタブ、segmented はボタンの並び。モバイル表示では、segmented もドロップダウンになります
heightpx(例:320px)高さ

例 ​

html
<Tabs>
  <Tab title="売上">
    <Chart id="…" page="…" chart="…" />
  </Tab>
  <Tab title="注文数">
    <Chart id="…" page="…" chart="…" />
  </Tab>
</Tabs>

Tab ​

<Tabs> の 1 つのタブです。

構造 ​

項目内容
区分―
親Tabs
子block*
SqlView の子孫可

属性 ​

属性値内容
title(必須)文字列
式:文字+式
タブのタイトル
value英数字・_・-このタブを選んだときの view.<名前> の値。同じ <Tabs> の中で重複しない値にします。<Tabs> に as を書いたときは必須です
default真偽値最初に選ばれた状態にします。同じ <Tabs> の中で 1 つまで書けます。どのタブにも書かないときは、最初のタブが選ばれます
description文字列
式:文字+式
タイトルや枠の横の ? のアイコンで表示する説明
gapnone / xs / sm / md / lg / xl
既定:md
子の間隔

Collapse ​

その場で中身を開閉します。詳細や定義を載せるときに使います。

構造 ​

項目内容
区分block
親子に block を取る要素
子block*
SqlView の子孫可

使い方 ​

  • 子孫のクエリは、閉じていてもページと一緒に実行されます。開いても再実行されません
  • <For> の中では as を書けません。開閉は、繰り返しの 1 回ごとに持ちます

属性 ​

属性値内容
title(必須)文字列
式:文字+式
見出しの行のタイトル
as識別子開いているかどうか(真偽値)を、式で view.<名前> として参照するための名前。同じ名前の要素は、状態を共有します
open真偽値最初に開いた状態にします
description文字列
式:文字+式
タイトルや枠の横の ? のアイコンで表示する説明
gapnone / xs / sm / md / lg / xl
既定:md
子の間隔
heightpx(例:320px)高さ

例 ​

html
<Collapse title="指標の定義">
  <Text>解約率は、月初の契約数に対する、月内に解約した契約数の割合。</Text>
</Collapse>
html
<SqlView id="…" page="…" sql="…" hideFrame>
  <For as="r">
    <Collapse title="{{ r.store }}">
      <Sparkline values="{{ r.trend }}" height="40px" />
      <Text color="muted">{{ r.comment }}</Text>
    </Collapse>
  </For>
</SqlView>

Popover ​

親の要素にポインターを合わせたとき、またはクリックしたときに、中身をポップアップで表示します。指標の内訳や推移のチャート、表の行の詳細など、常に表示するほどではない補足に使います。

構造 ​

項目内容
区分―
親Card | TableCell | MatrixCell | TimelineItem
子block*
SqlView の子孫可

使い方 ​

  • 親の要素の先頭に、1 つまで書けます
  • 画面に収まらないときは、幅と高さが縮み、中身はスクロールして表示されます
  • 子孫のクエリは、閉じていてもページと一緒に実行されます。開いても再実行されません
  • PDF とスクリーンショットには表示されません

属性 ​

属性値内容
triggerhover / click
既定:hover
開き方。hover は親の要素にポインターを合わせたとき、click は親の要素をクリックしたときに開きます。モバイル表示では、どちらもタップで開閉します
sizesm / md / lg / parent
既定:md
幅。sm は 280px、md は 400px、lg は 560px。parent は親の要素と同じ幅で、280px より狭くはしません
gapnone / xs / sm / md / lg / xl
既定:md
子の間隔

例 ​

html
<Card title="粗利率">
  <Popover>
    <Text>(売上 − 原価)÷ 売上</Text>
    <Text color="muted">返品と送料は除きます。</Text>
  </Popover>
  <Text size="2xl" weight="bold">32.4%</Text>
</Card>
html
<SqlView id="…" page="…" sql="…">
  <Table>
    <TableRow header>
      <TableCell><Text>店舗</Text></TableCell>
      <TableCell align="end"><Text>売上</Text></TableCell>
    </TableRow>
    <For as="r">
      <TableRow>
        <TableCell>
          <Popover>
            <Text>担当:{{ r.manager }}</Text>
            <Text>開店:{{ formatDate(r.opened_at, 'dayjs', 'YYYY/M/D') }}</Text>
          </Popover>
          <Text>{{ r.store }}</Text>
        </TableCell>
        <TableCell align="end"><Text>{{ formatNumber(r.sales, "d3", ",d") }}</Text></TableCell>
      </TableRow>
    </For>
  </Table>
</SqlView>
html
<Tree>
  <TreeNode>
    <Card title="全社">
      <!-- 幅と見た目をカードにそろえる -->
      <Popover trigger="click" size="parent">
        <Chart id="…" page="…" chart="…" hideFrame height="200px" />
      </Popover>
      <Text>1.2億円</Text>
    </Card>
  </TreeNode>
</Tree>

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