WordPress:Template Tags/wp dropdown pages

This article is [[WordPress::Category:Copyedits|marked]] as in need of editing. You can help Codex by editing it.

描述

在一个拥有递交按钮的挑选框（如 下拉列表）中显示一列网页。

用法

%%% <?php wp_dropdown_pages('arguments'); ?> %%%

例子

默认用法

$defaults = array('depth' => 0, 'child_of' => 0, 'selected' => 0, 
'echo' => 1,'name' => 'page_id', 'show_option_none' => '');

默认情况下，用法显示：

• 以层级方式（嵌入式）显示的网页和子网页。

• 显示所有的网页（不局限于子网页）

• 没有网页会被'选到'或者呈现在显示框中

• 指派到下拉列表形式的名称是'page_id'

• 允许你不选择任何网页(show_option_none)

<?php wp_dropdown_pages(); ?>

拥有提交按钮的下拉列表

将一个层级网页的下拉列表以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>

参数

depth (integer)

这个参数控制了wp_list_pages产生的列表中包含有多少个层级的网页。默认值为0 (显示所有的网页，包括子网页)。

• 0 - 网页和子网页以层级（嵌入式）方式显示（默认）。

• -1 - 子网页中的网页安装flat（非嵌入）的方式显示。

• 1 -只显示最高级别的网页

• 2 -2（或者更高的数字）的参数规定了显示网页时的可以下降的深度（层级）。

child_of (integer)

只显示一个单独网页的子网页；为网页使用ID作为参数值。默认为0（显示所有的网页）。

selected

(integer) 在显示框中被'选上'或者显示的网页ID。默认为没有选择网页。

echo (boolean)

Toggles链接的总列表的显示或者返回列表作为HTML文本字符串，用于PHP。默认值是1 (显示总列表内容)。有效的参数值：

• 1 (true) - default
• 0 (false)

name

(string) 指派给下拉列表形式的名称。默认为'page_id'。

show_option_none

(string) 致使下拉列表的HTML，允许你不选择任何网页。

exclude

(string)逗号将需要删除的类别IDs列表分开。例如，'exclude=4,12'指的是删除类别ID为4和12的类别不会显示/echoed或者返回。默认为不删除任何内容。

其它的参数

函数get_pages的一些参数有可能被用来wp_dropdown_pages，但这并不是一定的。下面是get_pages参数的默认设置

$defaults = array('child_of' => 0, 'sort_order' => 'ASC', 'sort_column' => 'post_title',
'hierarchical' => 1, 'exclude' => '', 'include' => '', 'meta_key' => '', 'meta_value' => '', 'authors' => '');