Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLMediaElement : propriété preload

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La propriété preload de l'interface HTMLMediaElement est une chaîne de caractères qui fournit un indice au navigateur sur ce que l'auteur·ice pense être la meilleure expérience utilisateur.

Elle reflète l'attribut preload de l'élément HTML <audio> et de l'élément HTML <video>.

Valeurs

Une chaîne de caractères. Les valeurs possibles sont les suivantes :

none

Indique que le média ne doit pas être préchargé.

metadata

Indique que seules les métadonnées du média (par exemple, la durée) sont récupérées.

auto

Indique que le fichier média complet peut être téléchargé, même si l'utilisateur·ice n'est pas censé·e l'utiliser.

chaîne de caractères vide

Un synonyme de la valeur auto.

Exemples

html
<video
  id="el"
  controls
  src="https://exemple.com/media.mp4"
  poster="https://exemple.com/media.jpg"
  width="800"
  height="600"
  preload="metadata">
  Désolé, votre navigateur ne prend pas en charge les vidéos intégrées, mais ne
  vous inquiétez pas, vous pouvez
  <a href="https://exemple.com/media.mp4" download="media.mp4"
    >le télécharger</a
  >
  et le regarder avec votre lecteur vidéo préféré&nbsp;!
</video>
js
const el = document.getElementById("el");
console.log(el.preload); // Sortie : "metadata"

Spécifications

Spécification
HTML
# dom-media-preload

Compatibilité des navigateurs