body_class()

Définition : body_class() produit une liste de classes CSS contextuelles pour l’élément body d’un thème WordPress classique. Elle décrit notamment le type de vue ou certaines caractéristiques de la requête.

Terminologie

Nom technique : body_class()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle facilite l’écriture de styles ciblés selon le contexte d’une page, d’un article ou d’une archive, sans ajouter des conditions PHP complexes autour de chaque règle CSS.

Fonctionnement détaillé

WordPress construit les classes de contexte et applique des filtres permettant aux extensions et thèmes d’en ajouter d’autres. La fonction affiche l’attribut class destiné à être placé dans l’ouverture du body.

Quand l’utiliser : contexte et choix techniques

L’utiliser dans body d’un thème classique lorsque le template construit lui-même le document HTML. Le thème à blocs suit souvent un chemin de rendu différent pour ses balises de structure.

Situation professionnelle réaliste

Une archive de fiches doit recevoir une présentation particulière tandis que les pages ordinaires conservent leurs espacements standards.

Exemple pratique — HTML / balisage de blocs

Exemple pédagogique : adapter le nom du thème, les fichiers et les conditions à un environnement de développement. Il ne constitue pas une preuve d’exécution sur ATOOLPHA.

<!-- Dans le fichier header.php d’un thème classique. -->
<body <?php body_class( 'atoolpha-site' ); ?>>
<!-- Dans une feuille CSS chargée par le thème : -->
<!-- .archive.atoolpha-site .liste-fiches { gap: 1.5rem; } -->

Décryptage de l’exemple, étape par étape

body_class() insère les classes automatiques de WordPress auxquelles s’ajoute atoolpha-site. Une feuille CSS peut ensuite viser les combinaisons utiles sans modifier les données de la requête.

Résultat observable

La balise body obtient plusieurs classes selon le contexte ; sur une archive, un sélecteur CSS peut appliquer une grille différente.

Exercice de vérification pratique

Afficher la source d’une archive et d’une page ordinaire dans un thème classique de test. Comparer les classes body puis appliquer un CSS ciblant uniquement l’archive.

Pièges, limites et sécurité

La sortie doit être placée correctement dans la balise body, et non exécutée comme un simple texte. Ne pas coder le CSS selon des classes non garanties sans vérifier leur stabilité.

Différences avec les notions voisines

body_class() décrit le contexte de la page dans body ; post_class() ajoute des classes sur un élément représentant un article particulier.

Diagnostic avancé et cas de maintenance

Cas avancé : une règle CSS destinée à une archive touche également des pages non souhaitées. Inspecter les classes réellement produites selon le type de requête et choisir un sélecteur suffisamment précis. Les classes de contexte sont utiles pour le style, mais ne remplacent jamais une décision d’accès côté serveur.