UI Events 仕様

7.1.1. ~ifc `UIEvent^I （追補的）

`UIEvent^I 部分的~ifcは、 `UIEvent$I ~ifcに `which$m 属性を追加する，参考の拡張である。 ◎ The partial UIEvent interface is an informative extension of the UIEvent interface, which adds the which attribute.

partial interface `UIEvent$I {
    // 次のものは旧来の~UAを~supportする
    readonly attribute unsigned long `which$m;
};

`which@m ◎ which, of type unsigned long, readonly

`MouseEvent$I に対しては、この属性は， ( `button$m の値 + 1 ) に等しくなる。 `KeyboardEvent$I に対しては、この属性は，［ 押された~keyに結付けられている, 未修飾の, ［ ~system／実装 ］に依存する識別子 ］を~~表すような数的~codeを保持する。 大方の事例では、値は `keyCode$m と一致する。 ◎ For MouseEvents, this contains a value equal to the value stored in button+1. For KeyboardEvents, this holds a system- and implementation-dependent numerical code signifying the unmodified identifier associated with the key pressed. In most cases, the value is identical to keyCode.

7.1.2. 辞書 `UIEventInit^I （追補的）

`UIEvent$I にて `which$m 用の~supportを含める~browserは、 `UIEventInit$I 辞書に次の~memberも追加するべきである。 ◎ Browsers that include support for which in UIEvent should also add the following members to the UIEventInit dictionary.

`UIEventInit^I 部分的~辞書は、 `UIEventInit$I 辞書に，［ 対応する `UIEvent^I 属性を初期化する `which$m ~member ］を追加する，参考の拡張である。 ◎ The partial UIEventInit dictionary is an informative extension of the UIEventInit dictionary, which adds the which member to initialize the corresponding UIEvent attributes.

partial dictionary `UIEventInit$I {
    unsigned long `which$d = 0;
};

`which@d

`UIEvent$I の `which$m 属性を初期化する。 ◎ Initializes the which attribute of the UIEvent.

7.2.1. ~ifc `KeyboardEvent^I （追補的）

`KeyboardEvent^I 部分的~ifcは、 `KeyboardEvent$I ~ifcに `charCode$m, `keyCode$m, 属性を追加する，参考の拡張である。 ◎ The partial KeyboardEvent interface is an informative extension of the KeyboardEvent interface, which adds the charCode and keyCode attributes.

`KeyboardEvent^I 部分的~ifcは、実装がこの拡張を~supportするならば， `KeyboardEvent^l を引数に `createEvent()$m ~methodを~callして得られる。 ◎ The partial KeyboardEvent interface can be obtained by using the createEvent() method call in implementations that support this extension.

partial interface `KeyboardEvent$I {
    // 次のものは旧来の~UAを~supportする
    readonly attribute unsigned long `charCode$m;
    readonly attribute unsigned long `keyCode$m;
};

`charCode@m ◎ charCode, of type unsigned long, readonly

この属性は、文字~入力を生成する `keypress$et ~event用に，文字~値を保持する。 値は、その文字の~Unicode符号位置をとる（例： 印字可能~文字に対しては， `charCode^m は `event.key.charCodeAt(0)^m と同じになる）。 `keydown$et ／ `keyup$et ~eventに対する `charCode^m の値は， 0 である。 ◎ charCode holds a character value, for keypress events which generate character input. The value is the Unicode reference number (code point) of that character (e.g. event.charCode = event.key.charCodeAt(0) for printable characters). For keydown or keyup events, the value of charCode is 0.

`keyCode@m ◎ keyCode, of type unsigned long, readonly

この属性は、押された~keyに結付けられている未修飾の識別子を~~表す，~system／実装に依存する数的~codeを保持する。 `key$m 属性と違って、この仕様では，可能な値の集合は規範的に定義されない。 これらの `keyCode^m の値は、概して， ASCII `RFC20$r`US-ASCII$r ／ Windows 1252 `WIN1252$r 内の 10 進~符号位置を表現する~SHOULDであるが、適切な他の文字集合から取り出しても~MAY。 ~keyを識別できない実装は、~key値 `0^cap を利用する。 ◎ keyCode holds a system- and implementation-dependent numerical code signifying the unmodified identifier associated with the key pressed. Unlike the key attribute, the set of possible values are not normatively defined in this specification. Typically, these value of the keyCode SHOULD represent the decimal codepoint in ASCII [RFC20][US-ASCII] or Windows 1252 [WIN1252], but MAY be drawn from a different appropriate character set. Implementations that are unable to identify a key use the key value 0.

`keyCode^m に対する値を決定する方法についての詳細は、 旧来の~key~model を見よ。 ◎ See §7.3 Legacy key models for more details on how to determine the values for keyCode.

7.2.2. 辞書 `KeyboardEventInit^I （追補的）

`KeyboardEvent^I において［ `keyCode$m, `charCode$m, `which$m ］を~supportする~browserは、 `KeyboardEventInit$I 辞書に，次の~memberも追加する~SHOULDである。 ◎ Browsers that include support for keyCode, charCode, and which in KeyboardEvent should also add the following members to the KeyboardEventInit dictionary.

`KeyboardEventInit^I 部分的~辞書は、 `KeyboardEventInit$I 辞書に，［ 対応する `KeyboardEvent^I 属性を初期化する `charCode$m, `keyCode$m, ~member ］を追加する，参考の拡張である。 ◎ The partial KeyboardEventInit dictionary is an informative extension of the KeyboardEventInit dictionary, which adds charCode, keyCode, and which members to initialize the corresponding KeyboardEvent attributes.

partial dictionary `KeyboardEventInit$I {
    // 次のものは旧来の~UAを~supportする
    unsigned long `charCode$d = 0;
    unsigned long `keyCode$d = 0;
};

`charCode@d

`KeyboardEvent^I の `charCode$m 属性を ~eventの文字に対する~Unicode符号位置に初期化する。 ◎ Initializes the charCode attribute of the KeyboardEvent to the Unicode code point for the event’s character.

`keyCode@d

`KeyboardEvent^I の `keyCode$m 属性を［ ~system／実装に依存する，押された~keyに結付けられている未修飾の識別子 ］を~~表す数的~codeに初期化する。 ◎ Initializes the keyCode attribute of the KeyboardEvent to the system- and implementation-dependent numerical code signifying the unmodified identifier associated with the key pressed.

7.3.1. `keydown^et ／ `keyup^et ~eventに対し `keyCode^m を決定する方法

`keydown$et ／ `keyup$et ~eventに対する `keyCode$m は、次のように計算される： ◎ The keyCode for keydown or keyup events is calculated as follows:

1. `~IME$が~key入力を処理していて，~eventが `keydown$et である場合： 229 を返す。 ◎ ↓↓Read the virtual key code from the operating system’s event information, if such information is available. ◎ If an Input Method Editor is processing key input and the event is keydown, return 229.
2. 入力~keyが修飾なしで押されたときに，数的~文字（ 0 〜 9 ）が挿入されることになる場合： その数的~文字の ASCII ~codeを返す。 ◎ If input key when pressed without modifiers would insert a numerical character (0-9), return the ASCII code of that numerical character.
3. 入力~keyが修飾なしで押されたときに， a 〜 z の小文字が挿入されることになる場合： それに対応する大文字の ASCII ~codeを返す。 ◎ If input key when pressed without modifiers would insert a lower case character in the a-z alphabetical range, return the ASCII code of the upper case equivalent.
4. 実装が ~OS／~platform用の~key~code変換表を~supportしていて、その表に，与えられた入力に対する代替の仮想~key値が指定されている場合： その値を返す。 ◎ If the implementation supports a key code conversion table for the operating system and platform, look up the value. If the conversion table specifies an alternate virtual key value for the given input, return the specified value.
5. 実装~特有の仕方で決定される~keyの機能が，［ 固定的な仮想~key~code表 内のいずれかの~key ］に対応する場合、それに対応する~key~codeを返す。 ◎ If the key’s function, as determined in an implementation-specific way, corresponds to one of the keys in the §7.3.3 Fixed virtual key codes table, return the corresponding key code.
6. ~OSの~event情報によるによる仮想~key~codeが可用な場合： その~key~codeを返す。 ◎ ↑Return the virtual key code from the operating system.
7. 他の場合、 0 を返す。 ◎ If no key code was found, return 0.

7.3.2. `keypress^et~eventに対し `keyCode^m を決定する方法

`keypress$et ~eventに対する `keyCode$m は、次のように計算される： ◎ The keyCode for keypress events is calculated as follows:

1. 実装が ~conflated~modelを~supportする場合： `keyCode$m を手入力された文字の~Unicode符号位置に設定する。 ◎ If the implementation supports a conflated model, set keyCode to the Unicode code point of the character being entered.
2. 実装が ~split~modelを~supportする場合： `keyCode$m を 0 に設定する。 ◎ If the implementation supports a split model, set keyCode to 0.

7.3.3. 固定的な仮想~key~code

次の~keyに対する仮想~key~codeは、通例的に，~desktop~system上の~keyboard~layout間では変化しない： ◎ The virtual key codes for the following keys do not usually change with keyboard layouts on desktop systems:

7.3.4. 固定的な仮想~key~code（任意選択）

次の約物は、~keyboard~layout間で仮想~codeが変わり得るが、これらの値を報告することは、 US-English ~keyboard~layoutを予期している旧来の内容においては，より互換になる~~可能性が高い： ◎ The following punctuation characters MAY change virtual codes between keyboard layouts, but reporting these values will likely be more compatible with legacy content expecting US-English keyboard layout:

8.1.1. 旧来の各種 `UIEvent^I ~event型

8.1.2. 作動化~event序列

`DOMActivate^et ~eventを~supportする`~UA$は、~eventを相互相対順序で発火し~MUST（~~関係する~eventのみ挙げる）: ◎ If the DOMActivate event is supported by the user agent, then the events MUST be dispatched in a set order relative to each other: (with only pertinent events listed):

被focus要素が~key~eventで作動化された場合の，代表的な~event連列（~~関係する~eventのみ挙げる）を次に示す： ◎ If the focused element is activated by a key event, then the following shows the typical sequence of events (with only pertinent events listed):

8.2.1. 旧来の各種 `FocusEvent^I ~event型

8.2.2. 旧来の `FocusEvent^I ~event序列

非推奨 `DOMFocusIn$et ／ `DOMFocusOut$et ~eventも含まれる下で、被focus要素がない状態から，~focusが要素 `A^v, `B^v の順に移転したときの，代表的な~event連列を次に示す： ◎ The following is the typical sequence of events when a focus is shifted between elements, including the deprecated DOMFocusIn and DOMFocusOut events. The order shown assumes that no element is initially focused.

8.3.1. 旧来の各種 `KeyboardEvent^I ~event型

8.3.2. `keypress^et ~event序列

`keypress$et ~event型が発火されるのは、同じ~keyに結付けられている `keydown$et ~eventの後, かつ `keyup$et ~eventの前で~MUST。 ◎ The keypress event type MUST be dispatched after the keydown event and before the keyup event associated with the same key.

`keypress$et ~event型が発火されるのは、同じ~keyに結付けられている `beforeinput$et ~eventの後, かつ `input$et ~eventの前で~MUST。 ◎ The keypress event type MUST be dispatched after the beforeinput event and before the input event associated with the same key.

次の例に、 `keypress$et ~eventを~supportする~UAによる~key~eventの連列を示す： ◎ The sequence of key events for user-agents the support the keypress event is demonstrated in the following example:

8.4.1. ~ifc `MutationEvent^I

~DOM2にて導入され、この仕様にて`非推奨に$された。 ◎ Introduced in DOM Level 2, deprecated in this specification

`MutationEvent^I ~ifcは、変異~eventに特有の文脈的~情報を供する。 ◎ The MutationEvent interface provides specific contextual information associated with Mutation events.

`MutationEvent^I ~ifcの~instanceを作成するためには、 `createEvent()$m ~methodを利用する。 ◎ To create an instance of the MutationEvent interface, use the createEvent() method call.

interface `MutationEvent@I : `Event$I {
    // `attrChange$m 値
    const unsigned short `MODIFICATION$m = 1;
    const unsigned short `ADDITION$m = 2;
    const unsigned short `REMOVAL$m = 3;

    readonly attribute `Node^I?          `relatedNode$m;
    readonly attribute ~DS      `prevValue$m;
    readonly attribute ~DS      `newValue$m;
    readonly attribute ~DS      `attrName$m;
    readonly attribute unsigned short `attrChange$m;

    void `initMutationEvent$m (~MANYARGS);
};

`MODIFICATION@m

`ADDITION@m

`REMOVAL@m

これらの定数は、順に， `Attr^I が［ 改変された／追加された／除去された ］ことを表す。 ◎ MODIFICATION • The Attr was modified in place. ◎ ADDITION • The Attr was just added. ◎ REMOVAL • The Attr was just removed.

`relatedNode@m

この属性は、変異~eventに関係する副~nodeを識別するために利用され~MUST。 例えば、~nodeに向けて，親が変更されたことを指示する変異~eventが発火された場合、この属性の値は，その変更された親になる。 代わりに，部分木の中のある~nodeが変化したことを指示する~eventが発火された場合、この属性の値は，変更された~nodeで~MUST。 `DOMAttrModified$et ~eventの事例では、それは， 【 `attrChange$m 属性の値に応じて】 ［ 改変された ／ 追加された ／ 除去された ］ `Attr^I ~nodeを指示する。 ◎ relatedNode MUST be 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 will be the changed parent. If an event is instead dispatched to a subtree indicating a node was changed within it, the relatedNode MUST be the changed node. In the case of the DOMAttrModified event, it indicates the Attr node which was modified, added, or removed.

`未初期化~値$： ~NULL ◎ The un-initialized value of this attribute MUST be null.

`prevValue@m

この属性は、［ `DOMAttrModified$et ~eventにおける `Attr^I ~node ／ `DOMCharacterDataModified$et ~eventにおける `CharacterData^I ~node ］の以前の値を指示する。 ◎ prevValue indicates the previous value of the Attr node in DOMAttrModified events, and of the CharacterData node in DOMCharacterDataModified events.

`未初期化~値$： `空~文字列$ ◎ The un-initialized value of this attribute MUST be "" (the empty string).

`newValue@m

この属性は、［ `DOMAttrModified$et ~eventにおける `Attr^I ~node ／ `DOMCharacterDataModified$et ~eventにおける `CharacterData^I ~node ］の新たな値を指示する。 ◎ newValue indicates the new value of the Attr node in DOMAttrModified events, and of the CharacterData node in DOMCharacterDataModified events.

`未初期化~値$： `空~文字列$ ◎ The un-initialized value of this attribute MUST be "" (the empty string).

`attrName@m

この属性は、 `DOMAttrModified$et ~eventにて変更された `Attr^I ~nodeの名前を 指示する。 ◎ attrName indicates the name of the changed Attr node in a DOMAttrModified event.

`未初期化~値$： `空~文字列$ ◎ The un-initialized value of this attribute MUST be "" (the empty string).

`attrChange@m

この属性は、 `DOMAttrModified$et ~eventを誘発した変更の種類 — `MODIFICATION$m ／ `ADDITION$m ／ `REMOVAL$m のいずれか — を指示する。 ◎ attrChange indicates the type of change which triggered the DOMAttrModified event. The values can be MODIFICATION, ADDITION, or REMOVAL. ◎ The un-initialized value of this attribute MUST be 0.

`未初期化~値$： 0

注記： `未初期化~値$ 0 に対しては、定義される定数は無い。 ◎ There is no defined constant for the attrChange value of 0 (the un-initialized value).

`initMutationEvent()@m

この~methodは、 `MutationEvent$I ~objの各種~属性を初期化する。 その挙動は `initEvent()$m と同じである。 いずれの引数も省略不可。 %relatedNodeArg のみ，~NULL もとり得る。 ◎ Initializes attributes of a MutationEvent object. This method has the same behavior as initEvent().

引数	説明
%typeArg	`initEvent()$m ~methodのそれと同じ ◎ Refer to the initEvent() method for a description of this parameter.
%bubblesArg	同上 ◎ Refer to the initEvent() method for a description of this parameter.
%cancelableArg	同上 ◎ Refer to the initEvent() method for a description of this parameter.
%relatedNodeArg	`relatedNode$m を指定する。 ◎ Specifies MutationEvent.relatedNode.
%prevValueArg	`prevValue$m を指定する。 `空~文字列$でもよい。 ◎ Specifies MutationEvent.prevValue. This value MAY be the empty string.
%newValueArg	`newValue$m を指定する。 `空~文字列$でもよい。 ◎ Specifies MutationEvent.newValue. This value MAY be the empty string.
%attrNameArg	`attrName$m を指定する。 `空~文字列$でもよい。 ◎ Specifies MutationEvent.attrName. This value MAY be the empty string.
%attrChangeArg	`attrChange$m を指定する。 0 でもよい。 ◎ Specifies MutationEvent.attrChange. This value MAY be 0.

8.4.2. 各種~旧来の変異~event型

以下に，各種~変異~event型を挙げる。 ◎ The mutation event types are listed below.

この仕様は、この節に挙げる~event型を，参照と完全さのために定義するが、これらの どの~event型の利用も`非推奨に$する。 ◎ The XXXXX event type is defined in this specification for reference and completeness, but this specification deprecates the use of this event type.

各種~変異~eventに共通する文脈~情報（trusted events）

【 この訳では、各所に共通する記述をこの節に集約する。 】

変異~eventに共通する文脈~情報を以下に挙げる。 個々の~event型にて定義されるものは、これらより優先される：

`MutationEvent$I ：

`attrName$m

`空~文字列$ ◎ MutationEvent.attrName : the empty string

`attrChange$m

0 ◎ MutationEvent.attrChange : 0

`relatedNode$m

~NULL ◎ MutationEvent.relatedNode : null

`newValue$m

`空~文字列$ ◎ MutationEvent.newValue : the empty string

`prevValue$m

`空~文字列$ ◎ MutationEvent.prevValue : the empty string

9.3.1. 既知の，実装~特有の接頭辞

この仕様が書かれた時点で既知の［ ~event型~名 接頭辞 ］には、次のものがある： ◎ At the time of writing, the following event-type name prefixes are known to exist:

11.1.1. ~DOM2~event~flowに対する変更点

この新たな仕様は、~event~flowに次の新たな概念を導入した： ◎ This new specification introduced the following new concepts in the event flow:

• `~event~listener$は、今や順序付けられた。 ~DOM2では，~eventの順序付けは指定されてなかった。 ◎ Event listeners are now ordered. In DOM Level 2, the event ordering was unspecified.
• 既存の実装を反映するため、~event~flowは，今や `Window$I を含む。 ◎ The event flow now includes the Window, to reflect existing implementations.

11.1.2. ~DOM2~event型に対する変更点

~event型には多くの明確化がなされた。 適合性は、今や明示的に 各~event型に対し定義される — ~event型に利用される~ifcを通してのみならず。 ◎ Many clarifications have been made on the event types. The conformance is now explicitly defined against the event types, and not only in terms of interfaces used by the event types.

`MutationEvents^I は`非推奨に$された。 この仕様の早期の草案には在った名前空間付き~eventの~supportも，除去された。 ◎ "MutationEvents" have been deprecated. Support for namespaced events, present in early drafts of this specification, has also been removed.

`DOMNodeInserted$et ／ `DOMNodeRemoved$et ~event型を~supportする~UAに対しては、この仕様は最早 `Attr^I ~nodeに向けて~eventを発火することを要求しない。 ◎ For user agents which support the DOMNodeInserted and DOMNodeRemoved event types, this specification no longer requires that the event type be fired for Attr nodes.

既存の実装を反映するため、 `resize^et ~event型は，最早~浮上せず， `mousemove$et ~eventは，今や`取消~可能$にされた。 ◎ The resize event type no longer bubbles and the mousemove event is now cancelable, reflecting existing implementations.

11.1.3. ~DOM2~event~ifcに対する変更点

`Event$I ~ifc

新たな属性 `defaultPrevented$m, および 新たな~method `stopImmediatePropagation()$m が加えられた。 ◎ The Event interface has one new attribute, defaultPrevented, and one new method, stopImmediatePropagation().

`timeStamp$m 属性は，今や ECMAScript 言語束縛の `Number^I に。 提案された訂正は `DOM-Level-3-Core$r にも同じ変更を加えることになる。 ◎ timeStamp is now a Number in the ECMAScript binding. A proposed correction to make the same change in [DOM-Level-3-Core] is forthcoming.

~DOM2~Eventsでは `type$m 属性は文字大小無視と見なしていたが、この仕様では文字大小区別と見なす。 ◎ This specification considers the type attribute to be case-sensitive, while DOM Level 2 Events considers type to be case-insensitive.

`EventTarget$I ~ifc

`dispatchEvent()$m ~methodは、改変された。 ◎ The method dispatchEvent() was modified.

`MouseEvent$I ~ifc

新たな~method `getModifierState()$m が加えられた。 ◎ The MouseEvent interface has one new method getModifierState().

`EventException^E 例外

この例外は、この仕様から除去された。 ~~以前の `DISPATCH_REQUEST_ERR^m ~codeは，名前 `InvalidStateError^E の `DOMException^I に対応付けられた。 ◎ The exception EventException is removed in this specification. The prior DISPATCH_REQUEST_ERR code is re-mapped to a DOMException of type InvalidStateError.

11.1.4. 新たな~ifc