Uses
| Uses | Description |
|---|---|
| wp-includes/formatting.php: esc_attr() | Escaping for HTML attributes. |
| wp-includes/post-template.php: get_body_class() | Retrieves an array of the class names for the body element. |
Displays the class names for the body element.
(string|string[]) (Optional) Space-separated string or array of class names to add to the class list.
Default value: ''
This function gives the body element different classes and can be added, typically, in the header.php’s HTML body tag.
Basic Usage
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 the Tests page from the Theme Unit Test):
<body class="page page-id-2 page-parent page-template-default logged-in">
In the WordPress Theme stylesheet, add the appropriate styles, such as:
.page {
/* styles for all posts within the page class */
}
.page-id-2 {
/* styles for only page ID number 2 */
}
.logged-in {
/* styles for all pageviews when the user is logged in */
}
File: wp-includes/post-template.php
function body_class( $class = '' ) {
// Separates class names with a single space, collates class names for body element.
echo 'class="' . esc_attr( join( ' ', get_body_class( $class ) ) ) . '"';
} | Version | Description |
|---|---|
| 2.8.0 | Introduced. |
© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/body_class