CKTIS / JavaScript
Natuurlijke afbeeldingsafmetingen en de status `complete`
Lees de natuurlijke afmetingen van een afbeelding in CSS-pixels en onderscheid een afgeronde aanvraag van geslaagd laden of decoderen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
img.naturalWidth // number: natural width
img.naturalHeight // number: natural height
img.complete // boolean: completion state, not successnaturalWidth en naturalHeight zijn alleen-lezen eigenschappen van HTMLImageElement. Ze geven de natuurlijke breedte en hoogte van de huidige afbeelding als gehele getallen in CSS-pixels. Ze houden rekening met de pixeldichtheid van de gekozen bron en de oriëntatie uit de metadata, zodat ze kunnen afwijken van de afmetingen in het bestand. Bij een gerenderd element geven width en height juist de grootte op de pagina aan.
Zolang de afmetingen van de huidige afbeelding niet beschikbaar zijn, geven beide eigenschappen 0 terug. De afmetingen kunnen al bekend zijn voordat de download klaar is. Positieve waarden bewijzen dus niet dat de hele afbeelding geladen of gedecodeerd is. Controleer of beide afmetingen positief zijn voordat je img.naturalWidth / img.naturalHeight berekent.
complete is een alleen-lezen booleaanse eigenschap. De waarde is true als src en srcset beide ontbreken of als src leeg is en srcset ontbreekt. De waarde is ook true als de afbeelding van de huidige aanvraag volledig beschikbaar is of de aanvraag is mislukt, zolang er geen vervangende aanvraag in behandeling is. Anders is de waarde false. Dit is een momentopname, geen bewijs dat het laden is gelukt.
Registreer de handlers voor load en error voordat je src instelt om succes van fouten te onderscheiden. Heb je een gedecodeerde afbeelding nodig, gebruik dan na het instellen van de bron await img.decode() en handel een afwijzing van de promise af. Dit zijn web-API’s van de browser, geen onderdeel van de ECMAScript-kern.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Natural image dimensions and completion</title>
</head>
<body>
<script>
(async () => {
function report(label, img) {
console.log(`${label}: ${img.complete} ${img.naturalWidth} ${img.naturalHeight}`);
}
async function inspect(src) {
const img = new Image();
const eventType = await new Promise((resolve) => {
img.onload = img.onerror = (event) => resolve(event.type);
img.src = src;
});
report(eventType, img);
}
const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="16"><rect width="24" height="16"/></svg>';
report('no source', new Image());
await inspect('data:image/svg+xml,' + encodeURIComponent(svg));
await inspect('data:image/svg+xml,not-an-svg');
})();
</script>
</body>
</html>Resultaat
no source: true 0 0 load: true 24 16 error: true 0 0
De drie regels tonen een afbeelding zonder bron, een geldige SVG van 24 × 16 en een ongeldige SVG. In alle drie gevallen is `complete` gelijk aan `true`. Open het HTML-bestand in een browser die `data:`-afbeeldingen toestaat en waarin het laden van afbeeldingen is ingeschakeld. Bekijk daarna de uitvoer in de ontwikkelaarsconsole.
Gerelateerde lessen
- JavaScript · Les 33 · Gevorderd · Versie: 4