• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

テンプレートタグ/get the tag list

提供: WordPress Codex 日本語版
移動先: 案内検索

現在の投稿に関連付けられたタグの HTML 文字列を生成します。 各タグ名は、それぞれのタグアーカイブページへリンクされます。 また、タグ全部の前後と各タグを区切る文字列を指定して含めさせることができます。 get_the_category_list() と異なり、このタグはループの中で使用しなければなりません。

使い方

<?php $tag_list = get_the_tag_list( $before, $sep, $after ); ?>

この関数は何も表示しません。 ページにそのまま表示するには、echo get_the_tag_list(); を使う必要があります。 または $foo = get_the_tag_list(); のように、変数に格納することもできます。

パラメータはすべてオプションです。各パラメータ(フィールド)には HTML 文を入れることができます。

パラメータ

$before
文字列) (オプション) 前に入れるテキスト。
初期値: ' '
$sep
文字列) (オプション) タグを区切る文字列。
初期値: ' '
$after
文字列) (オプション) 後に入れるテキスト。
初期値: ' '

用例

基本的な例

パラグラフ(HTML の <p>)内にコンマで区切られたタグのリストを出力します。

<?php
echo get_the_tag_list( '<p>タグ一覧:', ', ', '</p>' );
?>

この例は次のように表示します:

<p>タグ一覧:
<a href="tag1">Tag 1</a>,
<a href="tag2">Tag 2</a>,
...
</p>

ちょっと複雑な例

投稿がタグを持っている場合のみ、標準の順序なし箇条書きリストとして出力します。

<?php
if ( get_the_tag_list() ) {
    echo 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 を使ってデザインすることができます。

変更履歴

ソースファイル

get_the_tag_list()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(), wp_tag_cloud() , get_the_term_list()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function_Reference/get_the_tag_list最新版との差分