说明

该标签在一个没有提交按钮的选择框（如下拉式选框）中展示分类目录列表。

用法

<?php wp_dropdown_categories( $args ); ?> 

默认用法

<?php $args = 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
• 不显示最新更新
• 不显示分类目录下的文章总数
• 不显示“空”分类
• 不排除任何分类
• 显示（回应）分类目录
• 选项框中不选中任何分类
• 不以分层结构显示分类目录
• 为列表命名为“cat”
• 将列表赋值给’postform’类
• 无层数限制

参数

show_option_all

（字符串）生成下拉式选项框的HTML，从而允许你选定所有分类目录。

show_option_none

（字符串）生成下拉式选项框的HTML，从而允许你不选定任何分类目录。

orderby

（字符串）按某种标准为分类目录排序。有效值包括：

• ‘ID’ ——默认值
• ‘name’

order

（字符串）为分类目录排序（升序或降序）有效值包括：

• ‘ASC’（升序） ——默认值
• ‘DESC’（降序）

show_last_updated

（布尔型）是（TRUE）否（FALSE）显示分类目录下最新更新日志的日期。默认值为FALSE。

有效值包括：

• 1 （true）
• 0（false）——默认值

show_count

（布尔型）是否显示每个分类目录下现有的日志总数。有效值包括：

• 1 （true）
• 0（false）——默认值

hide_empty

（布尔型）是否隐藏（不显示）不含有文章的分类目录。有效值包括：

• 1 （true）——默认值
• 0（false）

child_of（整数）

只显示某一个分类的子分类；用该分类的ID作为参数值。无默认值。

exclude

（字符串）将要排除的分类目录的ID列表，各ID用逗号隔开。例如， ‘exclude=4,12’ 表示不显示或返回ID为4和12的分类。默认值为不排除任何分类。

exclude_tree

（字符串）定义需要排除的父分类ID列表，各ID用逗号隔开。用该参数排除某个父分类目录及其所有子分类目录。因此 ‘exclude_tree=5’ 可排除ID为5的父分类及其所有子分类。该参数引入于WP 2.7.1。

echo

（布尔型）显示结果（TRUE），或返回结果以供PHP使用（FALSE）。默认值为TRUE。

• 1 （true）——默认值
• 0（false）

selected

（整数）在显示框中选中/显示的分类目录的ID。默认为不选中任何分类目录。

hierarchical

（布尔型）以分层形式显示分类目录（子分类目录内嵌于其父分类目录下）。默认值为FALSE。有效值包括：

• 1 （True）—— 默认值
• 0 （False）

name

（字符串）下拉式选框被赋予的名称。默认为cat’。

class

（字符串）被赋给下拉式选项框的类，默认为’postform’。

depth（整数）

该参数决定wp_list_pages所生成的分类目录列表中所允许的分类层级的层数。默认值为0（显示包括子分类目录在内的所有分类目录）。该参数引入于WP 2.5。

• 0 —— 显示所有分类目录和他们的子分类目录（默认）
• -1 —— 以平面（不缩进）方式显示所有分类目录和他们的子分类目录
• 1 —— 只显示顶级分类目录
• n —— 该值表示可以缩进显示的分类目录层数。

示例

带有提交按钮的下拉式选项框

在WordPress侧边栏的无序列表中，以HTML格式显示带有层级的分类目录下拉式列表，有提交按钮，给出各分类目录下的文章总数。

<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显示一个没有提交按钮的下拉式选项框

下面这个示例摘自WordPress论坛上的一个帖子，该示例借用了show_option_none参数。

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

用JavaScript显示一个没有提交按钮的下拉式选项框（2）

下面这段代码使用了echo参数（echo=0）。在JavaScript代码中插入一个简单的 preg_replace。即使没有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>

历史记录

• 始见于WordPress 2.1.0版本

源文件

wp_dropdown_categories()位于 wp-includes/category-template.php

分类：中文手册