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

Affiche les classes CSS de la balise HTML body.

Description

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

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 : ''

Retourne

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

Structure de la fonction body_class()

Définie dans le fichier wp-includes/post-template.php à la ligne 593 :

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 ) ) ) . '"';
}

Fonctions utilisées par body_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ù trouver 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