レイアウトの型(見出し・メッセージ・行・タブ・アコーディオン)


この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です

このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。

レイアウトの型は値を保存しません。入力欄を整理するための型です。箱(行・タブの入れ物・タブ・アコーディオン)にフィールドを入れても出しても、中のフィールドのキーと保存される値、テンプレートの書き方は変わりません。

型の一覧

型

型のキー

置ける場所・中に置けるもの

設定(config のキー)

既定値

見出し

heading

どこにでも置けます。

なし(ラベルが見出し、説明が補足になります)

—

メッセージ

message

どこにでも置けます。

「本文」(body)、「スタイル」(style。「情報」info /「警告」warning)

スタイルは情報

行(横並び)

row

中にフィールドを置きます。

「列数」(columns。「2 列」2 /「3 列」3)。列幅を指定していない中のフィールドを、何列に並べるかです。

2

タブの入れ物

tabs

中に置けるのはタブだけです。

なし

—

タブ

tab

タブの入れ物の中にだけ置けます。中にフィールドを置きます。

なし

—

アコーディオン

accordion

中にフィールドを置きます。

「閉じて表示する」(collapsed)。最初は閉じた状態で表示します。中にエラーがあるときは開きます。

オフ(開く)

レイアウトの型も「キー」を持ちますが、値は保存しません。新しく追加するときは、キーが自動で付きます。行・タブの入れ物・アコーディオンは、フィールドグループの中にも置けます。

作る手順

行(横並び)に「店舗名」と「電話番号」を並べる例です。「レイアウト」の「行(横並び)」を、ラベル「名前と電話」・列数「2 列」で追加し、行の中にテキストのフィールド cf_shop_name(店舗名)と cf_shop_tel(電話番号)を追加します。すでにあるフィールドは、ドラッグで箱に入れられます。

タブは、先に「タブの入れ物」を追加し、その中に「タブ」を追加して、タブの中にフィールドを追加します。

定義の例

見出し・メッセージ・行・タブ・アコーディオンを使ったフィールドセットを、テーマの JSON で書いた例です(管理画面で同じものを作ってエクスポートしても、ほぼ同じ形になります)。中に入れるフィールドは parentKey で箱のキーを指します。

{
  "version": 1,
  "entityType": "entry",
  "sets": [
    {
      "code": "shop",
      "label": "店舗情報",
      "fields": [
        { "key": "shop_heading", "label": "店舗情報", "type": "heading", "description": "公開側の店舗ページに表示します。" },
        { "key": "shop_notice", "label": "お知らせ", "type": "message",
          "config": { "body": "営業時間が変わったときは、必ず更新してください。", "style": "warning" } },
        { "key": "shop_row", "label": "名前と電話", "type": "row", "config": { "columns": 2 } },
        { "key": "cf_shop_name", "label": "店舗名", "type": "text", "parentKey": "shop_row" },
        { "key": "cf_shop_tel", "label": "電話番号", "type": "tel", "parentKey": "shop_row" },
        { "key": "shop_tabs", "label": "詳細", "type": "tabs" },
        { "key": "shop_tab_hours", "label": "営業時間", "type": "tab", "parentKey": "shop_tabs" },
        { "key": "cf_shop_open", "label": "開店", "type": "time", "parentKey": "shop_tab_hours", "config": { "width": 50 } },
        { "key": "cf_shop_close", "label": "閉店", "type": "time", "parentKey": "shop_tab_hours", "config": { "width": 50 } },
        { "key": "shop_tab_access", "label": "アクセス", "type": "tab", "parentKey": "shop_tabs" },
        { "key": "cf_shop_access", "label": "アクセス", "type": "textarea", "parentKey": "shop_tab_access" },
        { "key": "shop_more", "label": "その他", "type": "accordion", "config": { "collapsed": true } },
        { "key": "cf_shop_note", "label": "備考", "type": "textarea", "parentKey": "shop_more" }
      ]
    }
  ]
}

編集画面での見え方

  • 見出し: ラベルを見出しとして出し、説明を補足として出します。

  • メッセージ: 本文を、スタイルに合わせた案内(情報・警告)として出します。

  • 行(横並び): 中のフィールドを横に並べます。列幅を指定したフィールドはその幅で、指定していないフィールドは列数で割った幅になります。狭い画面では縦に並びます。

  • タブの入れ物とタブ: 中のタブを 1 つのタブバーに並べます。選んでいないタブの中の入力も送信されます。エラーのあるタブの見出しには印が付きます。

  • アコーディオン: 中のフィールドを、開閉できる見出しの下にまとめます。中にエラーがあれば開きます。

レイアウトの型を使った編集画面
レイアウトの型を使った編集画面

保存されるキーとテンプレート

上の例で保存されるのは、cf_shop_name・cf_shop_tel・cf_shop_open・cf_shop_close・cf_shop_access・cf_shop_note だけです。shop_row などの箱のキーには値はありません。テンプレートでは、箱を意識せずにそのまま書きます。

<!-- BEGIN_MODULE Entry_Field -->
<h2>{cf_shop_name}</h2>
<p>電話: <a href="tel:{cf_shop_tel}">{cf_shop_tel}</a></p>
<p>営業時間: {cf_shop_open}〜{cf_shop_close}</p>
<p>{cf_shop_access}[nl2br]</p>
<!-- BEGIN cf_shop_note:veil --><p>{cf_shop_note}[nl2br]</p><!-- END cf_shop_note:veil -->
<!-- END_MODULE Entry_Field -->

注意

  • タブの入れ物の中にはタブだけ、タブはタブの入れ物の中にだけ置けます。置けない位置にはドラッグできません。

  • 箱を削除すると、中のフィールドは 1 つ上の階層に移ります(中のフィールドは削除されません)。

  • 箱に「権限・ロール別の表示」や「条件付き表示」を付けると、中のフィールドにも効きます。

  • フィールドセットそのものに、セクションやタブの見た目を選ぶ設定はありません。タブで切り替えたいときは「タブの入れ物」と「タブ」を使います。