函数:wp_list_categories($args)
作用:列出某个分类下的分类项目
用法:
<ul>
<?php
$args= array(
'depth'=>1,
'orderby'=>id,
'style'=>none
);
wp_list_categories( $args ); ?>
</ul>
或
<ul>
<?php wp_list_categories('depth=10'); ?>
</ul>
输出html结构:
<ul>
<li class="categories">分类目录<ul> <li class="cat-item cat-item-2"><a href="#">使用手册</a>
<ul class="children">
<li class="cat-item cat-item-6"><a href="#">使用应用</a>
</li>
<li class="cat-item cat-item-3"><a href="#">如何安装</a>
</li>
<li class="cat-item cat-item-7"><a href="#">常见问题</a>
</li>
<li class="cat-item cat-item-4"><a href="#">界面介绍</a>
</li>
<li class="cat-item cat-item-5"><a href="#">订购应用</a>
</li>
</ul>
</li>
<li class="cat-item cat-item-8"><a href="#">开发手册</a>
</li>
<li class="cat-item cat-item-1"><a href="#">未分类</a>
</li>
</ul></li> </ul>
常见参数说明:
参数 | 用途 | 参数值 |
---|---|---|
show_option_all | 指定站点首页的超链接 | |
order | 升序或降序 |
ASC升序(默认)、 DESC降序 |
style | 分类列表显示的样式 |
list 输出li, none 使用<br >标签分隔列表项 |
show_count | 是否显示文章数量 | 1,0 |
hide_empty | 是否隐藏没有文章的分类 | 1,0 |
use_desc_for_title | 是否在链接显示 title 属性 | 1,0 |
child_of | 只显示此参数确定的分类的子分类 |
为8 显示ID为 8 的分类的子分类 为0则显示分类的所有子类 |
exclude | 排除一个或多个分类。使用逗号分隔每个分类的ID,参数 include 必须为空。 | 4,7 |
exclude_tree | 排除分类树。使用逗号分隔每个分类的ID,参数 include 必须为空。 | |
include | 只显示特定的分类,使用逗号分隔每个分类的ID | 3,5,9,16 |
hierarchical | 是否按层级显示分类 | 1,0 |
title_li | 设置列表的标题,默认为“Categories”。 | |
number | 要显示的分类数量 | 默认为不限制 |
echo | 显示结果或保存在一个变量里 | 1,0 |
depth | 显示分类的深度(即显示多少层的子分类) |
0 – 所有分类和子分类(默认) |
current_category | 默认为0,在当前分类下加样式值,便于美化 | 为0则根据页面动图添加当前样式值,填指定分类id,则仅在指定分类中添加样式值 |
pad_counts | 父分类的文章数是否包括子分类的链接或文章数。 | 1,0 |
title_li | 列表的标题 |
注意: wp_list_categories() 和 list_cats() 以及 wp_list_cats() 的使用类似,但是后面 2 个已经弃用。