wp_dropdown_pages()

WordPress関数wp_dropdown_pages()は、投稿やページのドロップダウンリストを生成するために使用されます。

構文

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

引数の説明:

• $args (array|string) — 関数の動作を制御する引数の配列または文字列。
• post_type (string) — 表示する投稿タイプ。デフォルトはpage。
• depth (int) — 階層の深さを指定。デフォルトは0 (無制限)。
• child_of (int) — 特定の親ページの子ページのみを表示。
• selected (int) — 選択されたページのID。
• name (string) — ドロップダウンのname属性。
• id (string) — ドロップダウンのid属性。
• show_option_none (string) — デフォルトの「選択してください」のラベル。空白の場合は表示されません。

例1: 基本的な使用法

すべてのページをリストするドロップダウンを生成します。

<?php wp_dropdown_pages(); ?>

例2: 特定の投稿タイプのドロップダウン

カスタム投稿タイプ「product」のドロップダウンを生成します。

<?php wp_dropdown_pages( array( 'post_type' => 'product' ) ); ?>

例3: 親ページの子ページのみを表示

特定の親ページIDの子ページをリストします。

<?php wp_dropdown_pages( array( 'child_of' => get_option( 'page_on_front' ) ) ); ?>

例4: 選択済みページを指定

選択されたページIDを42としてドロップダウンを表示します。

<?php wp_dropdown_pages( array( 'selected' => 42 ) ); ?>

例5: 独自のラベルを追加

「ページを選択してください」というラベルを表示します。

<?php wp_dropdown_pages( array( 'show_option_none' => 'ページを選択してください' ) ); ?>

注意点

• 生成されたHTMLコードにカスタムスタイルを適用する場合、class属性を追加することで可能です。
• ドロップダウンが正しく機能するために、適切なJavaScriptを実装することを検討してください。