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

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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2008年5月5日 (月) 08:12時点におけるBono (トーク | 投稿記録)による版 (4 版)

移動先: 案内検索

表示中のタグに付けられたタグの HTML 文字列を返します。各タグ名にはそれぞれの「タグ」ページへのリンクが張られています。ファンクションを呼び出すときに、タグ全体の前後や各タグの間に入れる文字を設定することができます。このタグはループの中で使用しなければなりません。

使い方

<?php get_the_tag_list('前', '区切り文字', '後'); ?>

このファンクションは何も表示しません。ページに直接表示したい場合は、echo (get_the_tag_list()) を使う必要があります。$foo = get_the_tag_list() のように、変数に格納することもできます。

変数はすべてオプションであり、順に「前」、「区切り文字」、「後」に置き換えられます。各フィールドには HTML 文を使うことができます。

用例

基本的な例

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

<?php
echo get_the_tag_list('<p>Tags: ',', ','</p>');
?>

この例は以下のように表示します。

<p>
Tags: 
<a href="tag1">Tag 1</a>, 
<a href="tag2">Tag 2</a>, ... 
</p>

ちょっと複雑な例

この例では投稿にタグがついているかをチェックし、ついている場合はデフォルト順のリストを表示します。

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

パラメータ

文字列) タグ一覧の前に表示する文字列。初期値では何も表示しません
区切り文字
文字列) 各タグリンクの間に表示する文字列・記号。初期値では何も表示しません
文字列) 最後のタグの後ろに表示する文字列。初期値では何も表示しません

変更履歴

  • 2.3 : 新規テンプレートタグ

タグ: 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()


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。


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