База знанияИзпитен център
BGБългарски
Избери език13

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 success

naturalWidth и 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

Източници