CKTIS / JavaScript
Dimensioni naturali di un’immagine e stato `complete`
Leggi le dimensioni naturali di un’immagine in pixel CSS e distingui la conclusione di una richiesta dal caricamento o dalla decodifica riusciti.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
img.naturalWidth // number: natural width
img.naturalHeight // number: natural height
img.complete // boolean: completion state, not successnaturalWidth e naturalHeight sono proprietà di sola lettura di HTMLImageElement. Restituiscono la larghezza e l’altezza naturali dell’immagine corrente come numeri interi in pixel CSS. Tengono conto della densità di pixel della risorsa selezionata e dell’orientamento indicato nei metadati, quindi possono differire dalle dimensioni memorizzate nel file. Per un elemento renderizzato, width e height descrivono invece le sue dimensioni sulla pagina.
Se le dimensioni dell’immagine corrente non sono ancora disponibili, entrambe le proprietà restituiscono 0. Le dimensioni possono essere note prima della fine del download: valori positivi non dimostrano che l’intera immagine sia stata caricata o decodificata. Verifica che entrambe le dimensioni siano positive prima di calcolare img.naturalWidth / img.naturalHeight.
complete è una proprietà booleana di sola lettura. Vale true se mancano sia src sia srcset, oppure se src è vuoto e srcset manca. Vale true anche quando l’immagine della richiesta corrente è completamente disponibile o la richiesta è fallita, purché non ci sia una richiesta sostitutiva in sospeso. Negli altri casi vale false. Indica lo stato al momento della lettura, non il successo del caricamento.
Registra i gestori di load e error prima di impostare src per distinguere successo ed errore. Se ti serve l’immagine decodificata, usa await img.decode() dopo aver impostato la sorgente e gestisci il rifiuto della promessa. Queste API Web fanno parte della piattaforma del browser, non del nucleo di ECMAScript.
Esempi
<!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>Risultato
no source: true 0 0 load: true 24 16 error: true 0 0
Le tre righe mostrano un’immagine senza sorgente, un SVG valido di 24 × 16 e un SVG non valido. In tutti e tre i casi `complete` vale `true`. Apri il file HTML in un browser che consenta le immagini `data:` e in cui il caricamento delle immagini sia abilitato, quindi controlla la console per sviluppatori.
Lezioni correlate
- JavaScript · Lezione 33 · Avanzato · Versione: 4