Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

decoding: preferencja dekodowania obrazu

Oddziel gotowość obrazu od pobierania, leniwego ładowania i momentu wyświetlenia.

Wersja: HTML Living Standard

Składnia

<img decoding="async" src="/picture.svg" alt="Blue square">

Atrybut obrazu decoding przyjmuje sync, async albo auto. Sugeruje koordynację dekodowania z prezentacją pozostałej treści lub jego niezależne zakończenie; brak i błędna wartość oznaczają stan automatyczny. To wskazówka, nie obietnica określonej klatki lub wątku.

Nie zastępuje leniwego ładowania, priorytetu pobierania ani wymiarów obrazu. Aby jawnie poczekać na dekodowanie przed wstawieniem obrazu, użyj decode() i obsłuż odrzucenie przy błędzie ładowania lub dekodowania. Sam zapis atrybutu nie informuje kodu aplikacji o gotowości pikseli.

Przykład pobiera lokalny obraz, czeka na udane dekodowanie i dopiero dodaje go do dokumentu. Test sprawdza naturalne wymiary i rzeczywiste wstawienie. Nie wyprowadza z wartości atrybutu gwarancji asynchronicznego harmonogramu wyświetlania.

Przykłady

<!doctype html><meta charset="utf-8"><div id="mount"></div><output id="result"></output><script>
const image = new Image(); image.alt = 'Blue square'; image.decoding = 'async'; image.src = '/picture.svg';
image.decode().then(() => {
  document.querySelector('#mount').append(image);
  document.querySelector('#result').textContent = 'decoded=' + (image.naturalWidth === 20) + '; mounted=' + image.isConnected;
});
</script>

Wynik

decoded=true; mounted=true

Wynik potwierdza dekodowanie i wstawienie tego obrazu, nie uniwersalną kolejność planowania.

Źródła