wp_enqueue_script()

Définition : wp_enqueue_script() place un fichier JavaScript dans le gestionnaire de ressources WordPress. Elle organise son chargement, ses dépendances, sa version et, selon les paramètres, certaines stratégies ou positions d’exécution.

Terminologie

Nom technique : wp_enqueue_script()

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Elle évite les références dispersées à des scripts et facilite la compatibilité entre le thème, les plugins et les dépendances enregistrées dans WordPress.

Fonctionnement détaillé

Le handle relie la ressource aux autres scripts. Les versions récentes acceptent un tableau args avec notamment in_footer et strategy, sous réserve des contraintes de dépendances et des stratégies admissibles.

Quand l’utiliser : contexte et choix techniques

L’utiliser pour charger une interaction propre au thème lorsque le fichier JavaScript est réellement nécessaire. Pour les comportements natifs des blocs, vérifier d’abord si le Core possède déjà la capacité recherchée.

Situation professionnelle réaliste

Un thème ajoute une amélioration de navigation au clavier dans un fichier JavaScript séparé sans injecter du code arbitraire dans le contenu des articles.

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_enqueue_script(
        'atoolpha-navigation',
        get_theme_file_uri( 'assets/js/navigation.js' ),
        array(), '1.0.0',
        array( 'in_footer' => true, 'strategy' => 'defer' )
    );
} );

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

Le handle est unique, l’URL pointe vers une ressource du thème, le tableau args suggère un placement en pied de page et une stratégie defer. WordPress détermine la stratégie effective selon les dépendances.

Résultat observable

Si le fichier existe, WordPress génère son chargement lors du rendu des pages publiques. Aucun code JavaScript n’est placé dans les fiches du glossaire par cette déclaration d’exemple.

Exercice de vérification pratique

En environnement de test, observer l’ordre de chargement dans le HTML et le réseau. Ajouter une dépendance factice puis vérifier comment WordPress ajuste la stratégie finale.

Pièges, limites et sécurité

Les stratégies defer et async ne sont pas interchangeables. Contrôler compatibilité de version, dépendances, gestion des erreurs et accessibilité des interactions.

Différences avec les notions voisines

wp_enqueue_script() ajoute à la file, tandis que wp_register_script() enregistre une ressource pour un usage ultérieur.

Diagnostic avancé et cas de maintenance

Cas avancé : un module JavaScript fonctionne seul puis échoue lorsqu’une dépendance est différée. Vérifier l’ordre de chargement et la stratégie finale calculée par WordPress : defer et async ne produisent pas les mêmes garanties. Éviter d’ajouter des scripts au hasard pour masquer un problème de dépendances.