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

CKTIS / JavaScript

HTMLElement.onload — обработване на зареждането на ресурс

HTMLElement.onload е свойството за обработчик на събитието load. Задайте му функция, която да реагира на зареждането на ресурс на елемент, например изображение. Последващо присвояване заменя предишната функция, а null деактивира обработчика.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

element.onload = function (event) { /* handle load */ };
element.onload = null;

HTMLElement.onload е свойството за обработчик на събитието load, предоставено чрез механизма GlobalEventHandlers. Това е интерфейс на браузъра, дефиниран от HTML, а не функционалност на самия ECMAScript; наличието на Node.js 24 не доказва, че свойството е достъпно.

При изображение load означава, че ресурсът е зареден успешно. Задайте функцията преди да присвоите src, за да не пропуснете събитието. Наличието на това свойство върху даден елемент не означава, че всеки елемент автоматично излъчва load. Елементите body и frameset са особен случай: техният onload обработва събитието на Window, а не зареждането на отделен ресурс на елемента.

Присвояването на нова функция заменя предишната; null премахва този обработчик. За независими абонаменти използвайте addEventListener('load', handler). В примера изображението е с размер 1x1, а функцията получава event. Обикновената функция използва this, за да се позове на изображението.

Примери

(() => {
  const image = document.createElement('img');
  image.onload = function (event) {
    console.log(event.type + ': ' + this.naturalWidth + 'x' + this.naturalHeight);
    this.onload = null;
  };
  image.onerror = () => console.log('error');
  image.src = 'data:image/svg+xml,' + encodeURIComponent(
    '<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"></svg>'
  );
})();

Резултат

load: 1x1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници