the_title_attribute()


WordPressの関数the_title_attribute()は、投稿や固定ページのタイトルをHTML属性内で安全に表示するために使用されます。この関数は主に、リンクやalt属性などでタイトルを扱う際に用いられます。

構文

the_title_attribute( array $args = array() );

引数の説明:

  • $before (string) — タイトルの前に挿入するテキスト。
  • $after (string) — タイトルの後に挿入するテキスト。
  • $echo (bool) — 結果を直接出力するか、返すか。デフォルトはtrue。
  • $post (WP_Post|int|null) — 特定の投稿を指定するオプション。省略時は現在の投稿。

例1: 現在の投稿タイトルの表示

現在の投稿タイトルをリンク属性内で表示する基本的な例です。

<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>

例2: 特定の投稿のタイトルを取得

投稿IDを指定して、その投稿のタイトルを取得します。

<?php
$args = array(
    'post' => get_the_ID(),
    'echo' => false
);
$title = the_title_attribute( $args );
echo $title;
?>

例3: タイトルの前後にテキストを追加

タイトルの前に「タイトル:」を追加し、後に「 – 終了」を追加します。

<?php
$args = array(
    'before' => 'タイトル: ',
    'after' => ' - 終了',
    'echo' => true
);
the_title_attribute( $args );
?>

例4: 条件付きでタイトルを出力

タイトルが50文字以上の場合、トリミングして出力します。

<?php
$title = the_title_attribute( array( 'echo' => false ) );
if ( strlen( $title ) > 50 ) {
    echo mb_substr( $title, 0, 50 ) . '...';
} else {
    echo $title;
}
?>

例5: alt属性でのタイトル利用

画像タグのalt属性に投稿タイトルを使用します。

<img src="<?php echo get_the_post_thumbnail_url(); ?>" alt="<?php the_title_attribute(); ?>">

注意点

  • HTML属性内に特殊文字が含まれる場合、自動的にエスケープされます。
  • この関数を繰り返し使用する場合は、echoをfalseに設定し、結果を変数として取得する方が効率的です。

関連機能：