single_tag_title()


WordPressの関数single_tag_title()は、現在表示されているタグアーカイブページのタグタイトルを取得または表示するために使用されます。

構文

single_tag_title( string $prefix = '', bool $display = true );

引数の説明:

  • $prefix (string) — タグタイトルの前に表示するテキスト。デフォルトは空文字列。
  • $display (bool) — タイトルを直接表示するかどうか。trueの場合、表示し、falseの場合、タイトルを返します。

例1: タグタイトルの表示

この例では、現在のタグアーカイブページのタグタイトルを表示します。

<?php single_tag_title(); ?>

例2: タグタイトルの前にテキストを追加

タグタイトルの前に「タグ: 」というテキストを追加して表示します。

<?php single_tag_title( 'タグ: ' ); ?>

例3: タグタイトルを変数に格納

タグタイトルを表示せずに変数に格納します。

<?php $tag_title = single_tag_title( '', false ); ?>

例4: タグタイトルを条件付きで表示

タグタイトルが存在する場合のみ、タグタイトルを表示します。

<?php if ( single_tag_title( '', false ) ) { single_tag_title( 'タグ: ' ); } ?>

例5: タグタイトルをカスタムフォーマットで表示

タグタイトルをカスタムフォーマットで表示します。

<?php echo '現在のタグは「' . single_tag_title( '', false ) . '」です。'; ?>

例6: タグタイトルをリンク付きで表示

タグタイトルをリンク付きで表示します。

<?php echo '<a href="' . get_tag_link( get_query_var('tag_id') ) . '">' . single_tag_title( '', false ) . '</a>'; ?>

注意点

  • この関数はタグアーカイブページでのみ使用できます。それ以外のページで使用すると、期待した結果が得られない場合があります。
  • $display引数をfalseに設定した場合、関数はタイトルを返すため、表示するにはechoなどの出力関数を使用する必要があります。

関連機能：