• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「テンプレートタグ/body class」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/body_class 17:06, 4 January 2010 Bono 版を翻訳用にコピー)
 
(翻訳、初期値一覧表を作成。用例が未翻訳)
1行目: 1行目:
{{Copyedit}}
+
{{Stub}}
== Description ==
+
== 説明 ==
In [[Version 2.8|WordPress 2.8]], themes have a new template tag for the body tag which will help theme authors to style more effectively with CSS. The new Template Tag is called '''body_class'''. This function gives the body element different classes and can be added, typically, in the header.php's HTML body tag.
+
[[Version 2.8|WordPress 2.8]] から、テーマの作者がより効果的<!-- 効率的? -->に CSS で装飾できるようにする <code>body</code> 要素用の新テンプレートタグ '''body_class''' が加わりました。この関数は、HTML の body 要素(通常 header.php にある)に異なる class 属性を付与し、さらに任意の class を追加することもできます。
  
== Usage ==
+
== 使い方 ==
  
%%% <?php body_class( $class ); ?> %%%
+
<?php body_class( [[#Parameters|$class]] ); ?>
  
The body_class may include one or more of the following values for the class attribute.
+
body_class は、class 属性として次の値を一つ以上表示します。
  
 
* rtl
 
* rtl
42行目: 42行目:
 
* search-paged-(page number)
 
* search-paged-(page number)
  
== Parameters ==
+
== ページ種類別初期値一覧 ==
  
[[Template Tags/How to Pass Tag Parameters#Tags with PHP function-style parameters|How to pass parameters to tags with PHP function-style parameters]]
+
{{draft|下表|
 +
* 間違いの指摘やよいまとめ方があったら、[[{{TALKPAGENAME}}|ノートページ]]や[[jaforum:forum/9|日本語フォーラム]]でアドバイスください。}}
  
{{Parameter|class|string or array|One or more classes to add to the class attribute, separated by a single space.|optional|null}}
+
{| class="border"
 +
|+
 +
! colspan="2" | ページ種類(条件) !! class !! 備考
  
== Examples ==
+
|-
 +
! [[Settings Reading SubPanel|表示設定]] > Front page displays - Your latest posts の場合 !! メインブログページ<br />([[Conditional Tags#is_front_page|is_front_page]], [[Conditional Tags#The Main Page|is_home]])
 +
| '''home blog''' [ paged paged-''n'' ] ||
 +
|-
 +
! rowspan="2" | [[Settings Reading SubPanel|表示設定]] > Front page displays - A static page の場合
 +
! 「Front page」として選択したページ ([[Conditional Tags#is_front_page|is_front_page]])
 +
| '''home''' page page-id-''ID'' [*] || * ''is_page'' も参照
 +
|-
 +
! 「Posts page」として選択したページ ([[Conditional Tags#The Main Page|is_home]])
 +
| '''blog''' [ paged paged-''n'' ] ||
 +
<!--
 +
上のとどちらのまとめ方がよいかな。。(こちらは書き途中)
 +
|-
 +
! rowspan="2" | [[Conditional Tags#is_front_page|is_front_page]] !! [[Settings Reading SubPanel|Reading Settings]] > Front page displays - Your latest posts
 +
| home blog [ paged paged-''n'' ] ||
 +
|-
 +
! [[Settings Reading SubPanel|Reading Settings]] > Front page displays - A static page - selected as "Front page"
 +
| home ||
 +
|-
 +
! Main Blog Page  !! [[Conditional Tags#The Main Page|is_home]]
 +
| blog [ paged paged-''n'' ] ||
 +
-->
 +
|-
 +
! rowspan="4" | is_archive !! is_author
 +
| archive '''author author-''user_nicename'''''<!-- 'author-' . sanitize_html_class($author->user_nicename , $author->ID) --> [ paged paged-''n'' author-paged-''n'' ] ||
 +
|-
 +
! <!-- is_archive -->is_category
 +
| archive '''category category-''slug''''' [ paged paged-''n'' category-paged-''n'' ] ||
 +
|-
 +
! <!-- is_archive -->is_tag
 +
| archive '''tag tag-''slug''''' [ paged paged-''n'' tag-paged-''n'' ] ||
 +
|-
 +
! <!-- is_archive -->is_date
 +
| archive '''date''' [ paged paged-''n'' date-paged-''n'' ] ||
 +
|-
 +
! rowspan="2" | is_search !! 検索結果あり
 +
| search '''search-results''' [ paged paged-''n'' search-paged-''n'' ] ||
 +
|-
 +
! <!-- is_search --> 検索結果なし
 +
| 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''<!-- 'attachment-' . str_replace($mime_prefix, '', $mime_type) --> ||
 +
|-
 +
! rowspan="3" | is_page !! -
 +
| page page-id-''ID'' [ page-template page-template-''template_file_name''<!-- 'page-template-' . str_replace( '.php', '-php', get_post_meta( $pageID, '_wp_page_template', true ) ) --> ] [ paged paged-''n'' page-paged-''n'' ] ||
 +
|-
 +
! <!-- is_page -->親ページ
 +
| page page-id-''ID'' '''page-parent''' [ page-template page-template-''template_file_name'' ] [ paged paged-''n'' page-paged-''n'' ]  ||
 +
|-
 +
! <!-- is_page -->子ページ
 +
| page page-id-''ID'' '''page-child parent-pageid-''parent-ID''''' [ page-template page-template-''template_file_name'' ] [ paged  paged-''n'' page-paged-''n'' ] ||
 +
|-
 +
! rowspan="5" | (条件によってさらに追加される class)
 +
! is_user_logged_in
 +
| logged-in || ログイン中
 +
|-
 +
! is_paged
 +
| paged || 改ページ
 +
|-
 +
! paged < 2<!-- !$page || $page < 2 -->
 +
| paged ||
 +
|-
 +
! paged > 1<!-- $page && $page > 1 -->
 +
| paged-''n'' page-paged-''n'' || 2ページ目以降
 +
|-
 +
! text_direction: rtl<!-- 'rtl' == get_bloginfo('text_direction') -->
 +
| rtl || 右→左向きに書く言語
 +
|}
  
=== Implementation ===
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 
 +
; class
 +
: (''文字列'' または ''配列'')(オプション) 初期値のほかに追加したい class 名。複数指定するときは(半角)スペースで区切る。初期値は null。
 +
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
=== 実装 ===<!-- Implementation -->
 
The following example shows how to implement the body_class template tag into a theme.  
 
The following example shows how to implement the body_class template tag into a theme.  
  
63行目: 151行目:
 
</pre>
 
</pre>
  
=== in the Default Theme ===
+
=== デフォルトテーマにおける使用例 ===
See {{BrowseSource|wp-includes/wp-content/themes/default/header.php}}.
+
{{BrowseSource|wp-content/themes/default/header.php}} を参照。
  
== Source Code ==
+
== ソースコード ==
body_class() is located in {{BrowseSource|wp-includes/post-template.php}}.
+
<code>body_class()</code> は {{BrowseSource|wp-includes/post-template.php}} にあります。
  
== Changelog ==
+
== 変更履歴 ==
* Since: 2.8
+
* [[Version 2.8|2.8]] : 新規テンプレートタグ
  
 
{{原文|Template Tags/body class|81631}}<!-- 17:06, 4 January 2010 Bono 版 -->
 
{{原文|Template Tags/body class|81631}}<!-- 17:06, 4 January 2010 Bono 版 -->
  
== Related ==
+
== 関連 ==
 
{{Tag Post Tags}}
 
{{Tag Post Tags}}
  
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
  
[[Category:Template Tags|Body_class]]
+
{{DEFAULTSORT:Body_class}}
 +
[[Category:wp2.8]]
  
 
[[en:Template Tags/body_class]]
 
[[en:Template Tags/body_class]]

2010年1月7日 (木) 19:12時点における版

このページ「テンプレートタグ/body class」はまだ書きかけで、情報が不足しています。続きを書いて WordPress を手助けしましょう.


説明

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(),


テンプレートタグへの PHP 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。