参数
- $tags
-
(WP_Term[])(必填) 生成标签云的WP_Term对象数组。
- $args
-
(string|array)(可选) 用于生成标签云的参数数组或字符串。
- 'smallest'
(int) 用于显示标签的最小字体大小。与$unit
的值配对,以确定CSS文本大小单位。默认值8(pt)。 - 'largest'
(int) 用于显示标签的最大字体大小。与$unit
的值配对,以确定CSS文本大小单位。默认值22(pt)。 - 'unit'
(string) 用于$smallest
和$largest
值的CSS文本大小单位。接受任何有效的CSS文本大小单位。默认值'pt'。 - 'number'
(int) 要返回的标签数。接受任何正整数或零以返回全部。默认值为0。 - 'format'
(string) 显示标签云的格式。接受'flat'(用空格分隔的标签)、'list'(无序列表中显示的标签)或'array'(返回数组)。默认值'flat'。 - 'separator'
(string) HTML或文本来分隔标签。默认值“n”(换行符)。 - 'orderby'
(string) 按值排序标签。接受'name'或'count'。默认值'name'。tag_cloud_sort过滤器也会影响标签的排序方式。 - 'order'
(string) 如何排序标签。接受'ASC'(升序)、'DESC'(降序)或'RAND'(随机)。默认值'ASC'。 - 'filter'
(int|bool) 是否通过wp_generate_tag_cloud启用最终输出的过滤。默认值1。 - 'topic_count_text'
(string) 从_n_noop()中去掉复数文本以提供标签计数。默认为null。 - 'topic_count_text_callback'
(callable) 回调用于根据计数为标签计数生成无标签复数文本。默认为null。 - 'topic_count_scale_callback'
(callable) 用于确定标签计数缩放值的回调。默认值default_topic_count_scale()。 - 'show_count'
(bool|int) 是否显示标签计数。默认值为0。接受0、1或其布尔等价项。
默认值: ''
- 'smallest'
返回
(string|string[]) 根据'format'参数,将标签云作为字符串或数组返回。
源码
更新日志
版本 | 描述 |
---|---|
4.8.0 | 添加了show_count 参数。 |
2.3.0 | 开始引入 |