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

説明

基本構文

the_category( string $separator = '', string $parents = '', int|false $post_id = false ): void

引数

• $separator：カテゴリー間の区切り
• $parents：親カテゴリーの表示方法
• $post_id：投稿ID

戻り値

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

使い方（サンプル）

the_category( '、' );

注意点

• リンクなしのカテゴリー名を取得したい場合は get_the_category() を使います。

実務での使いどころ

• 投稿のカテゴリーを、リンク付きで出力するとき。
• 区切り文字を指定して、複数のカテゴリーを並べるとき（the_category( ', ' )）。

よくあるミスと対処

• 区切り文字を省略すると、リスト（<ul>）として出力される。横に並べたいときは、区切り文字を指定する。
• カテゴリー名やスラッグだけが欲しいのに、これを使っている。値の取得は get_the_category()。
• カスタムタクソノミーには使えない。

NG例

the_category(); // <ul><li> のリストで出力される

OK例

the_category( ', ' );

使い分け早見表

関連項目

get_the_category()、the_tags()

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