Ajouter les attributs Defer et Async aux scripts WordPress

Defer Async scripts dans WordPress
WordPress Lecture 4 minutes • 23 février 2021

Les développeurs WordPress chargent souvent les scripts JS de façon incorrecte ou plutôt non optimale.
Bien souvent cette habitude a été prise car WordPress ne disposait pas jusqu'alors d'un moyen simple d'ajouter les nouveaux attributs Async et Defer.

Si vous ne savez pas comment bien charger les scripts JS dans WordPress, voici la bonne méthode avec wp_enqueue_script.

Depuis la version 4.1, un nouveau filtre "script_loader_tag" est supporté nativement par WordPress afin d'ajouter plus simplement les attributs async et defer sans prise de tête.

apply_filters('script_loader_tag', string $tag, string $handle, string $src);

Utilisation concrète : Async/Defer avec WordPress

Async sur un Script

function add_async_attribute($tag, $handle) {
  if ( 'nom-script-js' !== $handle )
    return $tag;
  return str_replace( ' src', ' async="async" src', $tag );
}

add_filter('script_loader_tag', 'add_async_attribute', 10, 2);

Defer sur un Script

Si vous souhaitez utiliser l'attribut "defer", remplacez simplement async="async" par defer="defer", comme dans l'exemple suivant :

function add_defer_attribute($tag, $handle) {
  if ( 'nom-script-js' !== $handle )
    return $tag;
  return str_replace( ' src', ' defer="defer" src', $tag );
}

add_filter('script_loader_tag', 'add_defer_attribute', 10, 2);

Ajoutez ce code à votre fichier functions.php de préférence.

Vous devrez recopier le "handle" qui est le premier paramètre de la méthode de chargement de votre script. Dans l'exemple suivant, il s'agit de 'nom-script-js'. C'est valable pour les méthodes wp_register_script et pour wp_enqueue_script.

wp_register_script('nom-script-js', $src, $deps, $ver, $in_footer);
//OU
wp_enqueue_script('nom-script-js', $src, $deps, $ver, $in_footer);

Quel attribut choisir ?

Le bon choix de balise à utiliser dépend entièrement de la nature du script lui-même, et il existe trois choix possibles.

  • Standard - C'est à dire sans l'attribut async ou defer. Cela constitue le comportement standard de votre navigateur.
  • Defer - Que l'on peut traduire par différé. Cela retarde l'exécution du script jusqu'à ce que l'analyse HTML soit terminée.
  • Async - Que l'on peut traduire par asynchrone. Le script s'exécute une fois qu'il est prêt et ne perturbe pas l'analyse HTML.

Comme toujours, vous devez tester toutes les modifications que vous apportez. Si vous constatez que des erreurs sont associées à l'un ou l'autre de ces attributs, ne les utilisez pas pour ce script particulier.

Utiliser Async et Defer sur plusieurs Scripts

Pour ajouter la balise async / defer à plusieurs scripts, nous devons créer un tableau (array), puis parcourir ce tableau et ajouter la balise async / defer à chaque script.

Ajoutez l'un de ces exemples de code à votre thème, dans le fichier "functions.php" et modifiez le tableau (array) pour inclure les scripts que vous avez choisi.

Plusieurs Scripts avec Async

function add_async_attribute($tag, $handle) {
  // ajouter les handles de mes scripts au array ci-dessous. Ici 3 scripts par exemple.
  $scripts_to_async = array('nom-script-1', 'nom-script-2', 'nom-script-3' );
  foreach($scripts_to_async as $async_script) {
    if ($async_script === $handle) {
      return str_replace(' src', ' async="async" src', $tag);
    }
  }
  return $tag;
}

add_filter('script_loader_tag', 'add_async_attribute', 10, 2);

Plusieurs Scripts avec Defer

function add_defer_attribute($tag, $handle) {
  // ajouter les handles de mes scripts au array ci-dessous. Ici 3 scripts par exemple.
  $scripts_to_defer = array('nom-script-1', 'nom-script-2', 'nom-script-3' );
  foreach($scripts_to_defer as $defer_script) {
    if ($defer_script === $handle) {
      return str_replace(' src', ' defer="defer" src', $tag);
    }
  }
  return $tag;
}

add_filter('script_loader_tag', 'add_defer_attribute', 10, 2);

La solution de l'Extension WordPress

Si vous n'êtes pas à l'aise avec les manipulations précédentes, il existe une Extension WordPress qui gère cela très bien nommée Async Javascript.


Avis clients

Tibow Webdesign

Tous les avis

Charlotte Séjourné - Wildust.com 10 septembre 2021

Google Avis
Thibaut est une personne super disponible et très pro.
Chaque projet confié a été géré avec beaucoup de professionnalisme et pas mal de pédagogie pour les néophytes comme moi! C'est super appréciable.

Maud Rochais Photographe 26 août 2021

Google Avis
Thibault a répondu a mes attentes ! Il est à l'écoute et a su cerner rapidement ce que je voulais en terme de site. Le résultat est parfait ! Merci à toi !

Loïc Perrière 6 janvier 2021

Ingénieur de recherches - CNRS / Recommandation LinkedIn
Lors du démarrage de projet de refonte du site web de mon laboratoire, j’ai contacté Thibaut pour obtenir des renseignements sur un travail qu’il avait déjà réalisé auprès d’un autre client.
Sa franchise et la clarté de ses réponses m’ont finalement convaincu de lui confier la conception de deux sites internet. Nos échanges ont toujours été constructifs, et Thibaut a fait preuve, tout au long du développement, de dynamisme et de réactivité, et a également réalisé de nombreuses propositions qui ont majoritairement été retenues. Enfin, il a su faire preuve d’écoute pour intégrer les problématiques et les demandes spécifiques d’un site internet de laboratoire public pour créer un site à notre image.
La collaboration a été fructueuse et constructive, et ça a été un réel plaisir de travailler avec lui.

Clara Deleuze 21 décembre 2020

Principal Chief Executive Officer chez On Divorce / Recommandation LinkedIn
Je collabore avec Thibault depuis plus de 10 ans.
Plus qu'un dev Full Stack c'est un profil au sens logique qui sera vous accompagner plus globalement sur votre projet IT.
Je lui ai confié plus de 5 projets et vous le recommande vivement : réactivité, sens du détail, proactivité...Il sait s'adapter "au métier" pour lequel il intervient et pas uniquement à la fonctionnalité !

Ackeret Mano 22 février 2019

Google Avis
Nous avons fait appel à Thibaut pour développer le site internet de notre entreprise Ackeret Mano, l'année dernière et nous avons été très satisfaits.

C'est un garçon à l'écoute, disponible et sérieux.
Nous vous le recommandons les yeux fermés.

Frédéric Meyrou 19 octobre 2018

Google Avis
Thibaut a repris en main le site du projet de coopérative supercoop.fr et il a parfaitement compris le style et l'énergie qu'il fallait donner au projet donc le site est un vecteur important de communication. Vous pouvez lui faire confiance!

Patrick Chatenet 24 juin 2018

Google Avis
Nous avons travaillé avec Thibaut Soufflet pour finaliser un site Wordpress fait par une autre personne qui était partie vers d'autres horizons professionnels. Il s'est parfaitement adapté, nous a bien écouté et a proposé de très bonnes solutions en termes d'ergonomie et de facilité d'utilisation pour nos clients. A eu à régler des problèmes techniques et a pris le temps de nous trouver les meilleures solutions. Je le conseille vivement!

Anaelle Sorignet 21 mai 2018

Google Avis
Tibow est super efficace, réactif et à l'écoute ! Il nous a concocté un super site. Je recommande vivement de faire appel à lui.

ISOPROM 15 avril 2018

Google Avis
donne de tres bons conseils

Alexis Supiot 5 septembre 2017

Google Avis
Plusieurs projets avec Thibaut et à chaque fois de bons échanges, une facilité dans la compréhension de nos attentes et pour l'ensemble des résultats très satisfaisants sur le rendu. Je recommande vivement et sais que nous aurons d'autres projets ensemble.
Lire plus