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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(最新版に更新、一部修正)
(用例のコード修正。{{Tag Post Tags}} 修正。Codex内リンク先修正。)
1行目: 1行目:
 
== 説明 ==
 
== 説明 ==
  
現在の投稿のタイトルを表示するか、その値を返します。。[[テンプレートタグ/the_title|the_title()]] の機能と一部重複しますが、[[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()]] の機能と一部重複しますが、[[Glossary#HTML|HTML]] タグを除去し、特定の文字(引用符を含む)を同等の[[Glossary#Character_Entity|文字実体参照]]に変換することによって、HTML 属性を使用しているタイトルのクリーンなバージョンを提供します。また、[[テンプレートタグ/タグパラメータの渡し方#Tags_with_query-string-style_parameters|クエリ文字形式のパラメータ]]を使用しています。このタグは[[The Loop|ループ]]内でのみ使えます。
  
 
== 使い方 ==
 
== 使い方 ==
  
<?php the_title_attribute( $args ); ?>
+
<?php the_title_attribute( $args ); ?>
  
 
== パラメータ ==
 
== パラメータ ==
  
{{Parameter|$before|string|タイトルの前に表示するテキスト。|optional}}
+
{{Parameter|$before|文字列|タイトルの前に表示するテキスト。|オプション}}
{{Parameter|$after|string|タイトルの後に表示するテキスト。|optional}}
+
{{Parameter|$after|文字列|タイトルの後に表示するテキスト。|オプション}}
{{Parameter|$echo|Boolean|タイトルを表示する (<tt>TRUE</tt>) か、PHP で利用するためにリターン (<tt>FALSE</tt>) する。|optional|<tt>TRUE</tt>}}
+
{{Parameter|$echo|真偽値|タイトルを表示する (<tt>TRUE</tt>) か、PHP で利用するために返す (<tt>FALSE</tt>) |オプション|<tt>TRUE</tt>}}
:* <tt>1</tt> - echo
+
:* <tt>TRUE (1)</tt> - 表示する
:* <tt>0</tt> - return
+
:* <tt>FALSE (0)</tt> - 返す
|optional|<tt>1</tt>}}
+
  
 
== 用例 ==
 
== 用例 ==
=== 配列変数を使ったインライン利用 ===
+
=== 配列形式の引数を使ったインライン利用 ===
 
<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>
  
=== テキスト変数を使ったインライン利用 ===
+
=== テキスト形式の引数を使ったインライン利用 ===
 
<pre>
 
<pre>
 
<?php
 
<?php
28行目: 27行目:
 
?>
 
?>
 
<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 内での利用 ===
+
=== テキスト形式の引数を使った 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() );
37行目: 39行目:
 
== 注 ==
 
== 注 ==
  
* 参照: [[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> は {{Trac|wp-includes/post-template.php}} に含まれています。
 
<tt>the_title_attribute()</tt> は {{Trac|wp-includes/post-template.php}} に含まれています。
49行目: 55行目:
 
== 関連 ==
 
== 関連 ==
  
{{Post Tags}}
+
{{Tag Post Tags}}
 
{{Tag Footer}}
 
{{Tag Footer}}
  
[[Category:Template Tags]]
+
{{原文|Function Reference/the_title_attribute|128285}} <!-- 2013-03-05T16:11:59 Adam.samec 版 -->
 
+
 
+
{{原文|Template Tags/the_title_attribute|128285}} <!-- 2013-03-05T16:11:59 Adam.samec 版 -->
+
  
 +
{{DEFAULTSORT:The_title_attribute}}
 +
[[Category:テンプレートタグ]]
 
[[Category:wp2.3]]
 
[[Category:wp2.3]]
  
[[en:Template Tags/the_title_attribute]]
+
[[en:Function Reference/the_title_attribute]]

2014年8月26日 (火) 19:28時点における版

説明

現在の投稿のタイトルを表示するか、その値を返します。。the_title() の機能と一部重複しますが、HTML タグを除去し、特定の文字(引用符を含む)を同等の文字実体参照に変換することによって、HTML 属性を使用しているタイトルのクリーンなバージョンを提供します。また、クエリ文字形式のパラメータを使用しています。このタグはループ内でのみ使えます。

使い方

<?php the_title_attribute( $args ); ?>

パラメータ

$before
文字列) (オプション) タイトルの前に表示するテキスト。
初期値: なし
$after
文字列) (オプション) タイトルの後に表示するテキスト。
初期値: なし
$echo
真偽値) (オプション) タイトルを表示する (TRUE) か、PHP で利用するために返す (FALSE) 。
初期値: TRUE
  • TRUE (1) - 表示する
  • FALSE (0) - 返す

用例

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

<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() );

更新履歴

バージョン 2.3.0 にて導入されました。

ソースファイル

the_title_attribute()wp-includes/post-template.php に含まれています。

関連

投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


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


最新英語版: WordPress Codex » Function Reference/the_title_attribute最新版との差分