項目ごとにブロックを選ぶフィールドグループ


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

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

フィールドグループの設定「項目ごとにブロックを 1 つ選ぶ」をオンにすると、項目を追加するときにブロックを選び、その項目には選んだブロックの欄だけを出せます。「見出しと画像」「文章」「リンク」のように、形の違う入力を好きな順に並べたいときに使います。プロフェッショナルライセンス以上で使えます。

ブロックの作り方

このフィールドグループの直下には、次のどちらかだけを置けます。それぞれが 1 つのブロックになります。

ブロックの作り方

型

中のフィールドのキー

その場で定義する

「ブロック」(kind)。中に、そのブロックの項目に出すフィールドを置きます。

そのままのキー

コンポーネントを使う

「コンポーネント」のフィールド

<フィールドのキー>_<中のキー>

「ブロック」は、このフィールドグループの直下にだけ置けます。コンポーネントの中には置けません。

作る手順

「見出しと画像」「文章」の 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 項目の例)

blocks_kind

hero、cta_link、hero

hero_catch

はじめに、(空)、おわりに

hero_image・hero_image@media

メディアの ID、(空)、メディアの ID

text_body

(空)、(空)、(空)

cta_link_url・cta_link_label・cta_link_blank

(空)、値、(空)

  • <器のキー>_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 つ選ぶ」を外せません。先にブロックを削除するか、ほかのフィールドグループへ移します。

  • 値のあるフィールドグループで後から有効にすると、既存の項目はブロックが空になり、ブロックを選ぶまで項目として数えません(値は残ります)。

  • 行数・必須・重複の判定は、選んだブロックの欄だけで行います。

  • スタンダードライセンスでは、この設定のフィールドグループは読み取り専用になります。保存済みの値は消えません。外して保存すると、スタンダードでは付け直せません。