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

説明

基本構文

post_class( string|string[] $css_class = '', int|WP_Post $post = null ): void

引数

• $css_class：追加するクラス名
• $post：投稿IDまたはオブジェクト

戻り値

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

使い方（サンプル）

echo '<article class="' . esc_attr( implode( ' ', get_post_class() ) ) . '">';

注意点

• 出力されるクラスから、投稿タイプやタームごとにスタイルを分けられます。

実務での使いどころ

• 投稿ごとの、CSSのクラス（ID、投稿タイプ、カテゴリーなど）を、出力するとき。
• <article> などに、状態を表す、クラスを、付けるとき。

よくあるミスと対処

• class="..." の中で、呼んでいる。この関数は、class="..." 全体を、出力する。
• クラスを、追加したいのに、直接書いている。引数で、追加できる。
• 値（クラスの配列）が欲しいのに、これを使っている。配列は、get_post_class()。

NG例

<article class="<?php post_class(); ?>"> <!-- class が二重になる -->

OK例

<article <?php post_class( 'news-item' ); ?>>

使い分け早見表

関連項目

body_class()、get_post_class()

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