WordPress: Template Tags/wp dropdown pages:修订间差异
来自站长百科
(新页面: {{Copyedit}} == Description == Displays a list of pages in a select (i.e dropdown) box with no submit button. == Usage == %%% <?php wp_dropdown_pages('arguments'); ?> %%% == Examples ==...) |
(→参数) |
||
(未显示2个用户的2个中间版本) | |||
第1行: | 第1行: | ||
{{Copyedit}} | {{Copyedit}} | ||
== | ==描述== | ||
== | 在一个拥有递交按钮的挑选框(如 下拉列表)中显示一列网页。 | ||
== 用法 == | |||
%%% <?php wp_dropdown_pages('arguments'); ?> %%% | %%% <?php wp_dropdown_pages('arguments'); ?> %%% | ||
== | == 例子 == | ||
=== | ===默认用法=== | ||
<pre> | <pre> | ||
$defaults = array('depth' => 0, 'child_of' => 0, 'selected' => 0, | $defaults = array('depth' => 0, 'child_of' => 0, 'selected' => 0, | ||
'echo' => 1,'name' => 'page_id', 'show_option_none' => '');</pre> | 'echo' => 1,'name' => 'page_id', 'show_option_none' => '');</pre> | ||
* | 默认情况下,用法显示: | ||
* | |||
* | *以层级方式(嵌入式)显示的网页和子网页。 | ||
* | |||
* | *显示所有的网页(不局限于子网页) | ||
*没有网页会被'选到'或者呈现在显示框中 | |||
*指派到下拉列表形式的名称是'page_id' | |||
*允许你不选择任何网页(show_option_none) | |||
<?php wp_dropdown_pages(); ?> | <?php wp_dropdown_pages(); ?> | ||
=== | ===拥有提交按钮的下拉列表=== | ||
将一个层级网页的下拉列表以HTML形式显示,拥有一个提交按钮。 | |||
<li id="pages"> | |||
<h2><?php _e('pages:'); ?></h2> | <h2><?php _e('pages:'); ?></h2> | ||
<form action="<?php bloginfo('url'); ?>" method="get"> | <form action="<?php bloginfo('url'); ?>" method="get"> | ||
第31行: | 第39行: | ||
</li> | </li> | ||
== | == 参数 == | ||
; | ; depth (''integer''):这个参数控制了''wp_list_pages''产生的列表中包含有多少个层级的网页。默认值为''0'' (显示所有的网页,包括子网页)。 | ||
; echo (''boolean''): | :* <tt>0</tt> - 网页和子网页以层级(嵌入式)方式显示(默认)。 | ||
:* <tt>-1</tt> - 子网页中的网页安装flat(非嵌入)的方式显示。 | |||
:* <tt>1</tt> -只显示最高级别的网页 | |||
:* <tt>2</tt> -2(或者更高的数字)的参数规定了显示网页时的可以下降的深度(层级)。 | |||
; child_of (''integer''):只显示一个单独网页的子网页;为网页使用ID作为参数值。默认为''0''(显示所有的网页)。 | |||
; selected : (''integer'') 在显示框中被'选上'或者显示的网页ID。默认为没有选择网页。 | |||
; echo (''boolean''):Toggles链接的总列表的显示或者返回列表作为HTML文本字符串,用于PHP。默认值是''1'' (显示总列表内容)。有效的参数值: | |||
:* <tt>1 (true)</tt> - default | :* <tt>1 (true)</tt> - default | ||
:* <tt>0 (false)</tt> | :* <tt>0 (false)</tt> | ||
; name : (''string'') | ; name : (''string'') 指派给下拉列表形式的名称。默认为'page_id'。 | ||
; show_option_none : (''string'') 致使下拉列表的HTML,允许你不选择任何网页。 | |||
; | ;exclude : (''string'')逗号将需要删除的类别IDs列表分开。例如,'exclude=4,12'指的是删除类别ID为4和12的类别不会显示/echoed或者返回。默认为不删除任何内容。 | ||
==其它的参数 == | |||
函数get_pages的一些参数有可能被用来[[WordPress:Template_Tags/wp_dropdown_pages|wp_dropdown_pages]],但这并不是一定的。下面是get_pages参数的默认设置 | |||
<pre> | <pre> | ||
第59行: | 第75行: | ||
'hierarchical' => 1, 'exclude' => '', 'include' => '', 'meta_key' => '', 'meta_value' => '', 'authors' => ''); | 'hierarchical' => 1, 'exclude' => '', 'include' => '', 'meta_key' => '', 'meta_value' => '', 'authors' => ''); | ||
</pre> | </pre> | ||
== 相关的 == | |||
{{标签 总 标签}} | |||
{{查询 字符串 标签 页底文字}} | |||
{{ | |||
2008年7月14日 (一) 15:33的最新版本
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' => '');