Dépendances de scripts

Définition : Les dépendances de scripts indiquent à WordPress qu’une ressource JavaScript nécessite d’autres ressources identifiées par leur handle. Cette déclaration aide le Core à organiser l’ordre et les stratégies de chargement.

Comprendre et utiliser

À quoi sert ce terme ?

Elles évitent qu’un script utilise une bibliothèque avant qu’elle soit disponible. Une extension maintenable déclare explicitement ses dépendances plutôt que de compter sur l’ordre accidentel des balises HTML.

Fonctionnement technique

Pour les scripts classiques, les dépendances sont un tableau de handles passés à wp_enqueue_script() ou wp_register_script(). Les modules ES emploient une déclaration de dépendances différente.

Dans quels contextes l’utiliser ?

À renseigner dès qu’un fichier dépend de wp-i18n, wp-element ou d’un autre handle. Après compilation de JavaScript, utiliser les informations de dépendances produites par l’outil de build lorsque disponibles.

Cas concret : ATOOLPHA

Un composant ATOOLPHA de panneau WordPress utilise des fonctions de traduction JavaScript fournies par wp-i18n.

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( 'enqueue_block_editor_assets', function () {
    wp_enqueue_script(
        'atoolpha-editor-panel',
        plugin_dir_url( __FILE__ ) . 'build/panel.js',
        array( 'wp-i18n', 'wp-element' ),
        '1.0.0', true
    );
} );

Décryptage de l’exemple

La déclaration associe panel.js à deux handles officiels. Le build doit réellement utiliser ces dépendances ; la liste ne remplace pas l’import ou le code produit.

Résultat attendu

WordPress peut charger les bibliothèques attendues avant le panneau, dans la limite des stratégies admises par le gestionnaire de scripts.

Exercice pratique et vérification

Créer un composant qui appelle wp.i18n.__ et comparer son comportement avec et sans le handle wp-i18n déclaré.

Précautions et limites

Une dépendance oubliée ou mal nommée conduit à une API undefined. Éviter de recopier une liste générique sans confronter les imports réels.

À ne pas confondre

Un handle de script classique n’est pas l’identifiant d’un module ES ; le format de dépendances de wp_enqueue_script_module() diffère.

Diagnostic avancé

En cas d’échec, inspecter les métadonnées du build, l’ordre des fichiers et les erreurs de console avant d’ajouter un script CDN.

Choix d’architecture et déploiement

Documenter les dépendances est aussi une mesure de maintenance : le build et la registration PHP doivent rester synchronisés. Lorsqu’une bibliothèque disparaît ou change de version, la panne doit être décelable par le contrôle des handles et des erreurs JavaScript.