События изменения документа: интерфейс MutationEvent
Поддержка : | | Не поддерживается. | | | Не поддерживается. |
Интерфейс MutationEvent является производным от интерфейса Event и содержит дополнительную информацию о событиях, порожденных изменением структуры документа.
Свойства интерфейса MutationEventСвойство | Изменяемое | Модель | Описание |
---|
attrChange | Нет | DOM 2 | Тип изменения атрибута. | attrName | Нет | DOM 2 | Название изменившегося атрибута. | newValue | Нет | DOM 2 | Новое значение атрибута или текста. | prevValue | Нет | DOM 2 | Старое значение атрибута или текста. | relatedNode | Нет | DOM 2 | Вторичный узел, связанный с событием. |
Методы интерфейса MutationEventМетод | Модель | Описание |
---|
initMutationEvent | DOM 2 | Инициализирует событие. |
Свойство attrChange
Синтаксис: событие.attrChange Изменяемое: нет
Поддержка : | | Не поддерживается. | | | Не поддерживается. |
Свойство attrChange возвращает тип изменения атрибута для события DOMAttrModified. Тип изменения атрибута задается целым числом в соответствии со следующей таблицей:
Название | Значение | Описание |
---|
MODIFICATION | 1 | Изменено значение атрибута. | ADDITION | 2 | Добавлен новый атрибут. | REMOVAL | 3 | Удален атрибут. |
Свойство attrName
Синтаксис: событие.attrName Изменяемое: нет
Поддержка : | | Не поддерживается. | | | Не поддерживается. |
Свойство attrName возвращает строку, содержащую название изменившегося атрибута для события DOMAttrModified.
Свойство newValue
Синтаксис: событие.newValue Изменяемое: нет
Поддержка : | | Не поддерживается. | | | Не поддерживается. |
Свойство newValue возвращает строку, содержащую новое значение узла Attr для события DOMAttrModified или новое значение узла CharacterData для события DOMCharacterDataModified.
Свойство prevValue
Синтаксис: событие.prevValue Изменяемое: нет
Поддержка : | | Не поддерживается. | | | Не поддерживается. |
Свойство prevValue возвращает строку, содержащую предыдущее значение узла Attr для события DOMAttrModified или предыдущее значение узла CharacterData для события DOMCharacterDataModified.
Свойство relatedNode
Синтаксис: событие.relatedNode Изменяемое: нет
Поддержка : | | Не поддерживается. | | | Не поддерживается. |
Свойство relatedNode возвращает указатель на объект Node, соответствующий вторичному узлу, связанному с данным событием. Какой именно узел является вторичным, зависит от события и описано ниже для каждого из событий.
Метод initMutationEvent#mcreateevent
Синтаксис: узел.initMutationEvent(eventType, canBubble, isCancelable, relatedNode, prevValue, newValue, attrName, attrChange) Аргументы: eventType, prevValue, newValue, attrName - выражения типа DOMString canBubble, isCancelable - логические выражения relatedNode - выражение типа Node attrChange - числовое выражение
Поддержка : | | Не поддерживается. | | | Не поддерживается. |
Метод initMutationEvent используется для инициализации параметров события изменения документа, созданного методом createEvent. Он должен вызываться до того, как данное событие будет сгенерировано методом dispatchEvent, и изменяет только те параметры события, которые задаются его аргументами. Аргумент eventType задает название данного события в формате DOMString; это название должно быть именем языка XML. Аргументы canBubble и isCancelable указывают соответственно, является ли данное событие просачивающимся и отменяемым. Остальные аргументы задают значения одноименных свойств события.
Типы событий изменения документа
DOM 2 определяет следующие типы событий изменения документа (которые обозревателями пока не поддерживаются):
DOMSubtreeModified
Это событие носит общий характер и может использоваться вместо конкретных событий, описанных далее. В зависимости от реализации оно может генерироваться либо после каждой модификации документа, либо после группы взаимосвязанных изменений. Целью этого события является наименьший общий предок узлов, подвергшихся модификации.
bubbles: true;
cancelable: false;
контекст: нет.
DOMNodeInserted
Это событие генерируется после добавления нового узла в дерево документа. Его целью является новый узел.
DOMNodeInsertedIntoDocument
Это событие генерируется после добавления нового узла в дерево документа либо непосредственной вставкой, либо вставкой поддерева, содержащего данный узел. При непосредственном добавлении узла перед этим событием генерируется DOMNodeInserted. Целью является новый узел.
bubbles: false;
cancelable: false;
контекст: нет.
DOMNodeRemoved
Это событие генерируется перед удалением узла из дерева документа. Его целью является удаляемый узел.
DOMNodeRemovedFromDocument
Это событие генерируется перед удалением узла из дерева документа либо непосредственным удалением, либо удалением поддерева, содержащего данный узел. При непосредственном удалении узла перед этим событием генерируется DOMNodeRemoved. Целью является удаляемый узел.
bubbles: false;
cancelable: false;
контекст: нет.
DOMAttrModified
Это событие генерируется при изменении атрибутов узла. Его целью является Node, чьи атрибуты изменились; relatedNode указывает на сооветствующий объект Attr.
bubbles: true;
cancelable: false;
контекст: relatedNode, prevValue, newValue, attrName, attrChange.
DOMCharacterDataModified
Это событие генерируется при изменении текстового содержимого узла. Его целью является изменившийся объект CharacterData.
1 2 3 4 5 6 7 8
8 8 8
| |