说明

该标签在一个没有提交按钮的选择框（如下拉式选框）中展示页面列表。

用法

<?php wp_dropdown_pages( $args ); ?> 

默认用法

 <?php $args = array(
    ‘depth’            => 0,
    ‘child_of’         => 0,
    ‘selected’         => 0,
    ‘echo’             => 1,
    ‘name’             => ‘page_id’,
    ‘show_option_none’ => 
    ‘exclude’          => 
    ‘exclude_tree’     => ); ?>

默认情况下的显示状态：

• 以层次（缩进）方式显示页面和子页面
• 显示所有页面（不限制子页面的显示）
• 显示窗口中不选中/显示任何页面
• 下拉式选框的名称为’page_id’
• 允许用户不选择任何页面（show_option_none）

参数

depth（整数）

该参数决定wp_list_pages所生成的页面列表中所允许的页面层级的层数。默认值为0（显示包括子页面在内的所有页面）。

• 0 —— 以层次（缩进）方式显示所有页面和他们的子页面（默认）
• -1 —— 以平面（不缩进）方式显示所有页面和子页面
• 1 —— 只显示顶级页面
• 2 —— 值为2（或者更大值）时，表示可以缩进显示的层数。

child_of（整数）

只显示某一个页面的子页面；用该页面的ID作为参数值。默认值为0（显示所有页面）。

selected

（整数）在显示窗口中选中/显示的页面的ID。默认为不选中任何页面。

echo（布尔型）

显示生成的链接列表或以HTML文本字符串形式返回列表以便用在PHP中。默认值为1（显示生成的列表项）。有效值包括：

• 1 （true）——默认值
• 0（false）

name

（字符串）下拉式选框被赋予的名称。默认为’page_id’。

show_option_none

（字符串）引起下拉式选项框的HTML，从而允许你不选定任何页面。

exclude

（字符串）将要排除的类别ID列表，各ID用逗号隔开。例如， ‘exclude=4,12’ 表示不显示或返回ID为4和12的分类。默认值为不排除任何类别。

exclude_tree（字符串）

定义需要排除的父页面ID列表，各ID用逗号隔开。用该参数排除某个父页面及其所有子页面。因此 ‘exclude_tree=5’ 可排除ID为5的父页面及其所有子页面。参数新增于WP 2.7。

其它参数

get_pages的一些参数可能可以用于wp_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’ =>  ); ?>

示例

带有提交按钮的下拉式选项框

以HTML格式显示带有层级的页面下拉式列表，有提交按钮。

<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>

历史记录

• 始见于WordPress 2.1.0版本

源文件

wp_dropdown_pages()位于 wp-includes/post-template.php

分类：中文手册