説明
string wp_dropdown_pages( [ mixed $args = '' ] )
ドロップダウン形式の固定ページリストを表示または取得する。
パラメータ
- $args検索条件を指定する文字列または連想配列。主なキーワードは次の通り。
キーワード 意味 depth 階層付きの場合は1、階層なし（フラット）の場合は0を指定（省略時は0） child_of 親固定ページの投稿IDを指定（その投稿IDの固定ページの子孫がすべて対象となる。省略時は0） selected 初期表示時に選択状態にする固定ページの投稿IDを指定（省略時は0） echo 表示する場合は1、取得する場合は0を指定（省略時は1） name select要素のname属性値を指定（省略時は'page_id'） id select要素のid属性値を指定（省略時は''） class select要素のclass属性値を指定（省略時は''） show_option_none 固定ページがない場合のテキストを指定（省略時は''） show_option_no_change 'no change'（変更なし）のテキストを指定（省略時は''） option_none_value （最初に表示される）未選択時のoption要素のvalue属性値を指定（省略時は-1） value_field option要素のvalue属性値を指定（省略時は'ID'） 返り値
常に固定ページリストのHTMLテキストを返す。注意
option要素は、'show_option_no_change'、'show_option_none'固定ページリストの順で追加される。
[4.2.0]'value_field'が追加され、option要素のvalue属性値に投稿ID以外（例：カテゴリー名）を表示できるようになった。
[4.3.0]'class'が追加され、select要素の任意のclass属性値を指定できるようになった。
使用例
- ドロップダウン形式の固定ページリストを表示する。<?php wp_dropdown_pages(); ?>
- ドロップダウン形式の固定ページリストを取得する。<?php $dropdown = wp_dropdown_pages( array( 'echo'=>0 ) ); ?>
フィルター
HTMLテキストを表示または返す直前に'wp_dropdown_pages'フィルターを実行する。$outputにはHTMLテキストが入る。$html = apply_filters( 'wp_dropdown_pages', $output );アクション
実行するアクションはありません。ソースファイル
/wp-includes/post-template.php
最終更新 : 2018年05月27日 10:46
- ドロップダウン形式の固定ページリストを表示する。
関連
お勧め
query_posts（WP_Queryクラス）でカテゴリーを絞り込む（2011年9月14日 更新）
久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。the_date関数で投稿日を確実に表示する（2011年12月20日 更新）
投稿記事の投稿日時を表示する際、 the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。スクリプトファイルのバージョンパラメータを変更する（2018年5月27日 更新）
Java Scriptやスタイルシートの指定を直接head要素内に記述せず、wp_enqueue_scriptsフィルターなどを使って指定する場合、WordPressのバージョン番号が付与されている。このバージョン番号は、妥当なんだろうか。
ログアウト後はいつもサイトトップ（2018年5月27日 更新）
ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。
カレンダーウィジェットをAjaxで切り替える（2011年8月22日 更新）
ウィジェットベースでテーマを構築していてカレンダーを表示してみた。標準では、前月や次月のリンク先はそれぞれの月のアーカイブページとなっているのだが、記事を探すだけであればカレンダー部分だけを更新するほうが便利なのではと考え、そのアイデアを実装してみた。