コンテンツへスキップ

バリエーション

Block Variation APIを使うと、既存ブロックにカスタムバリエーションを登録できます。

単純なセレクトフィールドの値に応じて、2種類のバリエーションを持つブロックを想定してみましょう。

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "blockstudio/variations",
  "title": "Native Variation",
  "description": "Native Blockstudio Variation block.",
  "icon": "star-filled",
  "variations": [
    {
      "name": "variation-2",
      "title": "Native Variation 2",
      "description": "Native Blockstudio Variation block 2.",
      "attributes": {
        "select": {
          "value": "variation-2"
        }
      }
    }
  ],
  "blockstudio": {
    "attributes": [
      {
        "id": "select",
        "type": "select",
        "label": "Select",
        "options": [
          {
            "value": "variation-1",
            "label": "Variation 1"
          },
          {
            "value": "variation-2",
            "label": "Variation 2"
          }
        ],
        "default": {
          "value": "variation-1"
        }
      }
    ]
  }
}

上記により、インサーターにメインのブロック1つと2つのバリエーション、合計3つのブロックが作成されます。

属性を非表示にする

属性はサイドバーに適切な入力欄を自動的に表示します。バリエーションブロックは特定の属性値に依存するため、それらのフィールドをサイドバーで非表示にしたい場合があります。その場合はhiddenオプションを使います。

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "select",
        "type": "select",
        "label": "Select",
        "hidden": true,
        "options": [
          {
            "value": "variation-1",
            "label": "Variation 1"
          },
          {
            "value": "variation-2",
            "label": "Variation 2"
          }
        ]
      }
    ]
  }
}