build_template_part_block_variations()


WordPressのbuild_template_part_block_variations()関数は、テンプレートパーツブロックのバリエーションを動的に生成するために使用されます。この関数は、テーマやプラグイン開発者がカスタムブロックバリエーションを簡単に追加できるように設計されています。

構文

build_template_part_block_variations( array $args );
  • $args(array) — バリエーションを定義するためのパラメータを含む配列。

例1: 基本的なバリエーションの追加

この例では、シンプルなテンプレートパーツブロックのバリエーションを追加します。

build_template_part_block_variations( array( 'name' => 'custom-variation', 'title' => 'カスタムバリエーション', 'description' => 'これはカスタムバリエーションです。', 'icon' => 'layout', 'innerBlocks' => array( array( 'core/paragraph', array( 'content' => 'こんにちは、世界！' ) ) ) ) );

例2: アイコンの変更

この例では、バリエーションのアイコンを変更します。

build_template_part_block_variations( array( 'name' => 'icon-variation', 'title' => 'アイコンバリエーション', 'icon' => 'star-filled', 'innerBlocks' => array() ) );

例3: 複数の内部ブロックを含むバリエーション

この例では、複数の内部ブロックを含むバリエーションを作成します。

build_template_part_block_variations( array( 'name' => 'multi-block-variation', 'title' => '複数ブロックバリエーション', 'innerBlocks' => array( array( 'core/heading', array( 'content' => '見出し' ) ), array( 'core/paragraph', array( 'content' => 'これは段落です。' ) ) ) ) );

例4: カスタム属性を持つバリエーション

この例では、カスタム属性を持つバリエーションを追加します。

build_template_part_block_variations( array( 'name' => 'custom-attributes', 'title' => 'カスタム属性', 'attributes' => array( 'customAttribute' => 'value' ), 'innerBlocks' => array() ) );

例5: カテゴリーの指定

この例では、バリエーションにカテゴリーを指定します。

build_template_part_block_variations( array( 'name' => 'category-variation', 'title' => 'カテゴリーバリエーション', 'category' => 'design', 'innerBlocks' => array() ) );

例6: カスタムCSSクラスの追加

この例では、バリエーションにカスタムCSSクラスを追加します。

build_template_part_block_variations( array( 'name' => 'custom-class', 'title' => 'カスタムクラス', 'className' => 'custom-class', 'innerBlocks' => array() ) );

例7: デフォルトバリエーションの設定

この例では、デフォルトのバリエーションを設定します。

build_template_part_block_variations( array( 'name' => 'default-variation', 'title' => 'デフォルトバリエーション', 'isDefault' => true, 'innerBlocks' => array() ) );

注意点

  • この関数を使用する際は、テーマやプラグインの互換性を確認してください。
  • バリエーションの名前は一意である必要があります。
  • 内部ブロックの構造が正しいことを確認してください。

関連機能：