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' => '');