当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/get the term list」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get the term list 21:42, 6 July 2014 Jdgrimes 版を反映して和訳を見直し。)
1行目: 1行目:
{{Old}}
+
<div id="Description">
 
+
 
== 説明 ==
 
== 説明 ==
 +
</div>
  
投稿と指定した分類に関連付けられた分類キーワードの HTML 文字列を返します。分類キーワードは、それぞれの分類キーワード一覧ページにリンクします。
+
指定されたタクソノミー(カスタム分類)に関して、投稿に付けられたタームの HTML 文字列を返します。
 +
タームの文字列は、そのタームのアーカイブページへリンクします。
  
 +
<div id="Usage">
 
== 使い方 ==
 
== 使い方 ==
 +
</div>
  
 
  <?php get_the_term_list( $id, $taxonomy, $before, $sep, $after ) ?>  
 
  <?php get_the_term_list( $id, $taxonomy, $before, $sep, $after ) ?>  
  
 +
<div id="Parameters">
 
== パラメータ ==
 
== パラメータ ==
 +
</div>
  
{{Parameter|$id|int|Post ID|必須|0}}
+
{{Parameter|$id|整数|投稿 ID|必須}}
{{Parameter|$taxonomy|string|分類名}}
+
{{Parameter|$taxonomy|文字列|タクソノミーの名前}}
{{Parameter|$before|string|前の文字列|オプション}}
+
{{Parameter|$before|文字列|前に入れる文字列|オプション|空文字列}}
{{Parameter|$sep|string|区切り文字列|オプション}}
+
{{Parameter|$sep|文字列|タームを区切る文字列|オプション|空文字列}}
{{Parameter|$after|string|後の文字列|オプション}}
+
{{Parameter|$after|文字列|後に続く文字列|オプション|空文字列}}
  
 +
<div id="Return Values">
 
== 戻り値 ==
 
== 戻り値 ==
 +
</div>
  
; (文字列) : 分類キーワードの HTML 文字列。
+
; (文字列) : タームの HTML 文字列
  
== 用例 ==
+
<div id="Examples">
 +
== ==
 +
</div>
  
 +
<div id="A Basic Example">
 
=== 基本的な例 ===
 
=== 基本的な例 ===
 +
</div>
  
ループ内で使用すると、この関数は、特定の投稿の people 分類のキーワードを出力します。
+
ループ内で使用すると、下記の例は、特定の投稿の people カスタム分類のタームを出力します。
  
<pre><nowiki> <?php echo get_the_term_list( $post->ID, 'people', 'People: ', ', ', '' ); ?> </nowiki></pre>
+
<pre><?php echo get_the_term_list( $post->ID, 'people', 'People: ', ', ' ); ?></pre>
  
 
以下のような出力になります。
 
以下のような出力になります。
  
People:  
+
<pre>
<a href="person1">Person 1</a>,  
+
People: <a href="person1">Person 1</a>, <a href="person2">Person 2</a>, ...
<a href="person2">Person 2</a>, ...
+
</pre>
  
== 変更履歴 ==
+
<div id="Returning an HTML List">
 +
=== HTML のリストを返す ===
 +
</div>
  
* Since: [[Version 2.5|2.5.0]]
+
ループ内で使用すると、下記の例は、特定の投稿の styles カスタム分類のタームを (x)html のリストで出力します。
  
 +
<pre><nowiki>
 +
echo '<ul class="styles">';
 +
echo get_the_term_list( $post->ID, 'styles', '<li>', ',</li><li>', '</li>' );
 +
echo '</ul>';
 +
</nowiki></pre>
 +
 +
以下のような出力になります。
 +
 +
<pre><nowiki>
 +
<ul class="styles">
 +
    <li><a href="person1">Style 1,</a></li>
 +
    <li><a href="person2">Style 2,</a></li>
 +
</ul>
 +
</nowiki></pre>
 +
 +
<div id="Change Log">
 +
== 変更履歴 ==
 +
</div>
 +
* [[Version 2.5|2.5.0]] にて導入されました。
 +
 +
<div id="Source File">
 
== ソースファイル ==
 
== ソースファイル ==
 +
</div>
 +
 +
<tt>get_the_term_list()</tt> は {{Trac|wp-includes/category-template.php}} にあります。
 +
 +
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
<tt>get_the_term_list()</tt> is located in {{Trac|wp-includes/category-template.php}}.
+
[[テンプレートタグ/get_the_tag_list|<code>get_the_tag_list()</code>]]
  
== 関連 ==
+
{{Term Tags}}
get_the_terms(), wp_get_object_terms()
+
  
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function Reference/get the term list|93937}}<!-- 18:36, 20 October 2010 Sunriseweb 版 -->
+
{{原文|Function Reference/get the term list|144688}} <!-- 21:42, 6 July 2014 Jdgrimes 版 -->
  
 
{{DEFAULTSORT:Get_the_term_list}}
 
{{DEFAULTSORT:Get_the_term_list}}
 
[[Category:関数]]
 
[[Category:関数]]
 +
[[Category:タクソノミー]]
  
 
[[en:Function Reference/get the term list]]
 
[[en:Function Reference/get the term list]]

2014年7月31日 (木) 15:48時点における版

指定されたタクソノミー(カスタム分類)に関して、投稿に付けられたタームの HTML 文字列を返します。 タームの文字列は、そのタームのアーカイブページへリンクします。

使い方

<?php get_the_term_list( $id, $taxonomy, $before, $sep, $after ) ?> 

パラメータ

$id
整数) (必須) 投稿 ID
初期値: なし
$taxonomy
文字列) (必須) タクソノミーの名前
初期値: なし
$before
文字列) (オプション) 前に入れる文字列
初期値: 空文字列
$sep
文字列) (オプション) タームを区切る文字列
初期値: 空文字列
$after
文字列) (オプション) 後に続く文字列
初期値: 空文字列

戻り値

(文字列) 
タームの HTML 文字列

基本的な例

ループ内で使用すると、下記の例は、特定の投稿の people カスタム分類のタームを出力します。

<?php echo get_the_term_list( $post->ID, 'people', 'People: ', ', ' ); ?>

以下のような出力になります。

People: <a href="person1">Person 1</a>, <a href="person2">Person 2</a>, ...

HTML のリストを返す

ループ内で使用すると、下記の例は、特定の投稿の styles カスタム分類のタームを (x)html のリストで出力します。

echo '<ul class="styles">';
echo get_the_term_list( $post->ID, 'styles', '<li>', ',</li><li>', '</li>' );
echo '</ul>';

以下のような出力になります。

<ul class="styles">
    <li><a href="person1">Style 1,</a></li> 
    <li><a href="person2">Style 2,</a></li>
</ul>

変更履歴

  • 2.5.0 にて導入されました。

ソースファイル

get_the_term_list()wp-includes/category-template.php にあります。

get_the_tag_list()

タームタグ: is_term(), term_exists(), get_objects_in_term(), get_term(), get_term_by(), get_term_children(), get_term_link(), get_terms(), get_the_terms(), get_the_term_list(), has_term(), sanitize_term(), the_terms(), get_object_taxonomies() is_object_in_taxonomy() the_taxonomies() wp_get_object_terms(), wp_set_object_terms(), wp_get_post_terms(), wp_set_post_terms(), wp_delete_object_term_relationships()



関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/get the term list最新版との差分