Skip to content

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

子の出し分けと繰り返し。自分の枠を持たず、子は親の直下に書いたものとして配置・検査されます。

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

If ​

条件が真のときだけ、子を表示します。非表示の中身もクエリは実行され、閲覧者に送信されます。データを見せない目的には使えません。

構造 ​

項目内容
区分control
親子に block・inline・control のいずれかを取る要素
子親と同じ
SqlView の子孫可

属性 ​

属性値内容
condition(必須)式(真偽値)子を表示する条件

例 ​

html
<SqlView id="…" page="…" sql="…" hideFrame>
  <If condition="{{ size(rows) == 0 }}">
    <Text color="muted">データがない</Text>
  </If>
  <ElseIf condition="{{ row.mom < 0 }}">
    <Text color="danger">前月より減少</Text>
  </ElseIf>
  <Else>
    <Text color="success">前月より増加</Text>
  </Else>
</SqlView>

ElseIf ​

直前までの条件がすべて偽で、この条件が真のときに子を表示します。<If> か <ElseIf> の直後に書きます。

構造 ​

項目内容
区分control
親子に block・inline・control のいずれかを取る要素
子親と同じ
SqlView の子孫可

属性 ​

属性値内容
condition(必須)式(真偽値)子を表示する条件

Else ​

直前までの条件がすべて偽のときに、子を表示します。<If> か <ElseIf> の直後に書きます。<For> の直後に書くと、1 回も繰り返さなかったとき(行やグループがないときと、where に一致するものがないとき)に表示します。

構造 ​

項目内容
区分control
親子に block・inline・control のいずれかを取る要素
子親と同じ
SqlView の子孫可

属性 ​

属性はありません。

For ​

<SqlView> の結果の行ごとに、子を繰り返します。<Group> の中では、in を書くと、グループやグループの行を繰り返せます。

構造 ​

項目内容
区分control
親子に block・inline・control のいずれかを取る要素
子親と同じ
SqlView の子孫子孫のみ

使い方 ​

  • 行の並び順は、SQL の ORDER BY で決めます。orderBy は、最新の 1 行を選ぶときや、view.<名前> で閲覧者が並び順を切り替えるときに使います
  • <For> の中に <For> は書けません。in を書いた <For> だけは、<For> の中にも書けます。その場合、in には、すぐ外側の <For> の変数({{ g.rows }}・{{ g.groups }})だけを指定できます
  • <Group> と組み合わせる(in を書く)ときは、次のようになります
    • where・orderBy・index・limit は、in の配列(行かグループ)に適用されます。並び順の既定は、配列の順です
    • as・index には、外側の <For>・<Group> と別の名前を付けます
    • fill の列で分けた groups と axes を繰り返すときは、where・orderBy・desc・limit を書けません。見出しとセルの列がずれるためです

属性 ​

属性値内容
as(必須)識別子繰り返している行を参照する変数の名前。in を書いたときは、in の配列の要素(行かグループ)
in式(配列)<Group> の中で、繰り返す配列を {{ p.groups }}・{{ g.rows }}・{{ p.axes.month }} の形で指定します。演算や関数は書けません(記法の「行のグループ化」)。未指定時は、<SqlView> の結果の行です
where式(真偽値)繰り返す行を選ぶ条件。受け取った行(1,000 行まで)から選びます。データを減らすときは、SQL で絞り込みます
orderBy式(数値・文字列)並べ替えのキー。where で選んだ行を並べ替えます。index と limit は、並べ替えた後の順で数えます。同じ値の行は SQL の結果の順を保ち、NULL と実行時エラーは最後になります。文字列は、日本語の照合順で比べます。キーを式で切り替えるとき(c ? a : b)は、どちらも同じ型にします(文字列と数値を切り替えるときは、SQL で順位の列を作ります)。未指定時は、SQL の結果の順です
desc真偽値
式:単一式
orderBy を降順にします
index識別子何回目の繰り返しか(1 から)を表す変数の名前
limit整数(1 以上)繰り返す回数の上限

例 ​

html
<Select as="tier" variant="segmented">
  <SelectOption value="gold" title="ゴールド" default />
  <SelectOption value="silver" title="シルバー" />
</Select>
<SqlView id="…" page="…" sql="…">
  <Columns>
    <For as="r" where="{{ r.tier == view.tier }}" limit="3">
      <Card title="{{ r.name }}">
        <Text size="xl" weight="bold">{{ r.amount }}</Text>
      </Card>
    </For>
    <Else>
      <Text color="muted">該当する顧客はいません</Text>
    </Else>
  </Columns>
</SqlView>
html
<Select as="sort" variant="segmented">
  <SelectOption value="amount" title="売上順" default />
  <SelectOption value="mom" title="伸び率順" />
</Select>
<SqlView id="…" page="…" sql="…">
  <Columns>
    <For as="r" index="i" orderBy="{{ view.sort == 'mom' ? r.mom : r.amount }}" desc limit="3">
      <Card title="{{ i }}位 {{ r.name }}">
        <Text size="xl" weight="bold">{{ r.amount }}</Text>
      </Card>
    </For>
  </Columns>
</SqlView>

Group ​

<SqlView> の結果の行を列の値でグループ化し、as の変数として子孫に渡します。自分では何も表示せず、子をそのまま表示します。グループを繰り返すには、<For> の in を使います。

構造 ​

項目内容
区分control
親子に block・inline・control のいずれかを取る要素
子親と同じ
SqlView の子孫子孫のみ

使い方 ​

属性 ​

属性値内容
as(必須)識別子グループ化したデータを参照する変数の名前
by(必須)文字列グループ化する列の名前(3 個まで、, 区切り)。書いた順に入れ子にします。by="store, month" なら、店舗のグループの中に、月のグループを作ります
fill文字列クロス表のように、どの店舗のグループにも同じ月を並べたいときに指定する列の名前(by の 2 個目以降の列、, 区切り)。結果に出たすべての値のグループを、同じ順に作ります。行のない組み合わせは、空のグループになります
fillDesc文字列降順に並べる fill の列の名前(, 区切り)。fill の列は、未指定時は値の昇順です

例 ​

html
<SqlView id="…" page="…" sql="…" hideFrame>
  <Group as="p" by="region">
    <Columns>
      <For as="g" in="{{ p.groups }}">
        <Card title="{{ g.row.region }}">
          <For as="r" in="{{ g.rows }}" limit="3">
            <Text>{{ r.store }}:{{ formatNumber(r.sales, "compact") }}</Text>
          </For>
        </Card>
      </For>
    </Columns>
  </Group>
</SqlView>

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