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.

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

描述

Displays a list of categories in a select (i.e dropdown) box with no submit button.

在一个没有提交按钮的选择框（如下拉列表）上显示类别的一个列表。

用法

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

%%% <?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);

$defaults = array('show_option_all' => '', 'show_option_none' => '', 'orderby' => 'ID', 
'顺序' => 'ASC', '显示_最后的_更新' => 0, '显示_数目' => 0, '隐藏_空的' => 1, 
'child_of' => 0, 'exclude' => '', 'echo' => 1, 'selected' => 0, 'hierarchical' => 0, 
'名称' => 'cat', 'class' => 'postform', 'depth' => 0);

By default, the usage shows:

默认情况下，用法是：

• Sorts by category id in ascending order

• 以上升的顺序，根据类别id分类

• Does not show the last date updated

• 不显示最后一次的更新
• Does not show the count of posts within a category

• 不显示一个类别内文章的数目
• Does not show 'empty' categories

• 不显示 '空' 类别

• Excludes nothing
• 不排除任何内容

• Displays (echos) the categories
• 显示(echos)类别

• No category is 'selected' in the form‘
• 没有从形式上'选择'类别‘

• Does not display the categories in a hierarchical structure
• 不以等级结构显示类别

• Assigns 'cat' to the form name
• 将'cat'指定为格式名

• Assigns the form to the class 'postform'

• 将格式指定到级别'平台'

• No depth limit
• 没有深入的限制

<?php wp_dropdown_categories(); ?>

<?php wp_dropdown_categories(); ?>

拥有提交按钮的下拉列表

Displays a hierarchical category dropdown list in HTML form with a submit button, in a WordPress sidebar unordered list, with a count of posts in each category.

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

<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没有提交按钮的下拉列表

Example depicts using the show_option_none parameter and was gleaned from Moshu's forum post.

例子描述了使用show_option_none参数而且是从Moshu的论坛文章中收集的。

<pre>

<li id="categories"><h2><?php _e('Posts by Category'); ?></h2>
	<?php wp_dropdown_categories('show_option_none=Select category'); ?>

<script type="text/javascript"><!--
    var dropdown = document.getElementById("cat");
    function onCatChange() {
		if ( dropdown.options[dropdown.selectedIndex].value > 0 ) {
			location.href = "<?php echo get_option('home');
?>/?cat="+dropdown.options[dropdown.selectedIndex].value;
		}
    }
    dropdown.onchange = onCatChange;
--></script>
</li>
<li>

<?php _e('Posts by Category'); ?>

<?php wp_dropdown_categories('show_option_none=Select category'); ?>

<script type="text/javascript"></script>

Dropdown without a Submit Button using JavaScript (2)

使用JavaScript没有提交按钮的下拉列表 (2)

In this example the echo parameter (echo=0) is used. A simple preg_replace inserts the JavaScript code. It even works without JavaScript (submit button is wrapped by noscript tags).

这个例子使用了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>

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

Parameters

参数

show_option_all

(string) Causes the HTML for the dropdown to allow you to select All of the categories.

；显示_所有_选项：(string)导致下拉列表的HTML，允许你选择所有的类别。

show_option_none

(string) Causes the HTML for the dropdown to allow you to select NONE of the categories.

不_显示_选项

(string)导致下拉列表的HTML，允许你不选择类别。

orderby

(string) Key to sort options by. Valid values:

；顺序：(string)给选项分类的关键词。有效的参数值：

• 'ID' (Default)
• 'name'
• 'ID' (默认)
• '名称'

order

(string) Sort order for options. Valid values:

；顺序: (string)选项的分类顺序。有效的参数值：

• 'ASC' (Default)
• 'DESC'

• 'ASC' (默认的)
• 'DESC'

show_last_update

(boolean) Sets whether to display the date of the last post in each category. Valid values:

；显示_最后的_更新：(boolean)设置是否在每个类别上显示最后一篇文章的日期。有效的参数值：

• 1 (True)
• 0 (False - Default)
• 1 (正确的)
• 0 (错误的 – 默认)

show_count

(boolean) Sets whether to display a count of posts in each category. Valid values:

；显示_数目：(boolean)设置是否显示每个类别中的文章的数目。有效的参数值：

• 1 (True)
• 0 (False - Default)

• 1 (正确的)
• 0 (错误的 – 默认)

hide_empty

(boolean) Sets whether to hide (not display) categories with no posts. Valid values:

；隐藏_空的: (boolean)设置是否隐藏(不显示)不包含有文章的类别。有效的参数值：

• 1 (True - Default)
• 0 (False)
• 1 (正确的 – 默认)
• 0 (错误的)

child_of

(integer) Only display categories that are children of the category identified by its ID. There is no default for this parameter.

；子：(整数)只显示类别ID识别的子类别。这个参数没有默认值。

exclude

(string) Comma separated list of category IDs to exclude. For example, 'exclude=4,12' means category IDs 4 and 12 will NOT be displayed/echoed or returned. Defaults to exclude nothing.

；移除：(string)用逗号分开要删除的类别的ID。例如，'删除=4,12'，指的是类别IDs4和12不会被显示/echoed或者返回。默认不删除任何类别。

echo

(boolean) Display bookmarks (TRUE) or return them for use by PHP (FALSE). Defaults to TRUE.

• 1 (True - default)

echo

(boolean)显示书签(正确的)或者返回书签供PHP使用(错误的)。默认真确的。

• 1 (正确的 – 默认)

• 0 (False)

• 0 (错误的)

selected

(integer) Category ID of the category to be 'selected' or presented in the display box. Defaults to no category selected.

；选择的：(整数)要被'挑选'或者显示在展示框中的类别的类别ID。默认不选择任何类别。

hierarchical

(boolean) Display categories in hierarchical fashion (child categories show indented). Defaults to FALSE.

等级的

(boolean)以等级级别的方式显示类别（子类别以嵌套的方式显示）。默认错误的。

• 1 (True)
• 1 (正确的)
• 0 (False - Default)
• 0 (错误的 – 默认)

name

(string) Name assigned to the dropdown form. Defaults to 'cat'.

姓名

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

class

(string) Class assinged to the dropdown form. Defaults to 'postform'.

；类别：(string)指定给下拉列表形式的类别。默认为'文章形式'。

depth

(integer) This parameter controls how many levels in the hierarchy of Categories are to be included in the list of Categories. The default value is 0 (display all Categories and their children). This parameter added at WordPress:Version 2.5

深度

(整数)这个参数控制了，列出的类别中可以包含多少个类别层级。默认值是0（显示所有的类别和子类别）。这个参数在2.5版本时添加的。

• 0 - All Categories and child Categories (Default).

• 0 -所有的类别和子类别（默认）。

• -1 - All Categories displayed in flat (no indent) form (overrides hierarchical).

• -1 -所有的类别以平常格式（而不是缩进格式）显示（删除等级级别)。

• 1 - Show only top level Categories
• n - Value of n (some number) specifies the depth (or level) to descend in displaying Categories

• 1 -只显示最高级别的类别
• n - n 值(某个数目)规定显示类别的时候，可以显示的子类别的层级(或者等级)

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,

相关的

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>

Categories: [[WordPress:#Examples|WordPress]] [[WordPress:#Examples|Computers]] [[WordPress:#Examples|Blogging]]

类别: [[WordPress:#Examples|WordPress]] [[WordPress:#Examples|电脑]] [[WordPress:#Examples|写博客]]

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>

This post is in: [[WordPress:#Examples|WordPress]], [[WordPress:#Examples|Computers]], [[WordPress:#Examples|Blogging]]

This post is in: [[WordPress:#Examples|WordPress]], [[WordPress:#Examples|电脑]], [[WordPress:#Examples|写博客]]

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(' &gt; '); ?></p>

<p>Categories: <?php the_category(' &gt; '); ?></p>

Categories: [[WordPress:#Examples|WordPress]] > [[WordPress:#Examples|Computers]] > [[WordPress:#Examples|Blogging]]

类别: [[WordPress:#Examples|WordPress]] > [[WordPress:#Examples|电脑]] > [[WordPress:#Examples|写博客]]

Separated by a Bullet

用Bullet分开

Displays links to categories with a bullet (•) separating the categories.

使用bullet (•)分开类别，显示类别链接

%%%

Post Categories: <?php the_category(' &bull; '); ?>

%%% %%%

文章类别: <?php the_category(' &bull; '); ?>

%%%

Post Categories: [[WordPress:#Examples|WordPress]] • [[WordPress:#Examples|Computers]] • [[WordPress:#Examples|Blogging]]

文章类别: [[WordPress:#Examples|WordPress]] • [[WordPress:#Examples|电脑]] • [[WordPress:#Examples|写博客]]

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,

相关的

How to pass parameters to tags with PHP function-style parameters

Go to Template Tag index