get_the_tag_list()


WordPress関数get_the_tag_list()は、投稿に関連付けられたタグをリスト形式で取得または表示するために使用されます。この関数は、HTMLタグを含むフォーマットされた文字列を返します。

構文

get_the_tag_list( string $before = '', string $sep = '', string $after = '' );

引数の説明:

  • $before (string) — リストの前に追加されるHTMLやテキスト。
  • $sep (string) — 各タグの間に挿入される区切り文字。
  • $after (string) — リストの後に追加されるHTMLやテキスト。

例 1: 基本的なタグリストの取得

投稿に関連付けられたタグをカンマ区切りで表示します。

<?php echo get_the_tag_list( '', ', ', '' ); ?>

例 2: タグリストをカスタムHTMLでラップ

リストを特定のHTML要素で囲みます。

<?php echo get_the_tag_list( '<ul><li>', '</li><li>', '</li></ul>' ); ?>

例 3: タグリストに特定のスタイルを適用

リストの各タグをカスタムクラス付きのリンクとして出力します。

<?php echo get_the_tag_list( '<div class="tags">', ' | ', '</div>' ); ?>

例 4: タグがない場合のデフォルトメッセージ

投稿にタグがない場合は「タグなし」と表示します。

<?php 
$tag_list = get_the_tag_list( '', ', ', '' );
echo $tag_list ? $tag_list : 'タグなし';
?>

例 5: 条件付きでタグリストを表示

タグがある場合のみリストを表示します。

<?php 
if ( get_the_tag_list() ) {
    echo get_the_tag_list( '<span>', ', ', '</span>' );
}
?>

注意事項

  • タグが関連付けられていない投稿では空の値を返すため、条件付きでチェックすることをお勧めします。
  • テンプレートファイルで使用する場合、関数の出力を適切にサニタイズすることでセキュリティを確保してください。

関連機能：