<b>void setAttribute(string qualifiedName, string value)</b>
Присваивает указанное значение атрибуту с указанным именем. Если атрибут с таким именем еще не существует, в элемент добавляется новый атрибут. В HTML-документах перед присваиванием значения символы в имени атрибута преобразуются в нижний регистр. Обратите внимание: в HTML-документе JavaScript-свойства, соответствующие всем стандартным HTML-атрибутам, определяются объектами
<b>HTMLElement</b>
. Поэтому данный метод обычно используется лишь для доступа к нестандартным атрибутам.
<b>void setAttributeNS(string namespace, string qualifiedName, string value)</b>
Этот метод действует так же, как метод
<b>setAttribute(),</b>
за исключением того, что имя атрибута указывается как комбинация URI пространства имен и квалифицированного имени, состоящего из префикса пространства имен, двоеточия и локального имени в этом пространстве имен.
Обработчики событий
Объекты
<b>Element</b>
, представляющие HTML-элементы, определяют достаточно много свойств обработчиков событий. Достаточно присвоить функцию любому свойству из числа перечисленных ниже, и эта функция будет вызываться при возникновении события данного типа в элементе (или по достижении элемента в результате всплытия). Для регистрации обработчиков событий можно также использовать методы, определяемые интерфейсом EventTarget.
Большинство событий всплывают вверх по дереву документа до узла
<b>Document</b>
и затем передаются объекту
<b>Window</b>
. Поэтому все свойства обработчиков событий, перечисленные ниже, определены также в объектах
<b>Document</b>
и
<b>Window</b>
. Однако объект
<b>Window</b>
обладает достаточно большим количеством собственных обработчиков событий, и свойства, помеченные звездочкой в таблице ниже, в объекте
<b>Window</b>
имеют другой смысл. По историческим причинам обработчики событий, зарегистрированные посредством HTML-атрибутов в элементе
<b><body></b>
, регистрируются в объекте
<b>Window</b>
, а это означает, что свойства, помеченные звездочкой, в элементе
<b><body></b>
имеют другой смысл. См. также Window.
Многие события, перечисленные здесь, возбуждаются только в HTML-элементах определенных типов. Но, так как многие из этих событий всплывают вверх по дереву документа, свойства обработчиков событий определены во всех элементах. Мультимедийные события, введенные спецификацией HTML5, которые возбуждаются в тегах
<b><audio></b>
и
<b><video>,</b>
не всплывают, поэтому они описываются в справочной статье MediaElement. Аналогично некоторые события форм, введенные спецификацией HTML5, также не всплывают и описываются в справочной статье FormControl.
HTML-элементы и атрибуты
Этот раздел включает справочные статьи для следующих HTML-элементов:
HTML-элементы, для которых отсутствуют собственные справочные статьи, относятся к числу тех, чьи свойства просто соответствуют HTML-атрибутам элементов. Ниже перечислены атрибуты, допустимые в любых HTML-элементах и потому являющиеся свойствами всех объектов
<b>Element</b>
:
Следующие HTML-элементы не имеют атрибутов, кроме тех, что перечислены выше:
Остальные HTML-элементы и поддерживаемые ими атрибуты перечислены ниже. Обратите внимание, что в этой таблице перечислены только атрибуты, отличающиеся от глобальных атрибутов, перечисленных выше. Также отметьте, что эта таблица включает элементы, для которых имеются отдельные справочные статьи:
ErrorEvent
необработанное исключение в фоновом потоке выполнения (Event)
Когда в фоновом потоке выполнения, который представляет объект
<b>Worker</b>
, возникает необработанное исключение, которое также не было обработано функцией
<b>onerror</b>
в объекте
<b>WorkerGlobalScope</b>
, оно вызывает невсплывающее событие «error» в объекте
<b>Worker</b>
. Вместе с событием обработчику передается объект события
<b>ErrorEvent</b>
, содержащий информацию об исключении. Вызов метода
<b>preventDefault()</b>
объекта
<b>ErrorEvent</b>
(или возврат значения false из обработчика события) предотвратит дальнейшее распространение события по объемлющим потокам выполнения и также может предотвратить вывод сообщения об ошибке в консоли.
Свойства
<b>readonly string filename</b>
URL-адрес файла со сценарием на языке JavaScript, в котором возникло исключение.
<b>readonly unsigned long lineno</b>
Номер строки в этом файле, в которой возникло исключение.
<b>readonly string message</b>
Сообщение с описанием исключения.
Event
информация о стандартных событиях, события IE и jQuery
Когда вызывается обработчик события, ему передается объект
<b>Event</b>
, чьи свойства содержат дополнительную информацию о событии, такую как тип события и элемент, в котором оно возникло. С помощью методов этого объекта
<b>Event</b>
можно управлять распространением события. Все современные броузеры реализуют стандартную модель событий, кроме ІE, который в версии 8 и ниже определяет свою собственную, не совместимую с другими броузерами модель. Эта справочная статья описывает стандартные свойства и методы объекта события, альтернативные им свойства и методы, поддерживаемые в ІE, а также охватывает объект события, реализованный в библиотеке jQuery, который имитирует стандартный объект события в IE. Более подробно о событиях рассказывается в главе 17, а о поддержке событий в библиотеке jQuery -в разделе 19.4.
