wp_deregister_style()

Définition : wp_deregister_style() retire une définition de feuille CSS du registre WordPress. Un handle supprimé ne peut plus être mis en file comme auparavant sans nouvel enregistrement approprié.

Comprendre et utiliser

À quoi sert ce terme ?

Elle sert essentiellement à corriger ou remplacer une ressource identifiée dans un environnement maîtrisé. Un changement non ciblé peut désorganiser l’apparence d’extensions ou de blocs.

Fonctionnement technique

La fonction agit sur le registre et non sur le fichier source. La suppression peut également affecter les ressources qui déclarent une dépendance au handle concerné.

Dans quels contextes l’utiliser ?

À utiliser exceptionnellement pour une feuille que le plugin possède. Pour une page où elle est seulement inutile, un dequeue ciblé reste généralement moins intrusif.

Cas concret : ATOOLPHA

ATOOLPHA souhaite remplacer en test local la feuille CSS d’un composant dont l’ancien fichier a été renommé.

Exemple de code commenté

Extrait PHP destiné à un plugin ou à un template WordPress, dans le contexte indiqué ; pas au contenu HTML de l’article.

<?php
add_action( 'wp_enqueue_scripts', function () {
    wp_deregister_style( 'atoolpha-test-card' );
    wp_register_style(
        'atoolpha-test-card',
        plugin_dir_url( __FILE__ ) . 'assets/card-v2.css',
        array(), '2.0.0'
    );
    wp_enqueue_style( 'atoolpha-test-card' );
}, 20 );

Décryptage de l’exemple

Le handle propriétaire est reconstruit avec une URL nouvelle ; les appels suivants peuvent alors l’enqueue. Le fichier assets/card-v2.css doit être fourni par l’extension.

Résultat attendu

La page charge la nouvelle feuille si l’enregistrement et l’enqueue se produisent dans l’ordre attendu.

Exercice pratique et vérification

Comparer le réseau et l’onglet Styles du navigateur entre deux feuilles expérimentales. Vérifier que seule la version souhaitée se charge.

Précautions et limites

Ne pas retirer de manière globale un CSS de plugin tiers sans évaluer les composants dépendants, notamment les styles des blocs natifs.

À ne pas confondre

wp_deregister_style() retire la définition ; wp_dequeue_style() annule seulement la demande de chargement courante.

Diagnostic avancé

Si des règles persistent, inspecter le cache navigateur, les CSS intégrés et les autres styles dont les sélecteurs restent actifs.

Choix d’architecture et déploiement

La gestion de styles par handle constitue une couche différente de la cascade CSS. Une feuille correctement remplacée peut néanmoins perdre face à une règle plus spécifique ; contrôler la présence du bon fichier et le style calculé sont deux étapes distinctes.