- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。（詳細）
「テンプレートタグ/body class」の版間の差分
細 (→関連: {{原文|Function Reference/wp link pages|81631}} <!-- 17:06, 4 January 2010 Bono 版 -->) |
細 (→関連) |
||
| 160行目: | 160行目: | ||
{{原文|Template Tags/body class|81631}}<!-- 17:06, 4 January 2010 Bono 版 --> | {{原文|Template Tags/body class|81631}}<!-- 17:06, 4 January 2010 Bono 版 --> | ||
| + | |||
| + | === フック === | ||
| + | * フィルターフック: [[Plugin_API/Filter_Reference/body_class|'body_class']] | ||
== 関連 == | == 関連 == | ||
2015年6月16日 (火) 09:43時点における版
説明
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 | 備考 | |
|---|---|---|---|
| 表示設定 > フロントページの表示 が「最新の投稿」の場合 | メインブログページ (is_front_page, is_home) |
home blog [ paged paged-n ] | [] 内は2ページ目以降のみ、n はページ番号 |
| 表示設定 > フロントページの表示 が「固定ページ」の場合 | 「フロントページ」として選択したページ (is_front_page) | home page page-id-ID [*] | * is_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 ] | ||
| 404エラーページ (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 > 1 | paged-n page-paged-n | 2ページ目以降 | |
| text_direction: rtl | rtl | 右→左向きに書く言語 | |
パラメータ
- class
- （文字列 または 配列）（オプション） 初期値のほかに追加したい class 名。複数指定するときは（半角）スペースで区切る。初期値は null。
用例
実装
body_class のテーマへの組み込み方の例を示します。
<body <?php body_class(); ?>>
実際の HTML 出力は次のようになります（WordPress 新規インストールで作られる 'About' ページの例）。
<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'
関連
投稿タグ: 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(),
最新英語版： WordPress Codex » Function Reference/wp link pages （最新版との差分）
