CKTIS / JavaScript
Естествени размери на изображението и състояние `complete`
Прочети естествените размери на изображението в CSS пиксели и разграничи приключването на заявката от успешно зареждане или декодиране.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
img.naturalWidth // number: natural width
img.naturalHeight // number: natural height
img.complete // boolean: completion state, not successnaturalWidth и naturalHeight са свойства само за четене на HTMLImageElement. Те връщат естествената ширина и височина на текущото изображение като цели числа в CSS пиксели. Отчитат плътността на пикселите на избрания ресурс и ориентацията в метаданните, затова може да се различават от размерите, записани във файла. За елемент, който се визуализира, width и height описват размера му на страницата.
Докато размерите на текущото изображение не са налични, и двете свойства връщат 0. Размерите може да станат известни преди края на изтеглянето, така че положителните стойности не доказват, че цялото изображение е заредено или декодирано. Преди да изчислиш img.naturalWidth / img.naturalHeight, провери дали и двата размера са положителни.
complete е булево свойство само за четене. То връща true, ако липсват и src, и srcset или ако src е празен, а srcset липсва. Връща true и ако изображението от текущата заявка е напълно налично или заявката е неуспешна, при условие че няма чакаща заместваща заявка. В останалите случаи връща false. Това е състоянието в момента на прочитане, а не потвърждение за успешно зареждане.
Регистрирай обработчиците на load и error, преди да зададеш src, за да различиш успех от грешка. Ако ти трябва декодирано изображение, използвай await img.decode() след задаване на източника и обработи отхвърлянето на промиса. Това са уеб интерфейси на браузъра, а не част от ядрото на ECMAScript.
Примери
<!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>Резултат
no source: true 0 0 load: true 24 16 error: true 0 0
Трите реда показват изображение без източник, валиден SVG с размери 24 × 16 и невалиден SVG. И в трите случая `complete` е `true`. Отвори HTML файла в браузър, който допуска изображения с адреси `data:` и в който зареждането на изображения е включено, след което провери изхода в конзолата за разработчици.
Свързани уроци
- JavaScript · Урок 33 · Напреднало · Версия: 4