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

「テンプレートタグ/single tag title」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/single_tag_title 2007年10月28日 (日) 17:20 Anonymous 版)
 
(和訳を少々見直し。)
 
(2人の利用者による、間の5版が非表示)
1行目: 1行目:
== Description ==
+
<div id="Description">
Displays or returns the tag title for the current page.
+
== 説明 ==
 +
</div>
  
== Usage ==
+
現在のページのタグタイトルを表示または取得します。
 +
タグアーカイブページで使用します。
  
%%% <?php single_tag_title('prefix', 'display'); ?> %%%
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
== Examples ==
+
<?php single_tag_title( $prefix, $display ); ?>
  
This example displays the text "'''Currently browsing '''" followed by the tag title.
+
<div id="Default Usage">
 +
=== デフォルトの使い方 ===
 +
</div>
  
  &lt;p&gt;<?php single_tag_title('Currently browsing '); ?>.&lt;/p&gt;
+
  <?php single_tag_title(); ?>
 +
 
 +
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 
 +
{{Parameter|$prefix|文字列|タグタイトルの前に出力するテキスト。|オプション}}
 +
: 参考:現状では、$display 引数が false のとき $prefix 引数は無視されます。[http://core.trac.wordpress.org/ticket/16632 trac チケット #16632] を参照してください。
 +
 
 +
{{Parameter|$display|真偽値|タグタイトルを表示するか(<tt>TRUE</tt>)、PHP で扱えるように値として返すか(<tt>FALSE</tt>)。|オプション|<tt>TRUE</tt>}}
 +
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
最初の例は、"'''Currently browsing '''" というテキストに続けてタグタイトルを表示します。
 +
 
 +
<pre>
 +
<p><?php single_tag_title( 'Currently browsing ' ); ?>.</p>
 +
</pre>
  
 
<div style="border:1px solid blue; width:50%; padding:10px">Currently browsing WordPress.</div>
 
<div style="border:1px solid blue; width:50%; padding:10px">Currently browsing WordPress.</div>
  
  
This example assigns the current tag title to the variable $current_tag for use in PHP.
+
次の例は、PHP で扱うために現在のタグタイトルを変数 <code>$current_tag</code> に代入します。
  
  <?php $current_tag = single_tag_title("", false); ?>
+
  <?php $current_tag = single_tag_title( "", false ); ?>
  
== Parameters ==
+
<div id="Change_Log">
 +
== 変更履歴 ==
 +
</div>
  
; prefix : (''string'') Text to output before the tag title. Defaults to <tt>&#39;&#39;</tt> (no text).
+
* [[Version 3.1|3.1.0]] から、内部で [[関数リファレンス/single_term_title|single_term_title()]] を使うようになりました。
; display : (''boolean'') Display the tag's title (<tt>TRUE</tt>) or return it for use in PHP (<tt>FALSE</tt>). Defaults to <tt>TRUE</tt>.
+
* [[Version 2.3|2.3.0]] から導入されました。
  
== Related ==
+
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
 +
 
 +
<tt>single_tag_title()</tt> は {{Trac|wp-includes/general-template.php}} にあります。
 +
 
 +
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
 
{{Tag Tag Tags}}
 
{{Tag Tag Tags}}
  
{{PHP Function Tag Footer}}
+
{{Tag Footer}}
 +
 
 +
{{原文|Function_Reference/single_tag_title|133368}} <!-- 22:14, 21 July 2013 Vaxace 版 -->
 +
 
 +
{{DEFAULTSORT:Single_tag_title}}
 +
[[Category:テンプレートタグ]]
 +
 
 +
[[en:Function Reference/single_tag_title]]
 +
[[tr:Tema_Etiketleri/single_tag_title]]

2014年8月25日 (月) 21:32時点における最新版

現在のページのタグタイトルを表示または取得します。 タグアーカイブページで使用します。

使い方

<?php single_tag_title( $prefix, $display ); ?>

デフォルトの使い方

<?php single_tag_title(); ?>

パラメータ

$prefix
文字列) (オプション) タグタイトルの前に出力するテキスト。
初期値: なし
参考:現状では、$display 引数が false のとき $prefix 引数は無視されます。trac チケット #16632 を参照してください。
$display
真偽値) (オプション) タグタイトルを表示するか(TRUE)、PHP で扱えるように値として返すか(FALSE)。
初期値: TRUE

用例

最初の例は、"Currently browsing " というテキストに続けてタグタイトルを表示します。

<p><?php single_tag_title( 'Currently browsing ' ); ?>.</p>
Currently browsing WordPress.


次の例は、PHP で扱うために現在のタグタイトルを変数 $current_tag に代入します。

<?php $current_tag = single_tag_title( "", false ); ?>

変更履歴

ソースファイル

single_tag_title()wp-includes/general-template.php にあります。


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


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


最新英語版: WordPress Codex » Function_Reference/single_tag_title最新版との差分