build_dropdown_script_block_core_categories()


WordPressのbuild_dropdown_script_block_core_categories()関数は、ブロックエディタでカテゴリードロップダウンを生成するためのスクリプトを構築します。

構文

build_dropdown_script_block_core_categories( array $args = array() );

引数の説明:

  • $args(array)—ドロップダウンの設定オプションを含む配列
  • selected(int|string)—選択済みのカテゴリーID
  • name(string)—select要素のname属性
  • id(string)—select要素のid属性
  • show_option_all(string)—「すべてのカテゴリー」オプションのテキスト
  • show_option_none(string)—「なし」オプションのテキスト
  • hide_empty(bool)—空のカテゴリーを非表示にするかどうか

例1: 基本的なカテゴリードロップダウン

デフォルト設定でカテゴリードロップダウンを生成します。

build_dropdown_script_block_core_categories();

例2: カスタムname属性を指定

name属性を’my_categories’に設定します。

build_dropdown_script_block_core_categories( array( 'name' => 'my_categories' ) );

例3: 空のカテゴリーを非表示

投稿がないカテゴリーを表示しません。

build_dropdown_script_block_core_categories( array( 'hide_empty' => true ) );

例4: デフォルト選択を設定

IDが5のカテゴリーを選択済みにします。

build_dropdown_script_block_core_categories( array( 'selected' => 5 ) );

例5: 「すべてのカテゴリー」オプションを追加

ドロップダウンの先頭にカスタムテキストを追加します。

build_dropdown_script_block_core_categories( array( 'show_option_all' => 'カテゴリーを選択' ) );

例6: 「なし」オプションを追加

ドロップダウンに「なし」オプションを含めます。

build_dropdown_script_block_core_categories( array( 'show_option_none' => 'カテゴリーなし' ) );

例7: 複数の引数を組み合わせ

複数のオプションを同時に指定します。

build_dropdown_script_block_core_categories( array( 'name'=>'cat', 'selected'=>3, 'hide_empty'=>false ) );

注意点

  • この関数はブロックエディタのコンテキストでのみ動作します
  • フロントエンドで使用する場合は適切なフックが必要です
  • 引数の配列キーは正確に指定する必要があります

関連機能：