Attribut global HTMLAttributs globaux

onload

Exécute du code JavaScript lorsqu’une ressource a fini de se charger : toute la page, une image, un cadre, un script ou une feuille de style.

S’applique à
<body>, <img>, <iframe>, <script> avec l’attribut src, <link> et les autres éléments qui chargent une ressource
Sur cette page

Exemple

#
HTML
<p id="status">Chargement de la couverture…</p>
<img src="/collections/covers/kurs-html-css-od-podstaw.webp"
  alt="Couverture de la formation HTML et CSS pour débutants" width="300" height="200"
  onload="
    const size = this.naturalWidth + ' × ' + this.naturalHeight + ' px';
    document.getElementById('status').textContent = 'Couverture chargée : ' + size;
  ">
Aperçu

Une fois l’image téléchargée, this.naturalWidth et this.naturalHeight donnent les vraies dimensions du fichier, bien que sur la page l’image soit réduite à 300 × 200 pixels.

Définition et utilisation

#

L’attribut onload réagit à l’événement load, qui se produit lorsqu’un élément a fini de charger sa ressource. Sur une <img>, cela signifie l’image téléchargée, sur un <iframe> le document chargé dans le cadre, sur un <script src> le script téléchargé et exécuté, et sur un <link rel="stylesheet"> la feuille de style prête. Lorsque le chargement échoue, c’est l’événement error qui se produit à la place de load, que vous pouvez gérer avec l’attribut onerror.

Sur l’élément <body>, l’attribut concerne toute la page et fonctionne comme l’événement load de l’objet window. Il ne se produit que lorsque toutes les images, tous les styles, scripts et cadres sont chargés, et sur une connexion lente, cela peut prendre beaucoup de temps. Si un script n’a besoin que du HTML prêt, il vaut mieux utiliser l’attribut defer ou l’événement DOMContentLoaded, qui se produit plus tôt.

Dans le code de l’attribut, this désigne l’élément, par exemple une image chargée avec ses vraies dimensions naturalWidth et naturalHeight. L’événement load ne remonte pas dans l’arbre, vous définissez donc l’attribut directement sur l’élément qui charge la ressource. Dans des projets plus importants, ajoutez la gestion avec addEventListener("load", …).

Syntaxe

#
Syntaxe
<img src="…" alt="…" onload="code JavaScript">
<body onload="code JavaScript">…</body>

Quand l’événement load se produit

#
  • <body>

    Toute la page est chargée : HTML, images, styles, scripts et cadres. Identique à load sur l’objet window.
  • <img>

    L’image a été téléchargée. Avec loading="lazy", cela n’arrive que lorsque l’image s’approche de la partie visible de la page.
  • <iframe>

    Un document s’est chargé dans le cadre. L’événement se produit aussi à chaque navigation ultérieure à l’intérieur du cadre.
  • <script src>

    Un script externe a été téléchargé et exécuté.
  • <link rel="stylesheet">

    Une feuille de style a été téléchargée et traitée.

Plus d’exemples

#
Une image qui n’a pas pu être chargée
HTML
<p id="avatar-status">Chargement de l’avatar…</p>
<img src="data:," alt="Avatar de l’utilisateur" width="64" height="64"
  onload="document.getElementById('avatar-status').textContent = 'Avatar chargé'"
  onerror="document.getElementById('avatar-status').textContent = 'Impossible de charger l’avatar'">
Aperçu

L’adresse data:, est une image volontairement cassée, c’est donc error qui se produit à la place de load. Le navigateur affiche le texte alternatif, et onerror modifie le message.

Une page avec onload sur body et le DOMContentLoaded plus rapide
HTML
<body onload="document.getElementById('status').textContent = 'Tout est chargé, images comprises'">
  <p id="status">Chargement…</p>

  <script>
    document.addEventListener('DOMContentLoaded', () => {
      console.log('HTML prêt, les images peuvent encore se charger');
    });
  </script>
</body>

Le message de DOMContentLoaded apparaîtra plus tôt dans la console, car cet événement n’attend pas les images, les styles et les cadres. N’attendez load que si vous avez besoin de toutes les ressources, par exemple des dimensions des images.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Donnez width et height aux images. Le navigateur réserve alors de la place, la page ne saute pas après le chargement de l’image et il n’est pas nécessaire de corriger la mise en page dans onload.
  • Placez le code qui n’a besoin que des éléments de la page dans un script avec l’attribut defer, et non dans <body onload>. Il s’exécutera plus vite, sans attendre les images.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.