CKTIS / HTML
preload — wstępne ładowanie multimediów
Atrybut preload elementów audio i video podpowiada przeglądarce, ile danych warto pobrać z wyprzedzeniem. Wartości none, metadata i auto są wskazówkami, a nie gwarancjami.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
preload="none|metadata|auto"preload jest atrybutem wyliczeniowym elementów audio i video, nie atrybutem logicznym. Określa sugerowaną strategię buforowania zasobu multimedialnego.
none sugeruje unikanie wstępnego pobierania; nie zabrania pobierania po rozpoczęciu odtwarzania. metadata sugeruje pobranie metadanych, np. czasu trwania i wymiarów, ewentualnie także pierwszych klatek; podczas odtwarzania wskazuje na ograniczone pasmo. auto dopuszcza nawet pobranie całego zasobu, ale tego nie nakazuje.
Pusta wartość oznacza auto. Przy braku atrybutu lub nieprawidłowej wartości zachowanie domyślne zależy od implementacji; standard sugeruje metadata.
Przeglądarka może zignorować wskazówkę. autoplay może ją przeważyć, a przy włączonych skryptach loading="lazy" może odroczyć jej realizację. Właściwość DOM preload odzwierciedla atrybut i pozwala zmieniać wskazówkę także podczas buforowania lub odtwarzania.
Przykłady
<!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>Wynik
none metadata auto
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.