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

説明

基本構文

the_excerpt(): void

引数

引数はありません。

戻り値

戻り値はありません（出力します）。

使い方（サンプル）

// ループ内で使用
the_excerpt();

注意点

• 抜粋が未入力のときは、本文の冒頭が自動で使われます。
• 日本語では、自動抜粋の長さが単語数基準のため、excerpt_length や excerpt_mblength の調整が必要になることがあります。

実務での使いどころ

• 一覧ページで、投稿の抜粋を出力するとき。

よくあるミスと対処

• echo the_excerpt() のように、echo を付けている。the_excerpt() は、それ自体が出力する。
• 抜粋が未入力でも、本文から自動で生成される。意図した文章にするには、抜粋欄に入力する。
• 自動生成の長さや、末尾の「[…]」は、excerpt_length・excerpt_more フィルターで変更する。

NG例

echo the_excerpt(); // それ自体が出力する関数なので、echo は不要

OK例

the_excerpt();

使い分け早見表

関連項目

get_the_excerpt()、the_content()

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