WordPress模板标签wp_tag_cloud用于输出标签云，标签的大小由该标签下的文章数量决定。
1 | wp_tag_cloud( array $args = '' ) |
函数参数
$args
数组或字符串值
wp_tag_cloud()函数$args参数默认的值如下：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | $args = array( 'smallest' => 8, 'largest' => 22, 'unit' => 'pt', 'number' => 45, 'format' => 'flat', 'separator' => "\n", 'orderby' => 'name', 'order' => 'ASC', 'exclude' => null, 'include' => null, 'topic_count_text_callback' => default_topic_count_text, 'link' => 'view', 'taxonomy' => 'post_tag', 'echo' => true, 'child_of' => null, ); |
wp_tag_cloud()函数$args参数可用的值如下：
smallest
整数型，默认值：8
最小字号大小
largest
整数型，默认值：22
最大字号大小
unit
字符串值，默认值：pt
字号单位
number
整数型，默认值：45
显示的标签数量
format
字符串值，默认值：flat
列表的格式，可选值：
- flat：空格；
- list：UL列表；
- array：数组；
separator
字符串值，默认值：\n
标签之间的文本
orderby
字符串值，默认值：name
排序规则，可选值：
- name：按名称排序；
- count：按文章数量排序；
order
字符串值，默认值：ASC
排序方式，可选值：
- ASC：升序；
- DESC：降序；
- RAND：随机；
exclude
字符串值，默认值：null
提供标签ID，以排除显示这些标签，多个标签ID用半角逗号分隔
include
字符串值，默认值：null
提供标签ID，以显示这些标签，多个标签ID用半角逗号分隔
topic_count_text_callback
字符串值，默认值：default_topic_count_text
指定一个函数名称，该函数返回的值将作为链接的title属性值，默认输出文章数量，例如：28个话题
link
字符串值，默认值：view
链接的类型，可选值：
- view：输出标签归档页面链接；
- edit：当已登录且有编辑标签的权限时，输出编辑该标签的链接，否则输出首页链接；
taxonomy
字符串或数组，默认值：post_tag
指定分类法名称，可选值：
- post_tag：文章标签；
- category：文章分类；
- link_category：友情链接分类；
echo
布尔值，默认值：true
是否输出返回结果
函数使用示例
1 2 3 4 5 6 | <?php if ( function_exists( 'wp_tag_cloud' ) ) : ?> <h2>标签云集</h2> <ul> <li><?php wp_tag_cloud( 'smallest=8&largest=22' ); ?></li> </ul> <?php endif; ?> |
扩展阅读
wp_tag_cloud()函数位于：wp-includes/category-template.php
相关函数：
- get_tag()
- get_tag_link()
- get_tags()
- get_the_tag_list()
- get_the_tags()
- is_tag()
- the_tags()
- single_tag_title()
- tag_description()
- wp_generate_tag_cloud()
原文链接：https://xiaohost.com/2392.html，转载请注明出处。
