WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

preload — Hinweis zum Vorladen von Medien

Das preload-Attribut von audio- und video-Elementen gibt dem Browser einen Hinweis, wie viele Mediendaten es sich lohnen könnte, im Voraus abzurufen. Die Werte none, metadata und auto sind Hinweise, keine Garantien.

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

Syntax

preload="none|metadata|auto"

preload ist ein enumeriertes Attribut für audio und video, kein boolesches Attribut. Es schlägt eine Pufferstrategie für die Medienressource vor.

none empfiehlt, das Vorabladen zu vermeiden; sobald die Wiedergabe beginnt, verbietet es das Laden jedoch nicht. metadata empfiehlt, Metadaten wie Dauer und Abmessungen abzurufen, möglicherweise auch erste Einzelbilder; während der Wiedergabe signalisiert es eine knappe Bandbreite. auto erlaubt sogar das Herunterladen der gesamten Ressource, verlangt es aber nicht.

Ein leerer Wert bedeutet auto. Wenn das Attribut fehlt oder einen ungültigen Wert hat, ist das Standardverhalten implementierungsabhängig; der Standard empfiehlt metadata.

Der Browser kann den Hinweis ignorieren. autoplay kann ihn außer Kraft setzen, und bei aktivierten Skripten kann loading="lazy" die Umsetzung des Hinweises verzögern. Die DOM-Eigenschaft preload spiegelt das Attribut wider und ermöglicht es, den Hinweis auch während des Pufferns oder der Wiedergabe zu ändern.

Beispiele

<!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>

Ergebnis

none
metadata
auto

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen