UI Events （旧来のイベント, 他）

8.1.1. `UIEvent^I ~interface（補足的）

`UIEvent^I 部分的~interfaceは、 `UIEvent$I ~interfaceの参考な拡張であり， `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する
◎
The following support legacy user agents
 */
    readonly attribute `unsigned long$ `which$m;
};

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

`MouseEvent$I 用には、 この属性は ( `button$m の値 ~PLUS 1 ) に等しくなる。 `KeyboardEvent$I 用には、 この属性は［ 押された~UIkeyに結付けられた, 未修飾な, ［ ~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.

8.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 辞書の参考な拡張であり， `which$m ~member を追加する — それは、対応する `UIEvent^I 属性を初期化する。 ◎ 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 ◎ which, of type unsigned long, defaulting to 0

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

8.2.1. `KeyboardEvent^I ~interface（補足的）

`KeyboardEvent^I 部分的~interfaceは、 `KeyboardEvent$I ~interfaceの参考な拡張であり，［ `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 部分的~interfaceは、 実装がこの拡張を~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する
◎
The following support legacy user agents
 */
    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

この属性は、 押された~UIkeyに結付けられた未修飾な識別子を~~表す，~system／実装に依存する数量的な~codeを保持する。 `key$m 属性と違って、 この仕様では，アリな値の集合は規範的に定義されない。 これらの `keyCode^m の値は、 概して， ASCII `RFC20$r`US-ASCII$r ／ Windows 1252 `WIN1252$r 内の 10 進~符号位置を表現するベキであるが、 適切な他の文字集合から取り出してもヨイ。 ~UIkeyを識別できない実装は、 ~UIkey値 `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 に対する値を決定する方法についての詳細は、 `§ 旧来の~UIkey~model＠#legacy-key-models$ を見よ。 ◎ See § 8.3 Legacy key models for more details on how to determine the values for keyCode.

8.2.2. `KeyboardEventInit^I 辞書（補足的）

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

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

partial dictionary `KeyboardEventInit$I {
    /* 
次に挙げるものは旧来の~UAを~supportする
◎
The following support legacy user agents
 */
    `unsigned long$ `charCode$d = 0;
    `unsigned long$ `keyCode$d = 0;
};

`charCode@d ◎ charCode, of type unsigned long, defaulting to 0

`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 ◎ keyCode, of type unsigned long, defaulting to 0

`KeyboardEvent^I の `keyCode$m 属性を［ ~system／実装に依存する，押された~UIkeyに結付けられた未修飾な識別子 ］を~~表す数量的な~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.

8.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$が~UIkey入力を処理していて，~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. 入力~UIkeyが修飾なしで押されたときに，数量的な文字（ 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. 入力~UIkeyが修飾なしで押されたときに， 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用の~UIkey~code変換~表tを~supportしていて、 その表tに，与えられた入力に対する代替の仮想~UIkey値が指定されている場合： その値を返す。 ◎ 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. 実装に特有な仕方で決定される~UIkeyの機能が［ `§ 固定的な仮想~UIkey~code表t＠#fixed-virtual-key-codes$内のいずれかの~UIkey ］に対応する場合、 それに対応する~UIkey~codeを返す。 ◎ If the key’s function, as determined in an implementation-specific way, corresponds to one of the keys in the § 8.3.3 Fixed virtual key codes table, return the corresponding key code.
6. ~OSの~event情報によるによる仮想~UIkey~codeが可用な場合： その~UIkey~codeを返す。 ◎ ↑Return the virtual key code from the operating system.
7. 他の場合、 0 を返す。 ◎ If no key code was found, return 0.

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

`keypress$et ~event用の `keyCode$m は、 次に従って計算される： ◎ The keyCode for keypress events is calculated as follows:

1. 実装が `~conflated~model^emを~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^emを~supportする場合： `keyCode$m を 0 に設定する。 ◎ If the implementation supports a split model, set keyCode to 0.

8.3.3. 固定的な仮想~UIkey~code

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

8.3.4. 固定的な仮想~UIkey~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:

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

9.1.2. 作動化~event序列

`DOMActivate^et ~eventを~supportする`~UA$は、 ~eventを相互相対順序で発火するモノトスル（~~関係する~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要素が~UIkey~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):

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

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

非推奨dな［ `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.

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

9.3.2. `keypress^et ~event序列

`keypress$et ~event型は、 同じ~UIkeyに結付けられた［ `keydown$et ~eventより後, かつ `keyup$et ~eventより前 ］に発火するモノトスル。 ◎ The keypress event type MUST be dispatched after the keydown event and before the keyup event associated with the same key.

`keypress$et ~event型は、 同じ~UIkeyに結付けられた［ `beforeinput$et ~eventより後, かつ `input$et ~eventより前 ］に発火するモノトスル。 ◎ 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による~UIkey~eventの連列をデモる： ◎ The sequence of key events for user-agents the support the keypress event is demonstrated in the following example:

9.5.1. `MutationEvent^I ~interface

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

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

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

[`Exposed$=Window]
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 `DOMString$      `prevValue$m;
    readonly attribute `DOMString$      `newValue$m;
    readonly attribute `DOMString$      `attrName$m;
    readonly attribute `unsigned short$ `attrChange$m;

    `undefined$ `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 ◎ relatedNode, of type Node, readonly, nullable

この属性は、 変異~eventに関係する副~nodeを識別するために利用するモノトスル。 例えば、~nodeに向けて，親が変更されたことを指示する変異~eventが発火された場合、 この属性の値は，その変更された親になる。 代わりに，下位treeの中のある~nodeが変化したことを指示する~eventが発火された場合、 この属性の値は，変更された~nodeになるモノトスル。 `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 ◎ prevValue, of type DOMString, readonly

この属性は、［ `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 ◎ newValue, of type DOMString, readonly

この属性は、［ `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 ◎ attrName, of type DOMString, readonly

この属性は、 `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 ◎ attrChange, of type unsigned short, readonly

この属性は、 `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.

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

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

`initMutationEvent()@m ◎ initMutationEvent(typeArg)

この~methodは、 次の表tに挙げる引数を挙げられる順にとり， `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.

9.5.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^en ）

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

変異~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

10.3.1. 既知かつ実装に特有な接頭辞

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

12.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.

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

~event型には多くの明確化がなされた。 適合性は、 今や明示的に 各~event型に対し定義される — ~event型に利用される~interfaceを通してのみならず。 ◎ 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.

`MutationEvent$I【！"MutationEvents"】 は`非推奨に$された。 この仕様の早期の草案には在った名前空間~付き~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.

12.1.3. ~DOM2~event~interfaceに対する変更点

`Event$I ~interface

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

`timeStamp$m 属性の型は，今や ECMAScript 言語束縛の `Number^c に 【整数ではなく `DOMHighResTimeStamp$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 ~interface

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

`MouseEvent$I ~interface

新たな~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.

12.1.4. 新たな~interface