CKTIS / HTML
decoding: een voorkeur voor afbeeldingsdecodering
Scheid pixelgereedheid van downloaden, uitgesteld laden en tekenen.
Versie: HTML Living Standard
Syntax
<img decoding="async" src="/picture.svg" alt="Blue square">Het afbeeldingsattribuut decoding accepteert sync, async of auto. Het stelt voor decodering met andere weergave af te stemmen of apart te voltooien; ontbrekende en ongeldige waarden betekenen automatisch. Het is een hint, geen belofte over een bepaald frame of thread.
Het vervangt geen lui laden, ophaalprioriteit of afbeeldingsafmetingen. Gebruik decode() om vóór invoegen expliciet op decodering te wachten en handel afwijzing bij laad- of decodeerfouten af. Alleen het attribuut instellen meldt de toepassing niet dat pixels gereed zijn.
Het testgeval vraagt een lokale afbeelding op, wacht op geslaagde decodering en voegt haar daarna toe. De test controleert natuurlijke afmetingen en echte invoeging. Uit de attribuutwaarde wordt geen gegarandeerd asynchroon tekenschema afgeleid.
Voorbeelden
<!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>Resultaat
decoded=true; mounted=true
Het resultaat bewijst decodering en invoeging van deze afbeelding, geen universele planning.