Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Naturalne wymiary obrazu i stan `complete`

Odczytaj naturalne wymiary obrazu w pikselach CSS i odróżnij zakończenie żądania od pomyślnego wczytania lub zdekodowania obrazu.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

img.naturalWidth  // number: natural width
img.naturalHeight // number: natural height
img.complete      // boolean: completion state, not success

naturalWidth i naturalHeight to właściwości tylko do odczytu obiektu HTMLImageElement. Zwracają odpowiednio naturalną szerokość i wysokość bieżącego obrazu jako liczby całkowite w pikselach CSS. Uwzględniają gęstość wybranego zasobu i orientację zapisaną w metadanych, więc nie muszą odpowiadać wymiarom zapisanym w pliku. Właściwości width i height renderowanego elementu opisują natomiast jego rozmiar na stronie.

Gdy wymiary bieżącego obrazu nie są jeszcze dostępne, obie właściwości zwracają 0. Wymiary mogą jednak być znane przed końcem pobierania, więc wartości dodatnie nie dowodzą wczytania ani zdekodowania całego obrazu. Przed obliczeniem proporcji img.naturalWidth / img.naturalHeight sprawdź, czy oba wymiary są dodatnie.

complete to właściwość logiczna tylko do odczytu. Zwraca true, gdy brakuje zarówno src, jak i srcset, albo gdy src jest pusty, a srcset nie występuje. Zwraca też true, gdy obraz z bieżącego żądania jest w pełni dostępny lub żądanie zakończyło się błędem, o ile żadne kolejne żądanie nie oczekuje na realizację. W pozostałych przypadkach zwraca false. To stan w chwili odczytu, a nie potwierdzenie sukcesu.

Ustaw procedury obsługi load i error przed przypisaniem src, aby rozróżnić powodzenie i błąd. Jeśli potrzebujesz zdekodowanego obrazu, po ustawieniu źródła użyj await img.decode() i obsłuż odrzucenie obietnicy. Są to interfejsy przeglądarkowej platformy WWW, a nie elementy rdzenia ECMAScript.

Przykłady

<!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>

Wynik

no source: true 0 0
load: true 24 16
error: true 0 0

Trzy wiersze pokazują brak źródła, poprawny SVG o wymiarach 24 × 16 i nieprawidłowy SVG. `complete` ma wartość `true` we wszystkich trzech przypadkach. Otwórz plik HTML w przeglądarce, w której wczytywanie obrazów jest włączone i która zezwala na obrazy z adresów `data:`, a następnie sprawdź konsolę deweloperską.

Powiązane lekcje

  • JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4

Źródła