body_class( string|string[] $classes = '' )

Affiche les classes CSS de la balise HTML body.

Paramètre

$classes(string|string[])optionnel

Une chaîne de classes CSS séparées par des espaces ou un tableau de classes à ajouter à la liste par défaut.

Valeur par défaut : ''

Description / Informations supplémentaires

Cette fonction donne à l'élément body différentes classes CSS habituellement ajoutées à la balise HTML body du fichier header.php.

Retourne

(string) L'attribut class implémenté des classes CSS natives et/ou personnalisées.

Déclaration et structure de la fonction body_class()

function body_class( $css_class = '' ) {
    // Separates class names with a single space, collates class names for body element.
    echo 'class="' . esc_attr( implode( ' ', get_body_class( $css_class ) ) ) . '"';
}
esc_attr()

Échappe les valeurs des attributs HTML.

get_body_class()

Récupère un tableau de classes CSS pour la balise HTML body.

Où est utilisée la fonction body_class() dans le CMS WordPress

Exemple

Voici une solution pour ajouter une classe de la balise body d'une page spécifique :
add_filter( 'body_class', 'custom_class' );

function custom_class( $classes ) {
    if ( is_page_template( 'page-example.php' ) ) {
        $classes[] = 'example';
    }
    return $classes;
}

Sources

Codex WordPress : body_class()

Autres fonctions dans le même fichier : wp-includes/post-template.php

Retour