> WordPress中文手册 > wordpress标签常用函数:get_the_tag_list()

【函数介绍】

创建与当前文章相关的标签的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.