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.