当前浏览:首页 / WordPress函数 / get_the_tag_list()

get_the_tag_list( string $before = '', string $sep = '', string $after = '', int $post_id )

检索格式化为字符串的文章标签

listmore...

tagmore...

themore...


参数

$before

(string) (可选) 要在标签之前使用的字符串。

默认值: ''

$sep

(string) (可选) 要在标签之间使用的间隔字符串。

默认值: ''

$after

(string) (可选) 标签后要使用的字符串。

默认值: ''

$post_id

(int) (可选) 文章ID。默认为当前文章ID。


返回

(string|false|WP_Error) 成功为标签列表,如果没有标签,则为false,失败为WP_Error


说明

此函数用于生成一个HTML字符串,其中包含与当前文章关联的标签。每个标签的名称将链接到相关的“标签”页面。您可以告诉函数在所有标签之前和之后以及每个标签之间放置一个字符串。与get_the_category_list不同,此标签必须在循环内使用。



源码

查看源码 官方文档


更新日志

版本描述
2.3.0开始引入

用户贡献的笔记

  • 贡献者:Codex

    一个稍微复杂一点的例子

    这将检查文章是否有任何标签,如果有,则将其输出到无序列表。

    /** @var string|false|WP_Error $tag_list */
    $tag_list = get_the_tag_list( '<ul><li>', '</li><li>', '</li></ul>' );
    
    if ( $tag_list && ! is_wp_error( $tag_list ) ) {
    	echo $tag_list;
    }
    

    这将返回以下形式的内容:

    <ul>
    	<li><a href="tag1">Tag 1</a></li>
    	<li><a href="tag2">Tag 2</a></li>
    	...
    </ul>
    

    您可以根据需要使用CSS添加类和样式。

  • 贡献者:Codex

    一个基本示例,输出段落内的标签列表,标签之间用逗号分隔。

    echo get_the_tag_list( sprintf( '<p>%s: ', __( 'Tags', 'textdomain' ) ), ', ', '</p>' );
    

    这将返回如下结果:

    <p>Tags: <a href="tag1">Tag 1</a>, <a href="tag2">Tag 2</a>, ...</p>