Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

preload — indication de préchargement des médias

L’attribut preload des éléments audio et video indique au navigateur quelle quantité de données multimédias pourrait être utile à récupérer à l’avance. Les valeurs none, metadata et auto sont des indications, pas des garanties.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

preload="none|metadata|auto"

preload est un attribut à valeur énumérée des éléments audio et video, et non un attribut booléen. Il suggère une stratégie de mise en mémoire tampon pour la ressource multimédia.

none suggère d’éviter tout téléchargement à l’avance ; il n’interdit pas le téléchargement lorsque la lecture commence. metadata suggère de récupérer les métadonnées, comme la durée et les dimensions, éventuellement aussi les premières images ; pendant la lecture, il signale une bande passante limitée. auto autorise le téléchargement de la ressource entière, mais ne l’impose pas.

Une valeur vide signifie auto. Si l’attribut est absent ou sa valeur invalide, le comportement par défaut dépend de l’implémentation ; le standard suggère metadata.

Le navigateur peut ignorer cette indication. autoplay peut la remplacer et, lorsque les scripts sont activés, loading="lazy" peut retarder sa mise en œuvre. La propriété DOM preload reflète l’attribut et permet de modifier l’indication même pendant la mise en mémoire tampon ou la lecture.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>preload</title>
<audio id="media" preload="none"></audio>
<pre id="result"></pre>
<script>
  const media = document.getElementById('media');
  const values = [media.preload];
  media.preload = 'metadata';
  values.push(media.preload);
  media.preload = 'auto';
  values.push(media.preload);
  document.getElementById('result').textContent = values.join('\n');
</script>

Résultat

none
metadata
auto

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources