wp_dropdown_categories()

WordPressのwp_dropdown_categories()関数は、カテゴリーのドロップダウンリストを生成するために使用されます。この関数は、カスタマイズ可能な引数を多数サポートしており、カテゴリー選択のUIを簡単に実装できます。

構文

wp_dropdown_categories( array|string $args = '' );

引数の説明:

• $args (array|string) — ドロップダウンの設定を指定する配列またはクエリ文字列。
• show_option_all (string) — 「すべてのカテゴリー」を表示するテキスト。
• show_option_none (string) — 「カテゴリーなし」を表示するテキスト。
• orderby (string) — カテゴリーを並べ替える基準（例: ‘name’, ‘id’）。
• order (string) — 並べ替え順序（’ASC’ または ‘DESC’）。
• selected (int) — 選択されたカテゴリーのID。
• hierarchical (bool) — 階層構造を表示するかどうか。
• name (string) — ドロップダウンのname属性。
• id (string) — ドロップダウンのid属性。
• class (string) — ドロップダウンのclass属性。
• depth (int) — 表示する階層の深さ。
• tab_index (int) — タブインデックスの値。
• taxonomy (string) — 使用するタクソノミー（デフォルトは ‘category’）。
• hide_if_empty (bool) — カテゴリーがない場合にドロップダウンを非表示にするかどうか。

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

これは、デフォルト設定でカテゴリードロップダウンを表示する例です。

<?php wp_dropdown_categories(); ?>

例2: 特定のカテゴリーを選択状態にする

特定のカテゴリーIDを選択状態にする例です。

<?php wp_dropdown_categories( array( 'selected' => get_cat_ID( 'ニュース' ) ) ); ?>

例3: 階層構造を表示する

カテゴリーの階層構造を表示する例です。

<?php wp_dropdown_categories( array( 'hierarchical' => true ) ); ?>

例4: カスタムタクソノミーを使用する

カスタムタクソノミーを使用してドロップダウンを表示する例です。

<?php wp_dropdown_categories( array( 'taxonomy' => 'genre' ) ); ?>

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

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

<?php wp_dropdown_categories( array( 'show_option_all' => 'すべてのカテゴリー' ) ); ?>

例6: カテゴリーがない場合に非表示にする

カテゴリーがない場合にドロップダウンを非表示にする例です。

<?php wp_dropdown_categories( array( 'hide_if_empty' => true ) ); ?>

例7: カスタムクラスとIDを指定する

ドロップダウンにカスタムクラスとIDを指定する例です。

<?php wp_dropdown_categories( array( 'class' => 'custom-class', 'id' => 'custom-id' ) ); ?>

注意点

• カスタムタクソノミーを使用する場合は、taxonomy引数を正しく指定してください。
• ドロップダウンのスタイルをカスタマイズする場合は、CSSを使用して調整してください。
• JavaScriptを使用してドロップダウンの動作をカスタマイズすることも可能です。