- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
テンプレートタグ/body class
説明
WordPress 2.8 から、テーマの作者がより効果的に CSS で装飾できるようにする body
要素用の新テンプレートタグ body_class が加わりました。この関数は、HTML の body 要素(通常 header.php にある)に異なる class 属性を付与し、さらに任意の class を追加することもできます。
使い方
<?php body_class( $class ); ?>
body_class は、class 属性として次の値を一つ以上表示します。
- rtl
- home
- blog
- archive
- date
- search
- paged
- attachment
- error404
- single postid-(id)
- attachmentid-(id)
- attachment-(mime-type)
- author
- author-(user_nicename)
- category
- category-(slug)
- tag
- tag-(slug)
- page-parent
- page-child parent-pageid-(id)
- page-template page-template-(template file name)
- search-results
- search-no-results
- logged-in
- paged-(page number)
- single-paged-(page number)
- page-paged-(page number)
- category-paged-(page number)
- tag-paged-(page number)
- date-paged-(page number)
- author-paged-(page number)
- search-paged-(page number)
ページ種類別初期値一覧
ページ種類(条件) | class | 備考 | |
---|---|---|---|
表示設定 > Front page displays - Your latest posts の場合 | メインブログページ (is_front_page, is_home) |
home blog [ paged paged-n ] | |
表示設定 > Front page displays - A static page の場合 | 「Front page」として選択したページ (is_front_page) | home page page-id-ID [*] | * is_page も参照 |
「Posts page」として選択したページ (is_home) | blog [ paged paged-n ] | ||
is_archive | is_author | archive author author-user_nicename [ paged paged-n author-paged-n ] | |
is_category | archive category category-slug [ paged paged-n category-paged-n ] | ||
is_tag | archive tag tag-slug [ paged paged-n tag-paged-n ] | ||
is_date | archive date [ paged paged-n date-paged-n ] | ||
is_search | 検索結果あり | search search-results [ paged paged-n search-paged-n ] | |
検索結果なし | search search-no-results [ paged paged-n search-paged-n ] | ||
is_404 | error404 | ||
is_single | single postid-ID [ paged paged-n single-paged-n] | ||
is_attachment | attachment single postid-ID attachmentid-postID attachment-mime-type | ||
is_page | - | page page-id-ID [ page-template page-template-template_file_name ] [ paged paged-n page-paged-n ] | |
親ページ | page page-id-ID page-parent [ page-template page-template-template_file_name ] [ paged paged-n page-paged-n ] | ||
子ページ | page page-id-ID page-child parent-pageid-parent-ID [ page-template page-template-template_file_name ] [ paged paged-n page-paged-n ] | ||
(条件によってさらに追加される class) | is_user_logged_in | logged-in | ログイン中 |
is_paged | paged | 改ページ | |
paged < 2 | paged | ||
paged > 1 | paged-n page-paged-n | 2ページ目以降 | |
text_direction: rtl | rtl | 右→左向きに書く言語 |
パラメータ
- class
- (文字列 または 配列)(オプション) 初期値のほかに追加したい class 名。複数指定するときは(半角)スペースで区切る。初期値は null。
用例
実装
The following example shows how to implement the body_class template tag into a theme.
<body <?php body_class(); ?>>
The actual HTML output might resemble something like this (the 'About' page from a default WordPress installation):
<body class="page page-id-2 page-template page-template-default logged-in">
デフォルトテーマにおける使用例
wp-content/themes/default/header.php
を参照。
ソースコード
body_class()
は wp-includes/post-template.php
にあります。
変更履歴
- 2.8 : 新規テンプレートタグ
最新英語版: WordPress Codex » Template Tags/body class (最新版との差分)
関連
投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),