Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

preload — pokyn k přednačítání médií

Atribut preload u prvků audio a video napovídá prohlížeči, kolik mediálních dat může být vhodné načíst předem. Hodnoty none, metadata a auto jsou pokyny, nikoli záruky.

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

Syntaxe

preload="none|metadata|auto"

preload je výčtový atribut prvků audio a video, nikoli booleovský atribut. Navrhuje strategii ukládání mediálního zdroje do vyrovnávací paměti.

none doporučuje vyhnout se načítání předem; nezakazuje načtení po zahájení přehrávání. metadata doporučuje načíst metadata, například dobu trvání a rozměry, případně také počáteční snímky; během přehrávání signalizuje omezenou šířku pásma. auto umožňuje stáhnout i celý zdroj, ale nevyžaduje to.

Prázdná hodnota znamená auto. Pokud atribut chybí nebo má neplatnou hodnotu, výchozí chování závisí na implementaci; standard doporučuje metadata.

Prohlížeč může pokyn ignorovat. autoplay jej může převážit a při zapnutých skriptech může loading="lazy" odložit jeho uplatnění. Vlastnost DOM preload odráží atribut a umožňuje změnit pokyn i během ukládání do vyrovnávací paměti nebo přehrávání.

Příklady

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

Výsledek

none
metadata
auto

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje