创建与当前文章相关的标签的HTML字符串。每个标签的名称会链接到相关的’标签’网页。你可以命令函数在所有的标签前后放置一个字符串,而且在每个标签之间也放置一个字符串。必须在’The Loop’内使用这个标签。
<?php $tag_list = get_the_tag_list( $before, $sep, $after ); ?>
这个函数不显示任何内容 – 如果你想要直接地将这个函数放到网页上,你应该使用echo (get_the_tag_list())。另外,你可以通过使用$foo = get_the_tag_list(),将这个函数递交给一个变数,以便以后使用。
变数都是可选择的,而且应该以’before’, ‘separator’, ‘after’的顺序排列。你可以在每个区内使用HTML。
一个基本的例子
这在一个段落中产生了一列标签,标签是用逗号分开的。
<?php echo get_the_tag_list('<p>Tags: ',', ','</p>'); ?>
这会返回:
<p> 标签: <a href="tag1">Tag 1</a>, <a href="tag2">Tag 2</a>, ... </p>
一个稍微复杂的例子
这个例子检查文章是否含有任何标签,如果文章含有标签,将标签放到一个标准的无序列表上。
<?php if(get_the_tag_list()) { get_the_tag_list('<ul><li>','</li><li>','</li></ul>'); } ?>
这会返回以这个形式出现的内容;
<ul> <li><a href="tag1">Tag 1</a></li> <li><a href="tag2">Tag 2</a></li> ... </ul>
如果需要的话,你可以添加CSS的class和样式。/
$before
(string) (optional) Leading text.
Default: ‘Tags: ‘
$sep
(string) (optional) String to separate tags.
Default: ‘, ‘
$after
(string) (optional) Trailing text.
Default: None
get_the_tag_list() 位于 wp-includes/category-template.php.