CKTIS / JavaScript
Изображения в JavaScript: `src`, `alt`, `load` и `error`
Задай адрес и алтернативен текст на изображение и използвай събитията на елемента, за да реагираш при успешно или неуспешно зареждане.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
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() създава елемент img от тип HTMLImageElement, който първоначално е извън дървото на документа. Това е API на уеб платформата, а не част от ECMAScript 2024. Средата за изпълнение трябва да го предоставя.
img.src е свойство от тип низ, което отразява атрибута src. Задаването му стартира асинхронна обработка на източника на изображението дори без елементът да е добавен в документа. При четене на img.src валиден относителен URL се преобразува спрямо базовия URL на документа; img.getAttribute("src") връща записаната стойност на атрибута. При адаптивни изображения img.currentSrc показва кой URL е избрал браузърът.
img.alt отразява атрибута alt. Напиши текст, който предава смисъла или предназначението на изображението в конкретния контекст на човек, който не може да го види. Ако изображението е само декоративно, задай alt = "", вместо да пропускаш атрибута. alt не е URL на резервно изображение.
load означава, че изображението се е заредило успешно; error означава, че избраният ресурс не може да се зареди или използва. Това са събития на елемента, а не методи или изключения, които try...catch около присвояването на src би прихванал. Регистрирай и двата слушателя, преди да зададеш src. Можеш и да зададеш обработчици чрез onload и onerror; ново присвояване заменя обработчика в съответното свойство.
Примери
<!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>Резултат
load: Blue dot error: Blue dot
Запази примера като HTML файл, отвори го в браузър и провери резултата в конзолата за разработчици. Кодът изпробва първо валидно SVG изображение, а после невалидни данни за изображение, без мрежови заявки. И двата реда извеждат събитието и непроменената стойност на `alt`, но не показват как браузърът изобразява алтернативния текст. Политика за сигурност на съдържанието (CSP), която блокира изображения от `data:` адреси, може да предизвика `error` и при първата проба.
Свързани уроци
- JavaScript · Урок 30 · Средно · Версия: 3