# あらゆるブロックにフィールドを追加

純粋なJSON。テンプレートもレンダリングコールバックも不要。

## カスタムフィールド、テンプレート不要

JSONファイルを作成し、`name` でブロックを指定して、フィールドを定義します。`set` は値をクラス、スタイル、data属性、その他のHTML属性に割り当てます。

BlockstudioはWordPressHTML Tag Processorで出力を適用します。テンプレートもレンダリングコールバックも不要です。

[拡張機能の基本](https://blockstudio.dev/ja/docs/extensions/)

extend-animation.json

```
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "allowNull": "None",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ],
        "set": [{
          "attribute": "class",
          "value": "animate-{attributes.animation}"
        }]
      }
    ]
  }
}
```

## 任意のブロックを対象に

ブロック、リスト、または名前空間のワイルドカードを拡張できます。

## setプロパティ

フィールドをクラス、スタイル、data属性、その他のHTML属性に割り当てます。

## 条件付きフィールド

ブロックと同様の条件分岐で、他の値に応じてフィールドを表示します。

## すべての機能を搭載

すべてのフィールド型、条件分岐、動的な選択肢、プロパティを利用できます。

## インスペクター内の配置

設定、スタイル、詳細タブにフィールドを配置できます。

## 優先度による順序

同じブロックを対象とする複数の拡張機能の順序を設定できます。

## レンダリングコールバック不要

HTML Tag Processorが出力を自動的に適用します。

## JSON Schema

専用スキーマによる入力補完と検証。

## setで値をHTMLに割り当てる

`set` は、`{attributes.fieldId}` のようなドット記法で、値をクラス、インラインスタイル、data属性、その他のHTML属性に割り当てます。

ネストされたオブジェクトの値にアクセスして条件に応じて適用したり、1つのフィールドの値を複数の属性に出力したりできます。

複数の値を返すフィールドでは、それぞれの値に `set` が適用されます。クラスとスタイルは追加されます。それ以外の属性では、`"join": true` が最後の値だけを残さず、すべての値をスペース区切りで書き込みます。

[setプロパティ](https://blockstudio.dev/ja/docs/extensions/#attributes)

extend-color.json

```
{
  "name": "core/heading",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "customColor",
        "type": "select",
        "returnFormat": "both",
        "options": [
          { "value": "#f00", "label": "Red" },
          { "value": "#00f", "label": "Blue" }
        ],
        "set": [
          { "attribute": "style", "value": "color: {attributes.customColor.value}" },
          { "attribute": "data-color", "value": "{attributes.customColor.label}" },
          { "attribute": "class", "value": "has-custom-color" }
        ]
      }
    ]
  }
}
```

## 1つのブロックから数千のブロックまで指定

`"core/paragraph"` のような単一の名前、名前の配列、または `"core/*"` を使った名前空間全体を指定できます。

複数のJSON拡張機能で同じブロックを対象にできます。優先度によってインスペクター内の順序が決まります。

最上位の `exclude` リストは、`name` が一致するブロックを、完全一致とワイルドカードの同じ照合方法で除外します。除外されたブロックにはフィールドも出力も適用されません。

[ブロックの指定](https://blockstudio.dev/ja/docs/extensions/)

extend-animation.json

```
{
  "name": "core/*",
  "blockstudio": {
    "extend": { "priority": 10 },
    "attributes": [
      {
        "id": "animation",
        "type": "select",
        "options": [
          { "value": "fade", "label": "Fade" },
          { "value": "slide", "label": "Slide" }
        ]
      }
    ]
  }
}
```

## ブロックを除外

ワイルドカードで一致するブロックから、単一のブロックまたはプレフィックス全体を除外します。

## 値を連結

複数値フィールドで選択したすべての値を、1つの属性に書き込みます。

## 属性フィールド

属性フィールドは、設定ルールなしで名前と値のペアをブロックに書き込みます。

## PHPから確認

bs_block_extension_fields()は、コアとサードパーティ製を含む、条件に一致するすべての拡張機能がブロックに追加するフィールドを返します。

Plus

## 公式拡張キット

プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。

- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ

[Plusを入手](https://blockstudio.dev/ja/plus/)
