the_tags() の使い方｜説明・引数・注意点

説明

基本構文

the_tags( string $before = null, string $sep = ', ', string $after = '' ): void

引数

• $before：最初に付ける文字列
• $sep：区切り文字
• $after：最後に付ける文字列

戻り値

戻り値はありません（出力します）。

使い方（サンプル）

the_tags( 'タグ：', '、', '' );

注意点

• タグがない投稿では何も出力されません。

実務での使いどころ

• 投稿のタグを、リンク付きで出力するとき。

よくあるミスと対処

• タグが1つもない投稿では、何も出力されない。前後に付けたHTMLだけが残らないよう、引数の $before・$after に含める。
• $before の既定は、「タグ: 」のような文字列。不要なら、空文字を指定する。
• タグ名だけが欲しいのに、これを使っている。値の取得は get_the_tags()。

NG例

echo '<div class="tags">';
the_tags();
echo '</div>'; // タグが無い投稿でも、空の枠が出る

OK例

if ( has_tag() ) {
	the_tags( '<div class="tags">', ', ', '</div>' );
}

使い分け早見表

関連項目

get_the_tags()、has_tag()

公式リファレンス：the_tags() | Function | WordPress Developer Resources