Mill's Note

【Wordpress関数】the_tags()

/

投稿に紐づいたタグを一覧(配列)で取得して「リンク と HTMLタグ( 又はセパレータ ) 付き」で出力。
投稿ページで、リンク付きタグ一覧をサクッと表示できるWordpressテンプレートタグです。(ループ内のみ利用可能)

出力は「最初, セパレータ, 最後」以外固定。
パラメータ以外の出力は固定となる為、要素を個別に設定したい場合は get_the_tags() など他のテンプレートタグをお勧めします。

the_tags()

タグが設定されていない場合は、何も出力されません

呼び出しコードパラメータ説明
<?php the_tags(); ?>セパレータ指定なしリスト最初に タグ: が付き、カンマ 区切りで出力
<?php the_tags($before, $sep, $after); ?>最初, セパレータ, 最後セパレータ区切りリストを、最初と最後で囲んで出力

the_tags() 利用例

セパレータ指定なし

リストの最初に「タグ: 」という文字列が入ります。

PHP
<?php the_tags(); ?>
/*  出力結果  */
タグ: <a href="タグページURL" rel="tag">タグ名</a>, <a href="タグページURL" rel="tag">タグ名</a>

最初の「タグ:」を無くし「, 」区切り

パラメータの最初と最後を「」にし、セパレータを指定することで最初の文字列を無くします。

PHP
<?php the_tags('', ', ', ''); ?>
/*  出力結果  */
<a href="タグページURL" rel="tag">タグ名</a>, <a href="タグページURL" rel="tag">タグ名</a>

<ul><li>で囲む

特定のタグで囲みたい場合は、「最初に開始タグ」「最後に閉じタグ」で囲み、セパレータに途中になるタグを入れます。
class なども設定可能です。

PHP
<?php the_tags('<ul><li>', '</li><li>', '</li></ul>'); ?>
/*  出力結果  */
<ul>
<li><a href="タグページURL" rel="tag">タグ名</a></li><li><a href="タグページURL" rel="tag">タグ名</a></li>
</ul>