説明
パラメータ
- $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
- ドロップダウン形式の固定ページリストを表示する。
関連
お勧め
カレンダーウィジェットをAjaxで切り替える(2011年8月22日 更新)
ウィジェットベースでテーマを構築していてカレンダーを表示してみた。標準では、前月や次月のリンク先はそれぞれの月のアーカイブページとなっているのだが、記事を探すだけであればカレンダー部分だけを更新するほうが便利なのではと考え、そのアイデアを実装してみた。3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する(2014年1月17日 更新)
ちょうど1月前の「ダッシュボードの「概要」にカスタム投稿タイプ件数を表示する」にて、WordPress 3.8新ダッシュボードの「概要」ウィジェットにカスタム投稿タイプの投稿数を表示する方法を紹介したが、今回のその続編で「アクティビティ」ウィジェットを拡張する方法を紹介する。
5.5の機能強化:コメントフォームのちょっとした改良(2020年8月12日 更新)
来月にリリースされるWordPress 5.5に向けてBeta 1、2、3と公開が続いている。「WordPress 5.5 Beta 3(以降Beta 3)」のソースコードを見ていくと、コメントフォームを表示する comment_form関数が機能拡張されていた。
5.3への準備:投稿写真を使っているサイトは準備しておこう(2019年10月10日 更新)
この記事は先日公開した「5.3の新機能:JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。
画像ブロックに効果を追加した時にハマった(2023年3月30日 更新)
画像ブロックに対して見た目が変わる効果を追加しようと思い機能拡張してみた。その際、いくつかの効果は問題なかったのだが、1つの効果だけその画像を選択したときのみ効果が消える不具合が発生。対処内容はシンプルなものだが、忘れないようにメモっとく。