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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(使い方)
(残りを和訳。クリーンアップ。)
 
(4人の利用者による、間の6版が非表示)
1行目: 1行目:
{{Languages|
+
<div id="Description">
{{en|Template Tags/the_title_attribute}}
+
{{ja|テンプレートタグ/the_title_attribute}}
+
}}
+
 
+
 
== 説明 ==
 
== 説明 ==
 +
</div>
  
カレント投稿のタイトルを表示もしくは戻します。[[Template_Tags/the_title|the_title()]] の機能といくらか重複しますが、HTM [[Glossary#HTML|HTML]] タグをストリッピングし特定の文字(引用符を含む)を同等の[[Glossary#Character_Entity|文字エンティティ]]にコンバートすることによって、HTML 属性を使用しているタイトルの「クリーンな」バージョンを提供します。また、[[Template_Tags/How_to_Pass_Tag_Parameters#Tags_with_query-string-style_parameters|クエリーストリングスタイルのパラメータ]]を使用しています。このタグは [[The Loop|ループ]]内でのみ使えます。
+
現在の(または指定した)投稿のタイトルを表示するか、その値を返します。[[テンプレートタグ/the_title|the_title()]] の機能と一部重複しますが、次のような処理を行って HTML 属性として使えるようにタイトルの「クリーンな」バージョンを提供します。
 +
* [http://php.net/manual/ja/function.strip-tags.php <tt>strip_tags()</tt>] を使って [[Glossary#HTML|HTML]] タグを除去。
 +
* <tt>[[関数リファレンス/esc_attr|esc_attr()]]</tt> を使って特定の文字(引用符を含む)を同等の[[Glossary#Character_Entity|文字実体参照]]へ変換。
 +
また、[[テンプレートタグ/タグパラメータの渡し方#Tags_with_query-string-style_parameters|クエリ文字形式のパラメータ]]を使用します。現在の投稿を指定する場合、このタグは[[The Loop|ループ]]内で使ってください。
  
 +
<div id="Usage">
 
== 使い方 ==
 
== 使い方 ==
 +
</div>
  
<?php the_title_attribute( $args ); ?>
+
<?php the_title_attribute( $args ); ?>
  
 +
<div id="Parameters">
 
== パラメータ ==
 
== パラメータ ==
 +
</div>
 +
<!-- $args 配列のキーなので「$」を削除 20150902 gblsm -->
 +
{{Parameter|before|文字列|タイトルの前に表示するテキスト。|オプション}}
 +
{{Parameter|after|文字列|タイトルの後に表示するテキスト。|オプション}}
 +
{{Parameter|echo|真偽値|タイトルを表示する(<tt>TRUE</tt>)か、PHP で利用するために返す(<tt>FALSE</tt>)。|オプション|<tt>TRUE</tt>}}
 +
{{Parameter|post|整数/オブジェクト|タイトルを取得する投稿を ID またはオブジェクトで指定します。デフォルトでは現在の投稿から取得されます。|オプション|null}}
  
{{Parameter|before|string|Text to place before the title.|optional}}
+
<div id="Example">
{{Parameter|after|string|Text to place after the title.|optional}}
+
== 例 ==
{{Parameter|echo|Boolean|Echo the title  or return it for use in PHP.
+
</div>
:* <tt>1</tt> - echo
+
:* <tt>0</tt> - return
+
|optional|<tt>1</tt>}}
+
  
== 用例 ==
+
=== 配列形式の引数を使ったインライン利用 ===
=== Inline with array args ===
+
 
<pre>
 
<pre>
 
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( array( 'before' => 'Permalink to: ', 'after' => '' ) ); ?>"><?php the_title(); ?></a>
 
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( array( 'before' => 'Permalink to: ', 'after' => '' ) ); ?>"><?php the_title(); ?></a>
 
</pre>
 
</pre>
  
=== Inline with text args ===
+
=== テキスト形式の引数を使ったインライン利用 ===
 
<pre>
 
<pre>
function child_do_post_title() { ?>
+
<?php
 +
function child_do_post_title() {
 +
?>
 
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( 'before=Permalink to: "&after="' ); ?>"><?php the_title(); ?></a>
 
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( 'before=Permalink to: "&after="' ); ?>"><?php the_title(); ?></a>
 +
<?php
 +
}
 +
?>
 
</pre>
 
</pre>
  
=== PHP with text args ===
+
=== テキスト形式の引数を使った PHP 内での利用 ===
 
<pre>
 
<pre>
 
printf( '<a href="%s" title="%s">%s</a>', get_permalink(), the_title_attribute( 'echo=0' ), get_the_title() );
 
printf( '<a href="%s" title="%s">%s</a>', get_permalink(), the_title_attribute( 'echo=0' ), get_the_title() );
 
</pre>
 
</pre>
  
== Notes ==
+
<div id="Notes">
 +
== 参考 ==
 +
<div>
  
* See also: [[Template_Tags/the_title|the_title()]].
+
* [[テンプレートタグ/the_title|the_title()]] も見てください。
  
== Change Log ==
+
<div id="Change_Log">
 +
== 更新履歴 ==
 +
</div>
  
* Since: 2.3.0
+
* 新規導入: 2.3.0
  
==Source File==
+
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
  
<tt>the_title_attribute()</tt> is located in {{Trac|wp-includes/post-template.php}}.
+
<tt>the_title_attribute()</tt> {{Trac|wp-includes/post-template.php}} にあります。
  
== 関連 ==
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
  
{{Post Tags}}
+
{{Tag Post Tags}}
 
{{Tag Footer}}
 
{{Tag Footer}}
  
[[Category:Template Tags]]
+
{{原文|Function Reference/the_title_attribute|144940}} <!-- 07:00, 21 July 2014 Jb510 版 -->
 
+
 
+
{{原文|Template Tags/the_title_attribute|118523}}
+
  
 +
{{DEFAULTSORT:The_title_attribute}}
 +
[[Category:テンプレートタグ]]
 
[[Category:wp2.3]]
 
[[Category:wp2.3]]
  
[[en:Template Tags/the_title_attribute]]
+
[[en:Function Reference/the_title_attribute]]

2015年9月2日 (水) 22:47時点における最新版

現在の(または指定した)投稿のタイトルを表示するか、その値を返します。the_title() の機能と一部重複しますが、次のような処理を行って HTML 属性として使えるようにタイトルの「クリーンな」バージョンを提供します。

また、クエリ文字形式のパラメータを使用します。現在の投稿を指定する場合、このタグはループ内で使ってください。

使い方

<?php the_title_attribute( $args ); ?>

パラメータ

before
文字列) (オプション) タイトルの前に表示するテキスト。
初期値: なし
after
文字列) (オプション) タイトルの後に表示するテキスト。
初期値: なし
echo
真偽値) (オプション) タイトルを表示する(TRUE)か、PHP で利用するために返す(FALSE)。
初期値: TRUE
post
整数/オブジェクト) (オプション) タイトルを取得する投稿を ID またはオブジェクトで指定します。デフォルトでは現在の投稿から取得されます。
初期値: null

配列形式の引数を使ったインライン利用

<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( array( 'before' => 'Permalink to: ', 'after' => '' ) ); ?>"><?php the_title(); ?></a>

テキスト形式の引数を使ったインライン利用

<?php
function child_do_post_title() {
?>
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute( 'before=Permalink to: "&after="' ); ?>"><?php the_title(); ?></a>
<?php
}
?>

テキスト形式の引数を使った PHP 内での利用

printf(	'<a href="%s" title="%s">%s</a>', get_permalink(), the_title_attribute( 'echo=0' ), get_the_title() );