函数描述
显示一个页面下拉表单。
使用方法
<?php wp_dropdown_pages( $args ); ?>默认使用
<?php $args = array(
'depth' => 0,
'child_of' => 0,
'selected' => 0,
'echo' => 1,
'name' => 'page_id',
'id' => null, // string
'show_option_none' => null, // string
'show_option_no_change' => null, // string
'option_none_value' => null, // string
); ?>默认情况下，上面的代码显示：
- 在下拉表单中分级显示页面和子页面
- 显示所有页面（不限制子页面）
- 下拉表单中没有选中任何页面
- 下拉表单的名称为’page_id’
- 如果设置了 (show_option_none=>” ，没有在上面的示例中显示)，可以不选择任何页面
- 不排除任何页面 (exclude=>”，没有在上面的示例中显示)
- 不排除任何页面树 ‘tree’ (exclude_tree=>”没有在上面的示例中显示)
参数
- depth
- (
integer) 次参数控制在列表中包含几级页面， 默认为0（显示所有页面，包含子页面）。- 0 – 默认值，以层级关系显示所有父页面和子页面。
- -1 – 子页面和父页面同事显示，不展现层级关系。Pages in sub-pages displayed in flat (no indent) form.
- 1 – 只显示顶级页面
- 2 – 显示顶级页面和二级页面。
- child_of
- (
integer) 只显示某个页面下面的子页面，值为页面ID，默认为0，显示所有页面。
- selected
- (
integer) 下拉表单中选中的页面ID，默认没有页面被选中。
- echo
- (
boolean) 控制直接显示HTML表单还是在PHP中返回HTML字符串，默认为1，直接显示HTML下拉表单，可用的值有：- 1 (true) – 默认
- 0 (false)
- name
- (
string) 分配给下拉表单的name，默认为 ‘page_id’.
- id
- (
string) 分配给下拉表单的id，默认为name的值。
- show_option_none
- (
string) 在下拉选择表单的顶部创建一个附加的<option>选项，以便不选择任何页面时使用。
- option_none_value
- (
string) 参数show_opthon_none的值。
- show_option_no_change
- (
string) 因为下拉表单的HTML允许选择一个值为-1的 NO CHANGE 选项。
- exclude
- (
string)逗号分隔的需要排除的id列表，如’include=4,12′ 是指id为 4 a和 12 的页面将不被返回或显示，默认不排除任何页面。
- exclude_tree
- (
string) 定义被排除的页面和子页面的父级页面ID，使用此选项排除一个父页面和父页面的子页面。也就是说 'exclude_tree=5'，可以排除页面ID为5的页面，和页面5的子页面，最早在WordPress2.7中可用。
其他参数
下面一些参数可能可以使用，不过尚未经过官方确认，一些get_pages函数的参数可以用在iwp_dropdown_pages 函数上，下面是 get_pages 参数的默认设置。
<?php $args = array(
'child_of' => 0,
'sort_order' => 'ASC',
'sort_column' => 'post_title',
'hierarchical' => 1,
'exclude' => , 'include' => ,
'meta_key' => , 'meta_value' => ,
'authors' => , 'exclude_tree' => ,
'post_type' => 'page'
);
?>
使用 ‘post_type’ 参数，我们可以获取任何文章类型的下拉表单，包括自定义文章类型，只要文章类型是分级的就可以。
使用示例
带提交按钮的下拉表单
显示一个有提交按钮的页面选择下拉表单，下拉表单中表现页面的层次关系。
<li id="pages">
<h2><?php _e('pages:'); ?></h2>
<form action="<?php bloginfo('url'); ?>" method="get">
<?php wp_dropdown_pages(); ?>
<input type="submit" name="submit" value="view" />
</form>
</li>