MutationEvent extension type
The MutationEvent
interface provides event properties that are
specific to modifications to the Document Object Model (DOM) hierarchy and
nodes.
Note: Using mutation events is problematic:
- Their design is flawed.
- Adding DOM mutation listeners to a document profoundly degrades the performance of further DOM modifications to that document (making them 1.5 - 7 times slower!). Moreover, removing the listeners does not reverse the damage.
- They have poor cross-browser compatibility: Safari doesn't support
DOMAttrModified
(see WebKit bug 8191) and Firefox doesn't support mutation name events (likeDOMElementNameChanged
andDOMAttributeNameChanged
).They have been deprecated in favor of mutation observers. Consider using these instead.
Properties
- attrChange → int
-
no setter
- attrName → String
-
no setter
- bubbles → bool
-
no setterinherited
- cancelable → bool
-
no setterinherited
- cancelBubble ↔ bool
-
getter/setter pairinherited
- composed → bool
-
no setterinherited
- currentTarget → EventTarget?
-
no setterinherited
- defaultPrevented → bool
-
no setterinherited
- eventPhase → int
-
no setterinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- isTrusted → bool
-
no setterinherited
- newValue → String
-
no setter
- prevValue → String
-
no setter
-
no setter
- returnValue ↔ bool
-
getter/setter pairinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- srcElement → EventTarget?
-
no setterinherited
- target → EventTarget?
-
no setterinherited
- timeStamp → DOMHighResTimeStamp
-
no setterinherited
- type → String
-
no setterinherited
Methods
-
composedPath(
) → JSArray< EventTarget> -
The
composedPath()
method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.inherited -
initEvent(
String type, [bool bubbles, bool cancelable]) → void -
The
Event.initEvent()
method is used to initialize the value of anevent
created using Document.createEvent.inherited -
initMutationEvent(
String typeArg, [bool bubblesArg, bool cancelableArg, String prevValueArg, String newValueArg, String attrNameArg, int attrChangeArg]) → void -
The
initMutationEvent()
method of the MutationEvent interface initializes the value of a mutation event once it's been created (normally using the Document.createEvent method). -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
preventDefault(
) → void -
The
preventDefault()
method of the Event interface tells the that if the event does not get explicitly handled, its default action should not be taken as it normally would be.inherited -
stopImmediatePropagation(
) → void -
The
stopImmediatePropagation()
method of the Event interface prevents other listeners of the same event from being called.inherited -
stopPropagation(
) → void -
The
stopPropagation()
method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases. It does not, however, prevent any default behaviors from occurring; for instance, clicks on links are still processed. If you want to stop those behaviors, see the Event.preventDefault method. It also does not prevent propagation to other event-handlers of the current element. If you want to stop those, see Event.stopImmediatePropagation.inherited -
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited