CKTIS / JavaScript
Obrazy w JavaScript: `src`, `alt`, `load` i `error`
Ustaw adres obrazu i tekst alternatywny, a następnie obsłuż udane lub nieudane ładowanie za pomocą zdarzeń elementu obrazu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const img = new Image();
img.alt = text;
img.addEventListener("load", onLoad);
img.addEventListener("error", onError);
// To use handler properties, replace the two listener registrations above with:
// img.onload = onLoad;
// img.onerror = onError;
img.src = url;new Image() tworzy element img typu HTMLImageElement, początkowo poza drzewem dokumentu. To API platformy WWW, a nie część ECMAScript 2024. Kod wymaga środowiska udostępniającego to API.
img.src to właściwość tekstowa odzwierciedlająca atrybut src. Jej ustawienie uruchamia asynchroniczne przetwarzanie źródła obrazu, nawet jeśli element nie został wstawiony do dokumentu. Odczyt img.src zwraca poprawny względny URL po rozwiązaniu go względem bazowego URL dokumentu. img.getAttribute("src") zwraca zapisaną wartość atrybutu. Przy wyborze responsywnym użyj img.currentSrc, aby sprawdzić URL wybrany przez przeglądarkę.
img.alt odzwierciedla atrybut alt. Podaj tekst zastępujący znaczenie lub funkcję obrazu w danym kontekście, gdy odbiorca nie może go zobaczyć. Dla obrazu wyłącznie dekoracyjnego ustaw alt = "" zamiast pomijać atrybut. alt nie jest adresem obrazu zapasowego.
load oznacza udane załadowanie obrazu; error sygnalizuje, że wybranego zasobu nie można załadować lub użyć. To zdarzenia elementu, nie metody ani wyjątki przechwytywane przez try...catch wokół przypisania do src. Słuchacze obu zdarzeń zarejestruj przed ustawieniem src. Zamiast nich możesz użyć właściwości onload i onerror; kolejne przypisanie do danej właściwości zastępuje jej procedurę obsługi.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Image load and error events</title>
</head>
<body>
<script>
(async () => {
const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10"><circle cx="5" cy="5" r="5" fill="blue"/></svg>';
const valid = 'data:image/svg+xml,' + encodeURIComponent(svg);
const invalid = 'data:image/svg+xml,not-an-svg';
function reportImage(url) {
return new Promise((resolve) => {
const img = new Image();
img.alt = 'Blue dot';
const report = (event) => {
console.log(`${event.type}: ${img.alt}`);
resolve();
};
img.addEventListener('load', report, { once: true });
img.addEventListener('error', report, { once: true });
img.src = url;
});
}
await reportImage(valid);
await reportImage(invalid);
})();
</script>
</body>
</html>Wynik
load: Blue dot error: Blue dot
Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli deweloperskiej. Kod kolejno sprawdza poprawny SVG i nieprawidłowe dane obrazu, bez żądań sieciowych. W obu przypadkach wypisuje zdarzenie i niezmieniony `alt`; nie pokazuje, jak przeglądarka wyświetla tekst alternatywny. Polityka CSP blokująca obrazy `data:` może spowodować `error` także w pierwszej próbie.
Powiązane lekcje
- JavaScript · Lekcja 30 · Średniozaawansowany · Wersja: 3