wp_register_style()

Définition : wp_register_style() enregistre les caractéristiques d’une feuille CSS dans WordPress sans nécessairement la charger immédiatement. Elle prépare un handle réutilisable pour une mise en file ultérieure.

Terminologie

Nom technique : wp_register_style()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle permet de séparer la déclaration d’une bibliothèque de styles de la décision effective de la charger, utile quand plusieurs composants peuvent en avoir besoin.

Fonctionnement détaillé

WordPress mémorise l’identifiant, l’URL, les dépendances, la version et le média. Le gestionnaire charge la ressource uniquement lorsqu’elle est placée dans la file, notamment via wp_enqueue_style().

Quand l’utiliser : contexte et choix techniques

L’utiliser pour une feuille partagée entre plusieurs vues lorsque son chargement doit être conditionnel. Pour un style toujours requis, un appel direct à wp_enqueue_style() est souvent plus simple.

Situation professionnelle réaliste

Un thème possède un style optionnel pour ses tableaux comparatifs, déclaré une seule fois puis chargé sur les pages qui affichent ces tableaux.

Exemple pratique — PHP commenté

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.

<?php
add_action( 'wp_enqueue_scripts', function () {
    wp_register_style(
        'atoolpha-tableaux',
        get_theme_file_uri( 'assets/css/tableaux.css' ),
        array(), '1.0.0'
    );
    // Exemple conditionnel : sur la page de modèle spécifique.
    if ( is_page_template( 'page-comparatif.php' ) ) {
        wp_enqueue_style( 'atoolpha-tableaux' );
    }
} );

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

Le premier appel enregistre la ressource et ses paramètres. Le test is_page_template() décide ensuite si le handle doit être ajouté à la file. Aucun second chemin CSS n’est répété.

Résultat observable

La feuille est déclarée sur chaque page publique, mais chargée uniquement dans le contexte de la condition donnée, sous réserve du template réellement utilisé.

Exercice de vérification pratique

Créer deux pages de test, l’une utilisant page-comparatif.php et l’autre un modèle ordinaire. Examiner le réseau pour confirmer le chargement conditionnel.

Pièges, limites et sécurité

Une feuille enregistrée n’est pas automatiquement chargée. Les noms de templates et le mécanisme de sélection varient entre thèmes classiques et à blocs.

Différences avec les notions voisines

wp_register_style() enregistre un handle ; wp_enqueue_style() le met effectivement en file et demande son chargement.

Diagnostic avancé et cas de maintenance

Cas avancé : le réseau du navigateur ne montre pas une feuille pourtant déclarée dans functions.php. L’enregistrement est uniquement préparatoire. Vérifier si un callback demande wp_enqueue_style() au moment approprié, si la condition correspond à la requête et si le handle est écrit exactement de la même manière.