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

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

テンプレートタグ/the title attribute

提供: WordPress Codex 日本語版
移動先: 案内検索

現在の(または指定した)投稿のタイトルを表示するか、その値を返します。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() );