wp_style_is()

Définition : wp_style_is() détermine l’état d’une feuille CSS enregistrée dans le gestionnaire de styles WordPress. Elle aide à diagnostiquer le chargement d’un handle sans analyser le HTML manuellement.

Comprendre et utiliser

À quoi sert ce terme ?

Cette fonction facilite les vérifications de compatibilité d’un plugin avec un thème. Avant de dépendre d’un style donné, on peut constater sa présence au registre et à la file de chargement.

Fonctionnement technique

Elle accepte un nom de handle et un état ciblé, tel que registered ou enqueued. Le résultat reflète le fonctionnement PHP et ne garantit pas que la feuille soit réellement interprétée par le navigateur.

Dans quels contextes l’utiliser ?

À employer pour des contrôles de ressources lors d’un développement ou d’un audit. Éviter de brancher toute la logique d’interface sur une feuille facultative.

Cas concret : ATOOLPHA

ATOOLPHA veut savoir si la feuille du lexique est prête au chargement avant d’examiner un défaut visuel.

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 () {
    $handle = 'atoolpha-lexicon';
    if ( wp_style_is( $handle, 'enqueued' ) ) {
        error_log( 'CSS du lexique dans la file.' );
    }
}, 50 );

Décryptage de l’exemple

L’appel cherche l’état enqueued d’un handle appartenant à l’application. Il s’agit d’un indicateur de chargement côté WordPress, pas d’une mesure de poids CSS.

Résultat attendu

Le journal confirme l’état interne si la feuille est déjà ajoutée à la file au moment du callback.

Exercice pratique et vérification

Tester un handle enregistré puis mis en file et comparer les états. Changer un sélecteur CSS et observer que l’état du handle ne renseigne pas l’effet visuel.

Précautions et limites

Un style enqueued peut encore échouer à être chargé ou être supplanté par des règles CSS plus spécifiques. Ne pas conclure à l’absence de problème sur la seule base du booléen.

À ne pas confondre

wp_style_is() s’applique au registre des styles ; wp_script_is() aux scripts ; aucun n’inspecte le rendu CSS calculé.

Diagnostic avancé

En cas de style absent malgré enqueued, vérifier URL, statut réseau, minification et ordre de cascade CSS.

Choix d’architecture et déploiement

Un CSS chargé n’est pas forcément un CSS appliqué : ordre des feuilles, média queries, styles inline et propriétés héritées interviennent. Les outils de développement du navigateur constituent donc un complément nécessaire à l’état renvoyé par le registre WordPress.