項目ごとにブロックを選ぶフィールドグループ
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
フィールドグループの設定「項目ごとにブロックを 1 つ選ぶ」をオンにすると、項目を追加するときにブロックを選び、その項目には選んだブロックの欄だけを出せます。「見出しと画像」「文章」「リンク」のように、形の違う入力を好きな順に並べたいときに使います。プロフェッショナルライセンス以上で使えます。
ブロックの作り方
このフィールドグループの直下には、次のどちらかだけを置けます。それぞれが 1 つのブロックになります。
ブロックの作り方 | 型 | 中のフィールドのキー |
|---|---|---|
その場で定義する | 「ブロック」( | そのままのキー |
コンポーネントを使う | 「コンポーネント」のフィールド |
|
「ブロック」は、このフィールドグループの直下にだけ置けます。コンポーネントの中には置けません。
作る手順
「見出しと画像」「文章」の 2 つのブロックと、コンポーネント link(コンポーネント で作ったもの)を選べるようにする例です。
フィールドセットで「フィールドグループ」を追加し(キー blocks・ラベル「ブロック」)、高度な設定で「項目ごとにブロックを 1 つ選ぶ」にチェックします。器の中に、「ブロック」としてキー hero(見出しと画像。中にテキスト hero_catch とメディア画像 hero_image)とキー text(文章。中にテキストエリア text_body)を追加し、「コンポーネント」としてキー cta_link(使うコンポーネントは「リンク(link)」)を追加します。
定義の例(テーマの JSON で書いた場合):
{
"version": 1,
"entityType": "entry",
"sets": [
{
"code": "contents",
"label": "ページの内容",
"fields": [
{ "key": "blocks", "label": "ブロック", "type": "group", "config": { "componentPerRow": true, "maxRows": 20 } },
{ "key": "hero", "label": "見出しと画像", "type": "kind", "parentKey": "blocks" },
{ "key": "hero_catch", "label": "キャッチコピー", "type": "text", "parentKey": "hero" },
{ "key": "hero_image", "label": "画像", "type": "media-image", "parentKey": "hero" },
{ "key": "text", "label": "文章", "type": "kind", "parentKey": "blocks" },
{ "key": "text_body", "label": "本文", "type": "textarea", "parentKey": "text" },
{ "key": "cta_link", "label": "リンク", "type": "component", "parentKey": "blocks", "config": { "component": "link" } }
]
}
]
}編集画面での見え方
項目を足すときにブロックを選び、項目には、選んだブロックの欄だけが出ます。
項目の見出しは「項目 1(見出しと画像)」のように、選んだブロックの名前付きで出ます。
ブロックが選ばれていない項目は、空の項目として扱われます。「ブロックを選ぶ」でブロックを選べます。
別のブロックに選び直すと、前のブロックの欄の値は保存したときに消えます(選び直す前に確認が出ます)。
保存されるキー
普通のフィールドグループと同じ形で保存し、項目ごとに選んだブロックを <器のキー>_kind に保存します。
キー | 保存される値(「見出しと画像」「リンク」「見出しと画像」の 3 項目の例) |
|---|---|
|
|
|
|
| メディアの ID、(空)、メディアの ID |
| (空)、(空)、(空) |
| (空)、値、(空) |
<器のキー>_kindの値は、選んだブロックのキー(型「ブロック」のキー、またはコンポーネントのフィールドのキー)です。保存の前に、選んでいないブロックの欄は空になります。
<器のキー>_kindのキーが 64 文字を超えるとき、ほかのキーと重なるときは、この設定は効かず、普通のフィールドグループとして扱われます。
テンプレートの例
ループの中で {blocks_kind} を見て、ブロックごとに出し分けます。
<!-- BEGIN_MODULE Entry_Field -->
<!-- BEGIN blocks:loop -->
<!-- BEGIN_IF [{blocks_kind}/eq/hero] -->
<section class="block-hero">
<h2>{hero_catch}</h2>
<img src="%{MEDIA_ARCHIVES_DIR}{hero_image@path}" alt="{hero_image@alt}">
</section>
<!-- ELSE_IF [{blocks_kind}/eq/text] -->
<div class="block-text">{text_body}[nl2br]</div>
<!-- ELSE_IF [{blocks_kind}/eq/cta_link] -->
<p class="block-link"><a href="{cta_link_url}">{cta_link_label}</a></p>
<!-- END_IF -->
<!-- END blocks:loop -->
<!-- END_MODULE Entry_Field -->{% set f = module('V2_Entry_Field').fields %}
{% for row in f.blocks %}
{% if row.blocks_kind.value == 'hero' %}
<section class="block-hero"><h2>{{ row.hero_catch.value }}</h2></section>
{% elseif row.blocks_kind.value == 'text' %}
<div class="block-text">{{ row.text_body.value|nl2br }}</div>
{% elseif row.blocks_kind.value == 'cta_link' %}
<p class="block-link"><a href="{{ row.cta_link_url.value }}">{{ row.cta_link_label.value }}</a></p>
{% endif %}
{% endfor %}注意
直下に「ブロック」があるあいだは、「項目ごとにブロックを 1 つ選ぶ」を外せません。先にブロックを削除するか、ほかのフィールドグループへ移します。
値のあるフィールドグループで後から有効にすると、既存の項目はブロックが空になり、ブロックを選ぶまで項目として数えません(値は残ります)。
行数・必須・重複の判定は、選んだブロックの欄だけで行います。
スタンダードライセンスでは、この設定のフィールドグループは読み取り専用になります。保存済みの値は消えません。外して保存すると、スタンダードでは付け直せません。