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

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

Източници