Interface MutationEvent

継承元:

Event

プロパティ:

attrChange, attrName, newValue, prevValue, relatedNode

メソッド:

initMutationEvent

定義済み変数: attrChangeType

プロパティ:

• mutationeventObject.attrChange

  unsigned short型, 読取専用

  attrChange は DOMAttrModified イベントを誘発した変更の型をあらわす。ありうる値は MODIFICATION, ADDITION, REMOVAL。

• mutationeventObject.attrName

  DOMString型, 読取専用

  attrName は DOMAttrModified イベントにおいて変更された Attr ノードの名前をあらわす。

• mutationeventObject.newValue

  DOMString型, 読取専用

  newValue は DOMAttrModified イベントにおける Attr ノード、また DOMCharDataModified イベントにおける CharacterData ノードの新しい値をあらわす。

• mutationeventObject.prevValue

  DOMString型, 読取専用

  prevValue は DOMAttrModified イベントにおける Attr ノード、また DOMCharDataModified イベントにおける CharacterData ノードの前の値をあらわす。

• mutationeventObject.relatedNode

  Node型, 読取専用

  relatedNode はミューテーションイベントに関連する補助的なノードの識別に使われる。例えば、ミューテーションイベントが、その親が変更したことをあらわすノードに送信された場合、relatedNode はその変更された親である。イベントが、代わりにノードがその中で変更されたことをあらわすサブツリーに送信される場合は、relatedNode はその変更されたノードである。DOMAttrModified イベントの場合は、変更、追加、削除された Attr ノードをあらわす。

メソッド:

• mutationeventObject.initMutationEvent( typeArg, canBubbleArg, cancelableArg, relatedNodeArg, prevValueArg, newValueArg, attrNameArg, attrChangeArg )

  initMutationEvent メソッドは、DocumentEvent インタ-フェイスを通して作成された MutationEvent の値を初期化する。このメソッドは 必要ならばフェイズの間複数回呼び出せるが、MutationEvent が dispatchEvent メソッド経由で送信される前にのみ呼ばれうる。複数回呼び出す場合は、最後の実施が先行する。

  引数:

  typeArg / DOMString

  イベントの型。

  canBubbleArg / boolean

  イベントがバブルできるか否か。

  cancelableArg / boolean

  イベントのデフォルトアクションを回避できるか否か。

  relatedNodeArg / Node

  Event の関連ノード。

  prevValueArg / DOMString

  Event の prevValue プロパティ。この値は null でもよい。

  newValueArg / DOMString

  Event の newValue プロパティ。この値は null でもよい。

  attrNameArg / DOMString

  Event の attrName プロパティ。この値は null でもよい。

  attrChangeArg / unsigned short

  Event の attrChange プロパティ。

  戻り値:

  (無し)

イベント型:

• DOMSubtreeModified

  文書へのすべての変更の通知のための一般的なイベント。以降に挙げる特別なイベントの代わりに使用することもできる。これは文書への単一の修正後に発生し、また実装の裁量で、複数の変更の発生後に発生してもよい。後者の用法は一般に、一斉に発生、また連発する複数の変更の適応に対して使われるべきである。このイベントのターゲットは、起こった変更の最小の共通の親である。このイベントは、ミューテーションによって発生する他のイベントの発生後に送信される。

  Bubbles	true
  Cancelable	false
  Context Info	None

• DOMNodeInserted

  ノードが 他ノードの child として付加されたときに発生。このイベントは挿入が起こった後に発生する。このイベントのターゲットは挿入されたノードである。

  Bubbles	true
  Cancelable	false
  Context Info	relatedNode holds the parent node

• DOMNodeRemoved

  ノードが、その親ノードから取り除かれたときに発生。このイベントは、ノードがツリーから取り除かれる前に送信される。このイベントのターゲットは取り除かれるノードである。

  Bubbles	true
  Cancelable	false
  Context Info	relatedNode holds the parent node

• DOMNodeRemovedFromDocument

  ノードの直接削除、またノードの含まれるサブツリーの削除を通して、ノードが文書から取り除かれるときに発生。このイベントは削除が起こる前に送信される。このイベントのターゲットは削除されるノードである。ノードが直接(直ちに?)削除されている場合は DOMNodeRemovedFromDocument イベントの前に DOMNodeRemoved イベントが発生する。

  Bubbles	false
  Cancelable	false
  Context Info	None

• DOMNodeInsertedIntoDocument

  ノードの直接挿入、またノードの含まれるサブツリーの挿入を通して、ノードが文書に挿入されるときに発生。このイベントは挿入が起こった後に送信される。このイベントのターゲットは挿入されるノードである。ノードが直接(直ちに?)挿入されている場合は DOMNodeInsertedIntoDocument イベントの前に DOMNodeInserted イベントが発生する。

  Bubbles	false
  Cancelable	false
  Context Info	None

• DOMAttrModified

  ノード上で が修正されるときに発生。このイベントのターゲットは変更される を持つ である。attrChange の値が が修正されたか、追加されたか、削除されたかを表す。relatedNode の値が影響を受けた ノードをあらわす。その独自性を変更しないで、 の値の交換に基づく文字列が の修正として表示されることが期待される。その後、異なる ノードとの ノードの交換は、最初の ノードの削除と次のノードの追加として表示される。

  Bubbles	true
  Cancelable	false
  Context Info	attrName, attrChange, prevValue, newValue, relatedNode

• DOMCharacterDataModified

  ノード内の CharacterData の修正後に発生するが、ノード自身は挿入されたり削除されたりしない。このイベントは PI エレメノへの修正によっても発生する。このイベントのターゲットは CharacterNode ノードである。

  Bubbles	true
  Cancelable	false
  Context Info	prevValue, newValue

IDL 定義:

// Introduced in DOM Level 2:
interface MutationEvent : Event {
  // attrChangeType
  const unsigned short      MODIFICATION                   = 1;
  const unsigned short      ADDITION                       = 2;
  const unsigned short      REMOVAL                        = 3;
  readonly attribute Node             relatedNode;
  readonly attribute DOMString        prevValue;
  readonly attribute DOMString        newValue;
  readonly attribute DOMString        attrName;
  readonly attribute unsigned short   attrChange;
  void               initMutationEvent(in DOMString typeArg, 
                                       in boolean canBubbleArg, 
                                       in boolean cancelableArg, 
                                       in Node relatedNodeArg, 
                                       in DOMString prevValueArg, 
                                       in DOMString newValueArg, 
                                       in DOMString attrNameArg, 
                                       in unsigned short attrChangeArg);
};

• Back to Document Object Model Events
• Object Index
• Glossary
• References