説明
array get_body_class( [ string $class = '' ] )
bodyタグのclass属性値を取得する。
パラメータ
- $classclass属性として追加するクラス名の文字列またはその配列
返り値
class属性値を含んだ配列を返す。ページタイプ別の配列の内容は、おおよそ次の通り。
| ページタイプ（テーマ内ファイル名） | 戻り値 |
|---|---|
| ホーム（index.php） | { 'home', 'blog' } |
| 日付別アーカイブ （archive.php, date.php） | { 'archive', 'date' } |
| カテゴリー別アーカイブ （archive.php, category.php） | { 'archive', 'category', 'category-1' } ※「1」の部分にはカテゴリーのスラッグが入る。 |
| タグ別アーカイブ （archive.php, tag.php） | { 'archive', 'tag', 'tag-mini' } ※「mini」の部分にはタグのスラッグが入る。 |
| 著者別アーカイブ （archive.php, author.php） | { archive author author-admin } ※「admin」の部分には著者名が入る。 |
| 投稿（single.php） | { 'single', 'single-post', 'postid-152' } ※「152」の部分には投稿情報IDが入る。 |
| ページ（page.php） | { 'page', 'page-id-2', 'page-template', 'page-template-default' } ※「2」の部分には投稿情報IDが入る。 |
| 検索結果ページ（search.php） | { 'search', 'search-results' } |
| 404ページ（404.php） | { 'error404' } |
| ログイン時（共通） | 配列に'logged-in'が含まれる |
注意
特にありません。使用例
- bodyタグのclass属性値を取得する。<?php $class_arr = get_body_class( ); ?>
フィルター
クラス名の配列を返す直前にbody_classフィルターを実行する。パラメータ$classesにはクラス名の配列が、 パラメータ$classには本関数で受け取った内容が格納されている。return apply_filters( 'body_class', $classes, $class );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/post-template.php最終更新 : 2018年05月27日 10:52
関連
お勧め
任意の名前でエラーログファイルを指定する（2019年2月15日 更新）
来週にはWordPress 5.1がリリース。RC1のソースコードを見ていると、 wp_debug_mode関数が変更されており、興味深かった。
Gutenbergでカスタムフィールドを使う（2018年8月10日 更新）
Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。
Slightly troublesome permalink：プラグイン作ってみました（2021年4月20日 更新）
カテゴリーを含んだパーマリンクを設定している場合、複数のカテゴリーを指定した投稿記事のパーマリンクのURLに目的のカテゴリーとは異なるカテゴリーが適用された経験はないだろうか。このプラグインは、パーマリンクに適用されるカテゴリーをコントロールし、希望通りのパーマリンクを設定します。WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日 更新）
WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。テキストエディタの文字を変更する（2018年5月27日 更新）
テキストエディタ（投稿ページの「テキスト」タブのエディタ）に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。