MutationEvent interface provides specific contextual
+ * information associated with Mutation events.
+ * See also the Document Object Model (DOM) Level 2 Events Specification.
+ * @since DOM Level 2
+ */
+public interface MutationEvent extends Event {
+ // attrChangeType
+ /**
+ * The Attr was modified in place.
+ */
+ public static final short MODIFICATION = 1;
+ /**
+ * The Attr was just added.
+ */
+ public static final short ADDITION = 2;
+ /**
+ * The Attr was just removed.
+ */
+ public static final short REMOVAL = 3;
+
+ /**
+ * relatedNode is used to identify a secondary node related
+ * to a mutation event. For example, if a mutation event is dispatched
+ * to a node indicating that its parent has changed, the
+ * relatedNode is the changed parent. If an event is
+ * instead dispatched to a subtree indicating a node was changed within
+ * it, the relatedNode is the changed node. In the case of
+ * the DOMAttrModified event it indicates the Attr node
+ * which was modified, added, or removed.
+ */
+ public Node getRelatedNode();
+
+ /**
+ * prevValue indicates the previous value of the
+ * Attr node in DOMAttrModified events, and of the
+ * CharacterData node in DOMCharacterDataModified events.
+ */
+ public String getPrevValue();
+
+ /**
+ * newValue indicates the new value of the Attr
+ * node in DOMAttrModified events, and of the CharacterData
+ * node in DOMCharacterDataModified events.
+ */
+ public String getNewValue();
+
+ /**
+ * attrName indicates the name of the changed
+ * Attr node in a DOMAttrModified event.
+ */
+ public String getAttrName();
+
+ /**
+ * attrChange indicates the type of change which triggered
+ * the DOMAttrModified event. The values can be MODIFICATION
+ * , ADDITION, or REMOVAL.
+ */
+ public short getAttrChange();
+
+ /**
+ * The initMutationEvent method is used to initialize the
+ * value of a MutationEvent created through the
+ * DocumentEvent interface. This method may only be called
+ * before the MutationEvent has been dispatched via the
+ * dispatchEvent method, though it may be called multiple
+ * times during that phase if necessary. If called multiple times, the
+ * final invocation takes precedence.
+ * @param typeArg Specifies the event type.
+ * @param canBubbleArg Specifies whether or not the event can bubble.
+ * @param cancelableArg Specifies whether or not the event's default
+ * action can be prevented.
+ * @param relatedNodeArg Specifies the Event's related Node.
+ * @param prevValueArg Specifies the Event's
+ * prevValue attribute. This value may be null.
+ * @param newValueArg Specifies the Event's
+ * newValue attribute. This value may be null.
+ * @param attrNameArg Specifies the Event's
+ * attrName attribute. This value may be null.
+ * @param attrChangeArg Specifies the Event's
+ * attrChange attribute
+ */
+ public void initMutationEvent(String typeArg,
+ boolean canBubbleArg,
+ boolean cancelableArg,
+ Node relatedNodeArg,
+ String prevValueArg,
+ String newValueArg,
+ String attrNameArg,
+ short attrChangeArg);
+
+}