WordPress:Template Tags/wp dropdown categories
This article is [[WordPress::Category:Copyedits|marked]] as in need of editing. You can help Codex by editing it.
描述[ ]
在一个没有提交按钮的选择框（如下拉列表）上显示类别的一个列表。
用法[ ]
%%% <?php wp_dropdown_categories('arguments'); ?> %%%
例子[ ]
默认用法[ ]
$defaults = array('show_option_all' => '', 'show_option_none' => '', 'orderby' => 'ID',
'order' => 'ASC', 'show_last_update' => 0, 'show_count' => 0, 'hide_empty' => 1,
'child_of' => 0, 'exclude' => '', 'echo' => 1, 'selected' => 0, 'hierarchical' => 0,
'name' => 'cat', 'class' => 'postform', 'depth' => 0);
默认情况下，用法是：
- 以上升的顺序，根据类别id分类
- 不显示最后一次的更新
- 不显示一个类别内文章的数目
- 不显示 '空' 类别
- 不排除任何内容
- 显示(echos)类别
- 没有从形式上'选择'类别‘
- 不以等级结构显示类别
- 将'cat'指定为格式名
- 将格式指定到级别'平台'
- 没有深入的限制
<?php wp_dropdown_categories(); ?>
拥有提交按钮的下拉列表[ ]
以HTML的形式，拥有一个提交按钮，显示一个等级类别的下拉列表，在WordPress工具条中无序的列表上，显示每个类别的文章数目。
<li id="categories">
<h2><?php _e('Categories:'); ?></h2>
<form action="<?php bloginfo('url'); ?>" method="get">
<?php wp_dropdown_categories('show_count=1&hierarchical=1'); ?>
<input type="submit" name="submit" value="view" />
</form>
</li>
使用JavaScript没有提交按钮的下拉列表[ ]
例子描述了使用show_option_none参数而且是从Moshu的论坛文章中收集的。
<?php _e('Posts by Category'); ?>
<?php wp_dropdown_categories('show_option_none=Select category'); ?>
<script type="text/javascript"></script>
使用JavaScript没有提交按钮的下拉列表 (2)[ ]
这个例子使用了echo 参数 (echo=0)。一个简单的preg_replace插入了JavaScript代码。设置没有JavaScript也能够运行（提交按钮被noscript标签覆盖）。
<li id="categories">
<h2><?php _e('Posts by Category'); ?></h2>
<form action="<?php bloginfo('url'); ?>/" method="get">
<?php
$select = wp_dropdown_categories('show_option_none=Select category&show_count=1&orderby=name&echo=0');
$select = preg_replace("#<select([^>]*)>#", "<select$1 onchange='return this.form.submit()'>", $select);
echo $select;
?>
<noscript><input type="submit" value="View" /></noscript>
</form>
</li>
参数[ ]
- show_option_all ：(string)导致下拉列表的HTML，允许你选择所有的类别。
- show_option_none
- (string)导致下拉列表的HTML，允许你不选择类别。
- orderby ：(string)给选项分类的关键词。有效的参数值：
- 'ID' (默认)
- 'name'
- order
- (string) 选项的分类顺序。有效的参数值：
- 'ASC' (默认的)
- 'DESC'
- show_last_update
- (boolean) 设置是否在每个类别上显示最后一篇文章的日期。有效的参数值：
- 1 (True)
- 0 (False - Default)
- show_count
- (boolean) 设置是否显示每个类别中的文章的数目。有效的参数值：
- 1 (True)
- 0 (False - Default)
- hide_empty
- (boolean) 设置是否隐藏(不显示)不包含有文章的类别。有效的参数值：
- 1 (正确的 – 默认)
- 0 (错误的)
- child_of
- (integer)只显示类别ID识别的子类别。这个参数没有默认值。
- exclude
- (string) 用逗号分开要删除的类别的ID。例如，'删除=4,12'，指的是类别IDs4和12不会被显示/echoed或者返回。默认不删除任何类别。
- echo
- (boolean)显示书签(TRUE)或者返回书签供PHP使用(FALSE)。默认TRUE。
- 1 (True - default)
- 0 (False)
- selected
- (integer) 要被'挑选'或者显示在展示框中的类别的类别ID。默认不选择任何类别。
- hierarchical
- (boolean) 以等级级别的方式显示类别（子类别以嵌套的方式显示）。默认FALSE。
- 1 (True)
- 0 (False - Default)
- name
- (string) 给下拉列表指定的形式的名称。默认为'cat'。.
- class
- (string) 指定给下拉列表形式的类别。默认为'文章形式'。
- depth
- (integer) 这个参数控制了，列出的类别中可以包含多少个类别层级。默认值是0（显示所有的类别和子类别）。这个参数在2.5版本时添加的。
- 0 - 所有的类别和子类别（默认）。
- -1 -所有的类别以平常格式（而不是缩进格式）显示（删除等级级别)。
- 1 -只显示最高级别的类别
- n - n 值(某个数目)规定显示类别的时候，可以显示的子类别的层级(或者等级)
相关的[ ]
Description[ ]
描述[ ]
Displays a link to the category or categories a post belongs to. This tag must be used within WordPress:The Loop.
显示文章所属的类别的连接。必须在The Loop内，使用这个标签。
Usage[ ]
用法[ ]
%%% <?php the_category('separator', 'parents' ); ?> %%% %%% <?php the_category('separator', 'parents' ); ?> %%%
Examples[ ]
Separated by Space[ ]
例子[ ]
由空格分开[ ]
This usage lists categories with a space as the separator.
这个用法用分隔符，隔开类别，列出。
<p>Categories: <?php the_category(' '); ?></p>
<p>Categories: <?php the_category(' '); ?></p>
Separated by Comma[ ]
用逗号分开[ ]
Displays links to categories, each category separated by a comma (if more than one).
显示类别连接，（如果多于一个类别）类别之间用逗号分开。
<p>This post is in: <?php the_category(', '); ?></p>
<p>This post is in: <?php the_category(', '); ?></p>
Separated by Arrow[ ]
用箭头分开[ ]
Displays links to categories with an arrow (>) separating the categories. (Note: Take care when using this, since some viewers may interpret a category following a > as a subcategory of the one preceding it.)
用箭头显示类别链接(>)分开类别。(注: 使用这种方法的时候，应该注意，有的访客认为类别后面的> 是前面类别的子类别。)
<p>Categories: <?php the_category(' > '); ?></p>
<p>Categories: <?php the_category(' > '); ?></p>
Separated by a Bullet[ ]
用Bullet分开[ ]
Displays links to categories with a bullet (•) separating the categories.
使用bullet (•)分开类别，显示类别链接
%%%Post Categories: <?php the_category(' • '); ?>
%%% %%%文章类别: <?php the_category(' • '); ?>
%%%Parameters[ ]
参数[ ]
- separator
- (string) Text or character to display between each category link. The default is to place the links in an unordered list.
；分隔符: (string)链接类别之间显示的文本或者字符。默认是将链接放在无序列表上。
- parents
- (string) How to display links that reside in child (sub) categories. Options are:
- parents
- (string)怎样显示子类别中的链接。选项有：
- 'multiple' - Display separate links to parent and child categories, exhibiting "parent/child" relationship.
- 'multiple' -分开显示母类别和子类别的链接，显示为"母/子"关系。
- 'single' - Display link to child category only, with link text exhibiting "parent/child" relationship.
- 'single' -只显示子类别链接，链接文本显示为"母/子"关系。
- Note: Default is a link to the child category, with no relationship exhibited.
：注：默认是链接到子类别的一个链接，不显示关系。
Related[ ]
the_category, the_category_rss, single_cat_title, category_description, wp_dropdown_categories, wp_list_categories, in_category, get_category_parents, get_the_category get_category_link,