レイアウトの型(見出し・メッセージ・行・タブ・アコーディオン)
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
レイアウトの型は値を保存しません。入力欄を整理するための型です。箱(行・タブの入れ物・タブ・アコーディオン)にフィールドを入れても出しても、中のフィールドのキーと保存される値、テンプレートの書き方は変わりません。
型の一覧
型 | 型のキー | 置ける場所・中に置けるもの | 設定(config のキー) | 既定値 |
|---|---|---|---|---|
見出し |
| どこにでも置けます。 | なし(ラベルが見出し、説明が補足になります) | — |
メッセージ |
| どこにでも置けます。 | 「本文」( | スタイルは情報 |
行(横並び) |
| 中にフィールドを置きます。 | 「列数」( |
|
タブの入れ物 |
| 中に置けるのはタブだけです。 | なし | — |
タブ |
| タブの入れ物の中にだけ置けます。中にフィールドを置きます。 | なし | — |
アコーディオン |
| 中にフィールドを置きます。 | 「閉じて表示する」( | オフ(開く) |
レイアウトの型も「キー」を持ちますが、値は保存しません。新しく追加するときは、キーが自動で付きます。行・タブの入れ物・アコーディオンは、フィールドグループの中にも置けます。
作る手順
行(横並び)に「店舗名」と「電話番号」を並べる例です。「レイアウト」の「行(横並び)」を、ラベル「名前と電話」・列数「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 つ上の階層に移ります(中のフィールドは削除されません)。
箱に「権限・ロール別の表示」や「条件付き表示」を付けると、中のフィールドにも効きます。
フィールドセットそのものに、セクションやタブの見た目を選ぶ設定はありません。タブで切り替えたいときは「タブの入れ物」と「タブ」を使います。
