get_the_title() の使い方｜説明・引数・注意点

説明

基本構文

get_the_title( int|WP_Post $post = 0 ): string

引数

• $post：投稿IDまたはオブジェクト。省略するとループ中の投稿

戻り値

タイトルの文字列。

使い方（サンプル）

echo esc_html( get_the_title( 123 ) );

注意点

• 出力しないので、画面に表示するときは自分で echo します。
• 出力時は esc_html() でエスケープするのが安全です。

実務での使いどころ

• 投稿のタイトルを、文字列として取得するとき。
• 投稿IDを指定して、ループの外からタイトルを取得するとき。

よくあるミスと対処

• 出力ではなく、値を返す関数。echo を付け忘れる。
• ループの外で、IDを渡していない。
• パスワード保護や非公開の投稿では、「保護中:」「非公開:」などの接頭辞が付いた文字列が返る。

NG例

get_the_title( 123 ); // 返すだけで、出力されない

OK例

echo esc_html( get_the_title( 123 ) );

使い分け早見表

関連項目

the_title()、get_post_field()

公式リファレンス：get_the_title() | Function | WordPress Developer Resources