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

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

「テンプレートタグ/the category」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/the_category 2008年2月26日 (火) 01:41 Klawdyo 版)
 
(和訳)
1行目: 1行目:
== Description ==
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
Displays a link to the category or categories a post belongs to. This tag must be used within [[The Loop]].
+
このテンプレートタグ '''<code>the_category</code>''' は、現在の記事が属するカテゴリへのリンクを表示します。このタグは[[:ja:The Loop|ループ]]の中で使わなければなりません。
  
== Usage ==
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
%%% <?php the_category('separator', 'parents' ); ?> %%%
+
<?php the_category('separator', 'parents' ); ?>
  
== Examples ==
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
  
===Separated by Space===
+
<div id="Separated_by_Space">
 +
=== 空白(スペース)区切り ===
 +
</div>
  
This usage lists categories with a space as the separator.
+
この使い方では、区切り文字として空白を使ってカテゴリを並べます。
  
 
<pre><p>Categories: <?php the_category(' '); ?></p></pre>
 
<pre><p>Categories: <?php the_category(' '); ?></p></pre>
  
<div style="border:1px solid blue; width:50%; padding:10px">Categories: [[#Examples|WordPress]] [[#Examples|Computers]] [[#Examples|Blogging]]</div>
+
<div class="example">Categories: [[#Examples|WordPress]] [[#Examples|Computers]] [[#Examples|Blogging]]</div>
  
===Separated by Comma===
+
<div id="Separated_by_Comma">
 +
=== カンマ区切り ===
 +
</div>
  
Displays links to categories, each category separated by a comma (if more than one).
+
カテゴリへのリンクをカンマで区切って表示(記事のカテゴリが複数あるとき)。
  
&lt;p&gt;This post is in: <?php the_category(', '); ?>&lt;/p&gt;
+
<pre><p>This post is in: <?php the_category(', '); ?></p></pre>
  
<div style="border:1px solid blue; width:50%; padding:10px">This post is in: [[#Examples|WordPress]], [[#Examples|Computers]], [[#Examples|Blogging]]</div>
+
<div class="example">This post is in: [[#Examples|WordPress]], [[#Examples|Computers]], [[#Examples|Blogging]]</div>
  
 +
<div id="Separated_by_Arrow">
 +
=== 矢印区切り ===
 +
</div>
  
===Separated by Arrow===
+
カテゴリへのリンクを矢印(&gt;)で区切って表示。('''注''': これを使うときは、<nowiki>></nowiki> の後ろのカテゴリをサブカテゴリだと思う閲覧者がいるかもしれないことに気をつけて!)
  
Displays links to categories with an arrow (&gt;) separating the categories. ('''Note:''' Take care when using this, since some viewers may interpret a category following a &gt; as a subcategory of the one preceding it.)
+
<pre><p>Categories: <?php the_category(' &amp;gt; '); ?></p></pre>
  
&lt;p&gt;Categories: <?php the_category(' &amp;gt; '); ?>&lt;/p&gt;
+
<div class="example">Categories: [[#Examples|WordPress]] > [[#Examples|Computers]] > [[#Examples|Blogging]]</div>
  
<div style="padding: 10px; width: 50%; border:solid 1px blue">Categories: [[#Examples|WordPress]] > [[#Examples|Computers]] > [[#Examples|Blogging]]</div>
+
<div id="Separated_by_a_Bullet">
 +
=== 中点区切り ===
 +
</div>
  
===Separated by a Bullet===
+
カテゴリへのリンクを中点(&bull;)で区切って表示。
  
Displays links to categories with a bullet (&bull;) separating the categories.
+
<pre><p>Post Categories: <?php the_category(' &amp;bull; '); ?></p></pre>
  
%%% <p>Post Categories: <?php the_category(' &amp;bull; '); ?></p>%%%
+
<div class="example">Post Categories: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
  
<div style="padding: 10px; width: 50%; border:solid 1px blue">Post Categories: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
== Parameters ==
+
; separator
 +
: (''文字列'') 各カテゴリリンクの間に表示する文字列・記号。デフォルトでは、番号なし箇条書き(<code><nowiki><ul></nowiki></code>)でリンクを並べます。
 +
; parents :
 +
: (''文字列'') 記事が子(サブ)カテゴリに属するとき、カテゴリリンクで「親子」関係をどう表示するか?オプション値:
 +
:* <code>'multiple'</code> - 親・子カテゴリへのリンクを分けて表示
 +
:* <code>'single'</code> (初期値) - 子カテゴリのみへのリンクを表示(親子関係は表示しない)。
  
; separator : (''string'') Text or character to display between each category link. The default is to place the links in an unordered list.
+
{{原文|Template Tags/the_category}}
; parents : (''string'') How to display links that reside in child (sub) categories. Options are:
+
:* <tt>'multiple'</tt> - Display separate links to parent and child categories, exhibiting "parent/child" relationship.
+
:* <tt>'single'</tt> - Display link to child category only, with link text exhibiting "parent/child" relationship.
+
: Note: Default is a link to the child category, with no relationship exhibited.
+
  
== Related ==
+
<div id="Related">
 +
== 関連 ==
 +
</div>
  
 
{{Tag Category Tags}}
 
{{Tag Category Tags}}
  
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
 +
 +
{{DEFAULTSORT:the_category}}
  
 
[[en:Template Tags/the_category]]
 
[[en:Template Tags/the_category]]

2008年3月6日 (木) 23:52時点における版

このテンプレートタグ the_category は、現在の記事が属するカテゴリへのリンクを表示します。このタグはループの中で使わなければなりません。

使い方

<?php the_category('separator', 'parents' ); ?>

用例

空白(スペース)区切り

この使い方では、区切り文字として空白を使ってカテゴリを並べます。

<p>Categories: <?php the_category(' '); ?></p>

カンマ区切り

カテゴリへのリンクをカンマで区切って表示(記事のカテゴリが複数あるとき)。

<p>This post is in: <?php the_category(', '); ?></p>
This post is in: WordPress, Computers, Blogging

矢印区切り

カテゴリへのリンクを矢印(>)で区切って表示。(: これを使うときは、> の後ろのカテゴリをサブカテゴリだと思う閲覧者がいるかもしれないことに気をつけて!)

<p>Categories: <?php the_category(' &gt; '); ?></p>
Categories: WordPress > Computers > Blogging

中点区切り

カテゴリへのリンクを中点(•)で区切って表示。

<p>Post Categories: <?php the_category(' &bull; '); ?></p>
Post Categories: WordPressComputersBlogging

パラメータ

separator
文字列) 各カテゴリリンクの間に表示する文字列・記号。デフォルトでは、番号なし箇条書き(<ul>)でリンクを並べます。
parents 
文字列) 記事が子(サブ)カテゴリに属するとき、カテゴリリンクで「親子」関係をどう表示するか?オプション値:
  • 'multiple' - 親・子カテゴリへのリンクを分けて表示
  • 'single' (初期値) - 子カテゴリのみへのリンクを表示(親子関係は表示しない)。

最新英語版: WordPress Codex » Template Tags/the_category


カテゴリータグ: the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category()


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