UI Events

3.2.1.1. `UIEvent^I

[`Exposed$=Window]
interface `UIEvent@I : `Event$I {
    `UIEvent@mc(`DOMString$ %type, optional `UIEventInit$I %eventInitDict = {});

    readonly attribute `Window$I? `view$m;
    readonly attribute `long$ `detail$m;
};

`view@m ◎ UIEvent . view

この属性は、 ~eventがどの `Window$I から生成されたかを識別する。 ◎ The view attribute identifies the Window from which the event was generated.

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

`detail@m ◎ UIEvent . detail

この属性には、 ~eventの型に依存して， `Event$I についての一部の詳細~情報が指定される。 ◎ Specifies some detail information about the Event, depending on the type of event.

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

3.2.1.2. `UIEventInit^I

dictionary `UIEventInit@I : `EventInit$I {
    `Window$I? `view$m = null;
    `long$ `detail$m = 0;
};

`view@m ◎ UIEventInit . view

この~memberは、 この~eventの配送-先の大域~環境の~windowになるベキである。 この~eventが要素に配送されるなら、 その要素の`~node文書$を包含する~windowに設定されるベキである。 ◎ Should be initialized to the Window object of the global environment in which this event will be dispatched. If this event will be dispatched to an element, the view property should be set to the Window object containing the element’s ownerDocument.

`detail@m ◎ UIEventInit . detail

この値は、 ~appに特有な整数を与える。 ◎ This value is initialized to a number that is application-specific.

3.2.3.1. `load^et

~UAは、［ ~DOM実装が資源（文書など）, および すべての従属~資源（画像, ~stylesheet, ~scriptなど）の読込ngを完遂した ］とき，この~eventを発火するモノトスル。 従属~資源の読込nに失敗した場合でも、 それを読込んだ資源が~DOMを介して依然として~access可能である場合には， この~eventの発火は止めないモノトスル。 実装が，この~event型を発火するときには、 少なくとも `Document$I ~node上に配送することが要求される。 ◎ A user agent MUST dispatch this event when the DOM implementation finishes loading the resource (such as the document) and any dependent resources (such as images, style sheets, or scripts). Dependent resources that fail to load MUST NOT prevent this event from firing if the resource that loaded them is still accessible via the DOM. If this event type is dispatched, implementations are REQUIRED to dispatch this event at least on the Document node.

注記： 旧来の理由から、 ~HTML実装においては［ 文書の内側の資源（例えば画像）用の `load$et ~eventの伝播~経路 ］は，`~window$を含まない。 詳細は `HTML$r【！HTML5】 を見よ。 ◎ For legacy reasons, load events for resources inside the document (e.g., images) do not include the Window in the propagation path in HTML implementations. See [HTML5] for more information.

3.2.3.2. `unload^et

~UAは、［ ~DOM実装が，環境から資源（文書など）や 従属~資源（画像, ~stylesheet, ~scriptなど）を除去した ］とき，この~eventを発火するモノトスル。 文書の~unloadは，この~event型が配送された後になるモノトスル。 実装が，この~event型を配送するときには、 少なくとも `Document$I ~node上に配送することが要求される。 ◎ A user agent MUST dispatch this event when the DOM Implementation removes from the environment the resource (such as the document) or any dependent resources (such as images, style sheets, scripts). The document MUST be unloaded after the dispatch of this event type. If this event type is dispatched, implementations are REQUIRED to dispatch this event at least on the Document node.

3.2.3.3. `abort^et

~UAは、［ 資源の読込ngがまだ進捗~中に，利用者が取消したなどにより中止された ］とき，この~eventを発火するモノトスル。 ◎ A user agent MUST dispatch this event when the loading of a resource has been aborted, such as by a user canceling the load while it is still in progress.

3.2.3.4. `error^et

~UAは、［ 資源の読込nに失敗した, または読込まれたが その意味論に則って解釈-できない （妥当でない画像, ~script実行~error, 整形式でない~XMLなど） ］とき，この~eventを発火するモノトスル。 ◎ A user agent MUST dispatch this event when a resource failed to load, or has been loaded but cannot be interpreted according to its semantics, such as an invalid image, a script execution error, or non-well-formed XML.

3.2.3.5. `select^et

~UAは、［ 利用者が一部の~textを選択した ］とき，この~eventを発火するモノトスル。 この~eventは、 選択が生じた後に配送される。 ◎ A user agent MUST dispatch this event when a user selects some text. This event is dispatched after the selection has occurred.

注記： 利用者により選択された内容に~accessするためには、 内容~作者は，`~host言語$に備わる能力を利用することになる — HTML Editing APIs `Editing$r の `Document.getSelection()$m ~methodなど。 ◎ In order to access to user-selected content, content authors will use native capabilities of the host languages, such as the Document.getSelection() method of the HTML Editing APIs [Editing].

注記： `select$et ~eventは、 どの言語のどの要素でも可用になるとは限らない。 例えば `HTML$r【！HTML5】 においては、 `select$et ~eventが配送され得るのは，［ `input$e ／ `textarea$e ］要素に限られている。 実装は、［ ~form~controlの外側の~text選択, ~SVG内などの 画像や~markupの選択 ］なども含め，適切と判断される文脈にて `select$et ~eventを配送できる。 ◎ The select event might not be available for all elements in all languages. For example, in [HTML5], select events can be dispatched only on form input and textarea elements. Implementations can dispatch select events in any context deemed appropriate, including text selections outside of form controls, or image or markup selections such as in SVG.

3.3.1.1. `FocusEvent^I

[`Exposed$=Window]
interface `FocusEvent@I : `UIEvent$I {
    `FocusEvent@mc(`DOMString$ %type, optional `FocusEventInit$I %eventInitDict = {});

    readonly attribute `EventTarget$I? `relatedTarget$m;
};

`relatedTarget@m ◎ FocusEvent . relatedTarget

~focus~eventに関係する，副 `EventTarget$I を識別するために利用され、 ~eventの型に依存する。 ◎ Used to identify a secondary EventTarget related to a Focus event, depending on the type of event.

~securityの理由から、 入子な関係にある閲覧~文脈どうしで~focusが~~移動したときには【！tabbing into or out 】， この属性の値【！関連な EventTarget 】は ~NULL になるベキである。 ◎ For security reasons with nested browsing contexts, when tabbing into or out of a nested context, the relevant EventTarget SHOULD be null.

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

3.3.1.2. `FocusEventInit^I

dictionary `FocusEventInit@I : `UIEventInit$I {
    `EventTarget$I? `relatedTarget@m = null;
};

この辞書の各~memberは、 `FocusEventInit!I ~obj上の同じ名前の属性を初期化する。 それぞれがとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ FocusEventInit . relatedTarget • The relatedTarget should be initialized to the element losing focus (in the case of a focus or focusin event) or the element gaining focus (in the case of a blur or focusout event).

3.3.4.1. `blur^et

~UAは、 要素が~focusを失った直後に， 当の要素に向けて この~eventを発火するモノトスル。 この~event型は、 `focusout$et に類似するが，浮上しない。 ◎ A user agent MUST dispatch this event when an event target loses focus. The focus MUST be taken from the element before the dispatch of this event type. This event type is similar to focusout, but does not bubble.

3.3.4.2. `focus^et

~UAは、 要素が~focusを受取った直後に， 当の要素に向けて この~eventを発火するモノトスル。 この~event型は、 `focusin$et に類似するが，浮上しない。 ◎ A user agent MUST dispatch this event when an event target receives focus. The focus MUST be given to the element before the dispatch of this event type. This event type is similar to focusin, but does not bubble.

3.3.4.3. `focusin^et

~UAは、［ 要素が~focusを受取った直後 ］かつ［ 当の要素に向けて `focus$et ~eventを配送した後 ］に，当の要素に向けて この~eventを発火するモノトスル。 この~event型は、 `focus$et に類似するが，浮上する。 ◎ A user agent MUST dispatch this event when an event target receives focus. The event target MUST be the element which received focus. The focus event MUST fire before the dispatch of this event type. This event type is similar to focus, but does bubble.

3.3.4.4. `focusout^et

~UAは、［ 要素が~focusを失った直後 ］かつ［ 当の要素に向けて `blur$et ~eventを配送した後 ］に， 当の要素に向けて この~eventを発火するモノトスル。 この~event型は、 `blur$et に類似するが，浮上する。 ◎ A user agent MUST dispatch this event when an event target loses focus. The event target MUST be the element which lost focus. The blur event MUST fire before the dispatch of this event type. This event type is similar to blur, but does bubble.

3.4.1.1. `MouseEvent^I

[`Exposed$=Window]
interface `MouseEvent@I : `UIEvent$I {
    `MouseEvent@mc(`DOMString$ %type, optional `MouseEventInit$I %eventInitDict = {});

    readonly attribute `long$ `screenX$m;
    readonly attribute `long$ `screenY$m;
    readonly attribute `long$ `clientX$m;
    readonly attribute `long$ `clientY$m;
    readonly attribute `long$ `layerX$m;
    readonly attribute `long$ `layerY$m;

    readonly attribute `boolean$ `ctrlKey$m;
    readonly attribute `boolean$ `shiftKey$m;
    readonly attribute `boolean$ `altKey$m;
    readonly attribute `boolean$ `metaKey$m;

    readonly attribute `short$ `button$m;
    readonly attribute `unsigned short$ `buttons$m;

    readonly attribute `EventTarget$I? `relatedTarget$m;

    `boolean$ `getModifierState$m(`DOMString$ %keyArg);
};

`screenX@m ◎ screenX, of type long, readonly

~screen座標系の原点に相対的な，~eventが生じた~~地点の横方向~座標。 ◎ The horizontal coordinate at which the event occurred relative to the origin of the screen coordinate system.

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

`screenY@m ◎ screenY, of type long, readonly

横方向を縦方向に読み替える下で， `screenX$m と同じ。 ◎ The vertical coordinate at which the event occurred relative to the origin of the screen coordinate system. ◎ The un-initialized value of this attribute MUST be 0.

`clientX@m ◎ clientX, of type long, readonly

~eventに結付けられた表示域に相対的な，~eventが生じた~~地点の横方向~座標。 ◎ The horizontal coordinate at which the event occurred relative to the viewport associated with the event.

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

`clientY@m ◎ clientY, of type long, readonly

横方向を縦方向に読み替える下で， `clientX$m と同じ。 ◎ The vertical coordinate at which the event occurred relative to the viewport associated with the event. ◎ The un-initialized value of this attribute MUST be 0.

`layerX@m ◎ layerX, of type long, readonly

~AND↓ を満たす要素のうち【`現在の~target$】に最も近いもの【が生成する~boxの左上隅】からの【~eventが生じた~~地点の】横方向~offset：

• 【`~box~tree$において，`現在の~target$の】`先祖$である
• `積層~文脈$を生成している【！is a】
• `有位置$である
• `積層~文脈を塗る$ときに有位置 `phase^en【？】 にて塗られる

【 該当する要素が無い場合について言及されていない （ ［ `clientX$m ／ `clientY$m ］と同じになる？）。 】

◎ The horizontal offset from the nearest ancestor element which is a stacking context, is positioned, or paints in the positioned phase when painting a stacking context.

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

`layerY@m ◎ layerY, of type long, readonly

横方向を縦方向に読み替える下で， `layerX$m と同じ。 ◎ The vertical offset from the nearest ancestor element which is a stacking context, is positioned, or paints in the positioned phase when painting a stacking context. ◎ The un-initialized value of this attribute MUST be 0.

`ctrlKey@m

`shiftKey@m

`altKey@m

`metaKey@m

これらについては、 `KeyboardEvent$I の同じ名前の属性を見よ。 ◎ ctrlKey, of type boolean, readonly • Refer to the KeyboardEvent's ctrlKey attribute. • The un-initialized value of this attribute MUST be false. ◎ shiftKey, of type boolean, readonly • Refer to the KeyboardEvent's shiftKey attribute. • The un-initialized value of this attribute MUST be false. ◎ altKey, of type boolean, readonly • Refer to the KeyboardEvent's altKey attribute. • The un-initialized value of this attribute MUST be false. ◎ metaKey, of type boolean, readonly • Refer to the KeyboardEvent's metaKey attribute. • The un-initialized value of this attribute MUST be false.

`未初期化~値$： ~F ◎ ↑

`button@m ◎ button, of type short, readonly

~mouse~buttonの状態~変化による~mouse~eventに対しては、 この属性を利用して，その状態を変化させた~pointing装置の~buttonを指示するモノトスル。 ◎ During mouse events caused by the depression or release of a mouse button, button MUST be used to indicate which pointer device button changed state.

この属性に対する整数~値 ~IN { 0 〜 4 } は、 次を指示するモノトスル： ◎ The value of the button attribute MUST be as follows:

• 0 は、 装置の首~button （一般に、 ~UI~controlや選択~textを作動化するために利用される， 左~button, または 単-~buttonな装置の唯一の~button）, または`未初期化~値$。 ◎ 0 MUST indicate the primary button of the device (in general, the left button or the only button on single-button devices, used to activate a user interface control or select text) or the un-initialized value.
• 1 は、 予備~button （一般に，中央~button — ~mouse~wheelと組合されることが多い）。 ◎ 1 MUST indicate the auxiliary button (in general, the middle button, often combined with a mouse wheel).
• 2 は、 副~button （一般に，右~button — 文脈~menuを表示するために利用されることが多い）。 ◎ 2 MUST indicate the secondary button (in general, the right button, often used to display a context menu).
• 3 は、 ~X1（ `back^en ）~button。 ◎ 3 MUST indicate the X1 (back) button.
• 4 は、 ~X2（ `forward^en ） ~button。 ◎ 4 MUST indicate the X2 (forward) button.

~pointing装置には，もっと他の~button状態を［ 供する／模造する ］ものもあり、 そのような~buttonを表現するために，上に挙げたもの以外の整数が利用されることもある。 ◎ Some pointing devices provide or simulate more button states, and values higher than 2 or lower than 0 MAY be used to represent such buttons.

注記： `button$m の値は、 ~mouse~buttonの状態~変化によるものでない~eventに対しては，更新されない。 そのような局面における値 0 は、 左~buttonではなく，`未初期化~値$として解釈すること。 ◎ The value of button is not updated for events not caused by the depression/release of a mouse button. In these scenarios, take care not to interpret the value 0 as the left button, but rather as the un-initialized value.

注記： `mousedown$et や `mouseup$et などの~eventに関係する`既定~動作$には、 利用-中にある特定の~mouse~buttonに依存するものもある。 ◎ Some default actions related to events such as mousedown and mouseup depend on the specific mouse button in use.

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

`buttons@m ◎ buttons, of type unsigned short, readonly

~mouse~buttonが現在どの組合nで押されているかを表出する~bitmask。 どの~mouse~eventにおいても、 それを指示するときには，この属性を利用するモノトスル。 ◎ During any mouse events, buttons MUST be used to indicate which combination of mouse buttons are currently being pressed, expressed as a bitmask.

注記： 似た名前の `button$m 属性がとる値とは，まったく異なる。 `button^m の値を妥当と見做せるのは， `mousedown$et ／ `mouseup$et `~event~handler$の中に限られる一方、 `buttons^m 属性は，`~trusted$な どの `MouseEvent^I ~objに対しても（それが配送される間）~mouseの各~buttonの状態を反映する — それは、 “現在どの~buttonも作動中でない” 状態（ 0 ）も表現できるので。 ◎ Though similarly named, the values for the buttons attribute and the button attribute are very different. The value of button is assumed to be valid during mousedown / mouseup event handlers, whereas the buttons attribute reflects the state of the mouse’s buttons for any trusted MouseEvent object (while it is being dispatched), because it can represent the "no button currently active" state (0).

`buttons$m 属性の~bitmask値［ 0 ／ 1 ／ 2 ／ 4 ］は、 次を指示するモノトスル： ◎ The value of the buttons attribute MUST be as follows:

• 0 は、 どの~buttonも現在~作動中でないこと。 ◎ 0 MUST indicate no button is currently active.
• 1 は、 装置の首~button （一般に、 ~UI~controlや選択~textを作動化するために利用される，左~button, または単-~buttonな装置の唯一の~button）。 ◎ 1 MUST indicate the primary button of the device (in general, the left button or the only button on single-button devices, used to activate a user interface control or select text).
• 2 は、 副~button （一般に，右~button — 文脈~menuを表示するために利用されることが多い）。 ◎ 2 MUST indicate the secondary button (in general, the right button, often used to display a context menu), if present.
• 4 は、 予備~button （一般に，中央~button — ~mouse~wheelと組合されることが多い）。 ◎ 4 MUST indicate the auxiliary button (in general, the middle button, often combined with a mouse wheel).

~pointing装置には、 上述以外の~buttonを供する／模造するものもある — そのような~buttonを表現する値は，各~buttonごとに倍々にするモノトスル （ 8, 16, 32, ... ）。 ◎ Some pointing devices provide or simulate more buttons. To represent such buttons, the value MUST be doubled for each successive button (in the binary series 8, 16, 32, ... ).

注記： ~buttonたち全体が成すどの状態も，各~button値の総和で一意に表現されるので、 内容~作者は，装置~上の~mouse~buttonがいくつあっても，~bitごとの演算を利用して，現在どの~buttonが押されているかを決定できる。 例えば、 値 3 は，左＆右~buttonが押された（押されている）ことを指示し、 値 5 は，左＆中央~buttonが押されたことを指示する。 ◎ Because the sum of any set of button values is a unique number, a content author can use a bitwise operation to determine how many buttons are currently being pressed and which buttons they are, for an arbitrary number of mouse buttons on a device. For example, the value 3 indicates that the left and right button are currently both pressed, while the value 5 indicates that the left and middle button are currently both pressed.

注記： 【！複製】 `mousedown$et や `mouseup$et などの，一部の~eventに関係する`既定~動作$には、 どの~mouse~buttonが利用-中にあるかに依存するものもある。 ◎ Some default actions related to events such as mousedown and mouseup depend on the specific mouse button in use.

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

`relatedTarget@m ◎ relatedTarget, of type EventTarget, readonly, nullable

~eventの型に依存して、 ~UI~eventに関係する副 `EventTarget$I を識別するために利用される。 ◎ Used to identify a secondary EventTarget related to a UI event, depending on the type of event.

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

`getModifierState(keyArg)@m

`この仕様にて導入された。^em ◎ Introduced in this specification

`KeyboardEvent.getModifierState()$m ~methodを見よ。 ◎ Queries the state of a modifier using a key value. ◎ Returns true if it is a modifier key and the modifier is activated, false otherwise. ◎ DOMString keyArg ◎ Refer to the KeyboardEvent's getModifierState() method for a description of this parameter.

3.4.1.2. `MouseEventInit^I

dictionary `MouseEventInit@I : `EventModifierInit$I {
    `long$ `screenX@m = 0;
    `long$ `screenY@m = 0;
    `long$ `clientX@m = 0;
    `long$ `clientY@m = 0;

    `short$ `button@m = 0;
    `unsigned short$ `buttons@m = 0;
    `EventTarget$I? `relatedTarget@m = null;
};

この辞書の各~memberは、 `MouseEvent!I ~obj上の同じ名前の属性を初期化する。 それぞれがとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ screenX, of type long, defaulting to 0 • Initializes the screenX attribute of the MouseEvent object to the desired horizontal relative position of the mouse pointer on the user’s screen. • Initializing the event object to the given mouse position must not move the user’s mouse pointer to the initialized position. ◎ screenY, of type long, defaulting to 0 • Initializes the screenY attribute of the MouseEvent object to the desired vertical relative position of the mouse pointer on the user’s screen. • Initializing the event object to the given mouse position must not move the user’s mouse pointer to the initialized position. ◎ clientX, of type long, defaulting to 0 • Initializes the clientX attribute of the MouseEvent object to the desired horizontal position of the mouse pointer relative to the client window of the user’s browser. • Initializing the event object to the given mouse position must not move the user’s mouse pointer to the initialized position. ◎ clientY, of type long, defaulting to 0 • Initializes the clientY attribute of the MouseEvent object to the desired vertical position of the mouse pointer relative to the client window of the user’s browser. • Initializing the event object to the given mouse position must not move the user’s mouse pointer to the initialized position. ◎ button, of type short, defaulting to 0 • Initializes the button attribute of the MouseEvent object to a number representing the desired state of the button(s) of the mouse. • The value 0 is used to represent the primary mouse button, 1 is used to represent the auxiliary/middle mouse button, and 2 to represent the right mouse button. Numbers greater than 2 are also possible, but are not specified in this document. ◎ buttons, of type unsigned short, defaulting to 0 • Initializes the buttons attribute of the MouseEvent object to a number representing one or more of the button(s) of the mouse that are to be considered active. • The buttons attribute is a bit-field. If a mask value of 1 is true when applied to the value of the bit field, then the primary mouse button is down. If a mask value of 2 is true when applied to the value of the bit field, then the right mouse button is down. If a mask value of 4 is true when applied to the value of the bit field, then the auxiliary/middle button is down. • In JavaScript, to initialize the buttons attribute as if the right (2) and middle button (4) were being pressed simultaneously, the buttons value can be assigned as either: { buttons: 2 | 4 } or: { buttons: 6 } ◎ relatedTarget, of type EventTarget, nullable, defaulting to null • The relatedTarget should be initialized to the element whose bounds the mouse pointer just left (in the case of a mouseover or mouseenter event) or the element whose bounds the mouse pointer is entering (in the case of a mouseout or mouseleave or focusout event). For other events, this value need not be assigned (and will default to null).

`MouseEvent$I ~objが指示する~mouse位置がどう初期化されようが，利用者の~mouse~pointerはその位置に動かされないモノトスル。 ◎ ↑

実装は、 ~mouse~eventを生成するときには， `現在の~click回数@ を保守するモノトスル。 これは、 【同じ】~pointing装置の~buttonが，特定の時間~内に連続して~clickされた数を指示する負でない整数になるモノトスル。 どの程度の遅延で回数が~resetされるかは、 環境設定0に特有になる。 ◎ Implementations MUST maintain the current click count when generating mouse events. This MUST be a non-negative integer indicating the number of consecutive clicks of a pointing device button within a specific time. The delay after which the count resets is specific to the environment configuration.

【 回数が増加される~~正確な時機がいつなのか記されていないが、 `click$et ~eventが配送される直前と思われる。 】【 複数の~pointing装置があるときは、 装置ごとに~click回数を保守する？ それとも，~clickした装置が切り替わったら，~click回数は~resetされる？ 】

3.4.2.1. `Mouse^I ~eventの構築-法

一般に、 `Event$I ~interface またはそれを継承する~interfaceの構築子が呼出されたときは， `DOM$r に述べられる手続きに従うべきであるが、 それに加え， `MouseEvent$I ~interfaceは、［ `Event$I ~objにおける`~UIkey修飾＠#keys-modifiers$の内部~状態を初期化する ］ための追加的な辞書~memberも供する。 この内部~状態は、 特定的には `MouseEvent.getModifierState()$m ~methodを用いて~queryできる。 この節では、 `DOM$r【！DOM4】 による新たな `MouseEvent$I ~objを初期化する手続きに， この修飾~状態の初期化も補足する。 ◎ Generally, when a constructor of an Event interface, or of an interface inherited from the Event interface, is invoked, the steps described in [DOM] should be followed. However the MouseEvent interfaces provide additional dictionary members for initializing the internal state of the Event object’s key modifiers: specifically, the internal state queried for using the getModifierState() methods. This section supplements the DOM4 steps for intializing a new MouseEvent object with these optional modifier states.

【 `内部~UIkey修飾~状態$は， `MouseEvent$I 用に新たに導入された`修飾~UIkey状態~map$と重複するが、 後者が受持つ`~UIkey修飾~名$は，一部に限られる。 】

3.4.3.1. ~native~OS要件

この節に与える~algoは、 ~native~platform~OSが次を供することになるものと見做す： ◎ The algorithms in this section assume that the native platform OS will provide the following:

• ~nativeな~mousemove ⇒ ~mouseが動かされたときの~event （`~nativeな~mousemoveを取扱う$により取扱われる） ◎ An event when the mouse is moved (handled by handle native mouse move)
• ~nativeな~mousedown ⇒ ~mouse~buttonが押されたときの~event （`~nativeな~mousedownを取扱う$により取扱われる） ◎ An event when a mouse button is pressed (handled by handle native mouse down)
• ~nativeな~mouseup ⇒ ~mouse~buttonが離されたときの~event （`~nativeな~mouseupを取扱う$により取扱われる） ◎ An event when a mouse button is released (handled by handle native mouse up)

• ~mouse~buttonが押されたとき，それを “~click” として解釈するべきか否かを識別する仕方 （`~nativeな~clickを取扱う$により取扱われる）： ◎ A way to identify when a mouse button press should be interpreted as a "click" (handled by handle native mouse click)

  • 例えば、 ある~flagとして，あるいは別々な~eventとして ◎ For example, as a flag or as a separate event
  • 別々な “~click” ~eventとして発火する場合には、 ~native~OSは，それを対応する［ ~mouse~buttonが離されたときの~event【！"mouseup" event】 ］の直後に — その間に，~mouseに関係する他の~eventは介在することなく — 発火することになる。 ◎ If a separate "click" event is fired, then the native OS will fire it immediately after the corresponding "mouse up" event, with no intervening mouse-related events
• 所与の~clickを “~double-click” として解釈するべきか否かを識別する仕方 （`~nativeな~double-clickを取扱う$により取扱われる） ◎ A way to identify when a mouse click is a "double click" (handled by handle native mouse double click)

【 原文には触れられていないが、 これは，実質的には、 ~UAが［ 所与の~nativeな~eventが どの`文書$上で生じたか ］を決定する処理nも含意する。 以下に定義される各~algoは、 暗黙的に，当の~eventが生じた文書の文脈で遂行されるものと見做される。 】

加えて、 これらの~event用に，次に挙げる報を供することも可能であると見做す： ◎ For these events, the OS will be able to provide the following info:

• ~desktop座標 ⇒ ~native~OSの~desktop【の原点】に相対的な ( ~x, ~y ) ~mouse座標

  【 ~desktopとは何なのかは定義されていない。 】

  ◎ The x,y mouse coordinates relative to the native OS desktop

• `表示域~座標@ ⇒ ~UAの~UIwindow表示域【の原点】に相対的な ( ~x, ~y ) ~mouse座標 ◎ The x,y mouse coordinates relative to the UA’s window viewport

  【 これは、 実際には［ ~UIwindowではなく`文書$ ］の`表示域$の原点に相対的な座標として利用される。 したがって、 実質的には，当の文書が呈示される位置（~UAにより決定される）にも基づくことになる。 】

• ~keyboardにて現在~~押されている修飾~UIkeyたち 【`修飾~UIkey状態~map$に挙げる文字列で識別される。】 ◎ Which keyboard modifiers are currently being held
• `~mouse~button名@ 【この項は、この訳による補完】 ⇒ ~mouse~buttonが［ 押された／離された ］ときの~event用に，どの~buttonが［ 押された／離された ］かを識別する値として，次に挙げるいずれかが供される （それらの意味は `button$m を見よ） ⇒＃ `首~button^i, `予備~button^i, `副~button^i, `~X1~button^i, `~X2~button^i

3.4.3.2. `MouseEvent^I 用の大域的な状態

~UAは、 ~UA全体で共有される値をとして，次を保守するモノトスル ⇒ `~mouse~button~bitmask@ ⇒ 各~mouse~buttonの現在の状態を追跡する。 ◎ 4.4.3.2.1. User Agent-Level State ◎ The UA must maintain the following values that are shared for the entire User Agent. ◎ A mouse button bitmask that tracks the current state of the mouse buttons.

~UAは、 各`~window$の中で共有される値をとして，次を保守するモノトスル： ◎ 4.4.3.2.2. Window-Level State ◎ The UA must maintain the following values that are shared for the Window.

• `最後の~mouse要素@ ⇒ `MouseEvent$I が最後に送信された要素【！`Element$I】を追跡し続ける — 初期~時は ~NULL【！undefined】 とする。 ◎ A last mouse element value (initially undefined) that keeps track of the last Element that we sent a MouseEvent to.
• `最後の~mouse~DOM経路@ ⇒ 最も近過去に~mouse~eventを送信した時点における`最後の~mouse要素$の先祖~要素【！`Element$I】たちが成す~list（~snapshot） — 初期~時は空とする。 ◎ A last mouse DOM path value (initially empty) that contains a snapshot of the ancestors Elements of the last mouse element when the most recent mouse event was sent.

3.4.3.3. `MouseEvent^I 用の内部~状態

【 これは、 原文では，挙げられた各~UIkey名ごとに その名前を伴う~flagとして定義されているが、 この訳では，一つの~mapに集約することにする。 】

3.4.3.4. 各種~algo

3.4.5.1. `auxclick^et

`auxclick$et ~event型は、 利用者が非~首~pointer~buttonを［ 押してから, 離した ］とき, あるいは［ そのような動作を模造する方式で~pointerが作動化された ］ときに、 `~pointing先$が要素であるならば，それに向けて発火するモノトスル。 ~mouse~buttonがどのように作動されるかは、［ ~pointing装置, 環境設定0 ］に依存する。 例えば、 ~screen上の所在や，~buttonが押されてから離されるまでの遅延に依存することもある。 ◎ The auxclick event type MUST be dispatched on the topmost event target indicated by the pointer, when the user presses down and releases the non-primary pointer button, or otherwise activates the pointer in a manner that simulates such an action. The actuation method of the mouse button depends upon the pointer device and the environment configuration, e.g., it MAY depend on the screen location or the delay between the press and release of the pointing device button.

`auxclick^et ~eventは、 非~首~pointer~button用に限り，発火されるベキである （すなわち， `MouseEvent!I の `button$m 値 ~NEQ 0 ／ `buttons$m 値 ~GT 1 ）。 `auxclick^et ~eventは、 首~button（標準的な~mouseの左~buttonなど）からは，発火されないモノトスル。 対応する，首~buttonに結付けられた~eventについては `click$et を見よ。 ◎ The auxclick event should only be fired for the non-primary pointer buttons (i.e., when button value is not 0, buttons value is greater than 1). The primary button (like the left button on a standard mouse) MUST NOT fire auxclick events. See click for a corresponding event that is associated with the primary button.

`auxclick$et ~eventに先行して，同じ要素~上に［ `mousedown$et ／ `mouseup$et ］~eventが発火される場合もある — 他の~node型（例： ~text~node）への移動は無視rして【下記 例を見よ】。 環境設定0に依存して、 `auxclick$et ~eventは、 ~pointing装置の~buttonが押されてから離されるまでの間に ~event型［ `mouseover$et, `mousemove$et, `mouseout$et ］ 1 回以上 生じた場合にも発火されてヨイ。 ◎ The auxclick event MAY be preceded by the mousedown and mouseup events on the same element, disregarding changes between other node types (e.g., text nodes). Depending upon the environment configuration, the auxclick event MAY be dispatched if one or more of the event types mouseover, mousemove, and mouseout occur between the press and release of the pointing device button.

`auxclick$et ~event型の`既定~動作$は、 文脈依存であり，［ ~eventの`~target$ ］, および［ `MouseEvent!I の `button$m ／ `buttons$m 属性の値 ］に基づく。 `auxclick$et ~event型の代表的な`既定~動作$は、 次に従う： ◎ The default action of the auxclick event type varies based on the event target of the event and the value of the button or buttons attributes. Typical default actions of the auxclick event type are as follows:

• `~target$に結付けられた`作動化の挙動$があるならば、 `既定~動作$は，それを実行するモノトスル。 ◎ If the event target has associated activation behavior, the default action MUST be to execute that activation behavior.

%myLink.addEventListener( "auxclick", function(%e) {
   if (%e.button === 1) {
     /* 
これは既定の挙動
— 例えば ~link上で中央~clickしたときに新たな~UItabで開くなど —
を防止することになる。
◎
This would prevent the default behavior which is for example opening a new tab when middle clicking on a link.
 */
     %e.preventDefault();

     /* 
中央~buttonの~clickを取扱うために何か他を行う
— ~appに適した仕方で新たな~UItab内に ~linkや非~link~buttonを開くことに注力する様な。
~UItab帯~内の~UItabを閉じる様な，~click動作で行われるべき他の動作もここで行える。
◎
Do something else to handle middle button click like taking care of opening link or non-link buttons in new tabs in a way that fits the app. Other actions like closing a tab in a tab-strip which should be done on the click action can be done here too.
 */
   }
 });

注記： 右~buttonの事例では、 `auxclick^et ~eventは， `contextmenu$et ~eventより後に配送される。 一部の~UAは、 文脈~menuが表示されている間，すべての入力~eventを吸い取ることに注意 — そのような局面では、 `auxclick$et は~appに可用にならないであろう。 より明確には、 `次の例＠#example-auxclick-right$ を見よ。 ◎ In the case of right button, the auxclick event is dispatched after any contextmenu event. Note that some user agents swallow all input events while a context menu is being displayed, so auxclick may not be available to applications in such scenarios. See this example for more clarification.

%myDiv.addEventListener("contextmenu", function(%e) {
   /* 
この~callは、
~pageが~eventを受取ったときに，~pageに干渉するような文脈~menuは示されないようにする。
◎
This call makes sure no context menu is shown to interfere with page receiving the events.
 */
    %e.preventDefault();
});

%myDiv.addEventListener("auxclick", function(%e) {
  if (%e.button === 2) {
    /* 
右~button~clickを取扱うために何か他を行う
— ~appの内側に~custom化した文脈~menuを開く様な。
◎
Do something else to handle right button click like opening a customized context menu inside the app.
 */
 }
});

3.4.5.2. `click^et

`click$et ~event型は、 利用者が首~pointer~buttonを［ 押してから, 離した ］とき, あるいは［ そのような動作を模造する方式で~pointerが作動化された ］ときに、 `~pointing先$が要素であるならば，それに向けて発火するモノトスル。 ~mouse~buttonがどのように作動されるかは、［ ~pointing装置, 環境設定0 ］に依存する。 例えば、 ~screen上の所在や，~buttonが押されてから離されるまでの遅延に依存することもある。 ◎ The click event type MUST be dispatched on the topmost event target indicated by the pointer, when the user presses down and releases the primary pointer button, or otherwise activates the pointer in a manner that simulates such an action. The actuation method of the mouse button depends upon the pointer device and the environment configuration, e.g., it MAY depend on the screen location or the delay between the press and release of the pointing device button.

`click^et ~eventは、 首~pointer~button用に限り，発火されるベキである （すなわち， `MouseEvent!I の `button$m 値は 0 ／ `buttons$m 値は 1 ）。 `click^et ~eventは、 副~button （標準的な~mouseの［ 中央~button／右~button ］など） からは，発火されないモノトスル。 対応する，非~首~buttonに結付けられた~eventについては `auxclick$et を見よ。 ◎ The click event should only be fired for the primary pointer button (i.e., when button value is 0, buttons value is 1). Secondary buttons (like the middle or right button on a standard mouse) MUST NOT fire click events. See auxclick for a corresponding event that is associated with the non-primary buttons.

`click$et ~eventに先行して，同じ要素~上に［ `mousedown$et ／ `mouseup$et ］~eventが発火される場合もある — 他の~node型（例： ~text~node）への移動は無視rして【下記 例を見よ】。 環境設定0に依存して、 `click$et ~eventは、 ~pointing装置の~buttonが押されてから離されるまでの間に ~event型［ `mouseover$et, `mousemove$et, `mouseout$et ］ 1 回以上 生じた場合にも発火されてヨイ。 `click$et ~eventには `dblclick$et ~eventが後続してもヨイ。 ◎ The click event MAY be preceded by the mousedown and mouseup events on the same element, disregarding changes between other node types (e.g., text nodes). Depending upon the environment configuration, the click event MAY be dispatched if one or more of the event types mouseover, mousemove, and mouseout occur between the press and release of the pointing device button. The click event MAY also be followed by the dblclick event.

~event型 `click$et は、 結付けられた~pointing装置に加えて， 要素に対する作動化の一環としても発火するモノトスル。 ◎ In addition to being associated with pointer devices, the click event type MUST be dispatched as part of an element activation.

注記： ~accessibilityを最大限に得るため、 内容~作者には，~custom~control用の`作動化の挙動$を定義する際にも `click$et ~event型を利用することが奨励される — `mousedown$et ／ `mouseup$et など、 ~pointing装置に より特有な他の~event型ではなく。 `click$et ~event型は，~pointing装置（例： ~mouse）に由来するものであるが、 後続な実装において，その結付けを超えるように拡張されており、 要素を作動化するための，装置に依存しない~event型と見なせるので。 ◎ For maximum accessibility, content authors are encouraged to use the click event type when defining activation behavior for custom controls, rather than other pointing-device event types such as mousedown or mouseup, which are more device-specific. Though the click event type has its origins in pointer devices (e.g., a mouse), subsequent implementation enhancements have extended it beyond that association, and it can be considered a device-independent event type for element activation.

`click$et ~event型の`既定~動作$は、 文脈依存であり，［ ~eventの`~target$ ］, および［ `MouseEvent!I の `button$m ／ `buttons$m 属性の値 ］に基づく。 `click$et ~event型の代表的な`既定~動作$は、 次に従う： ◎ The default action of the click event type varies based on the event target of the event and the value of the button or buttons attributes. Typical default actions of the click event type are as follows:

• `~target$に結付けられた`作動化の挙動$があるならば、 `既定~動作$は，それを実行するモノトスル。 ◎ If the event target has associated activation behavior, the default action MUST be to execute that activation behavior.
• `~target$が~focus可能ならば、 `既定~動作$は，その要素に文書~focusを与えるモノトスル。 ◎ If the event target is focusable, the default action MUST be to give that element document focus.

3.4.5.3. `contextmenu^et

~UAは、 この~eventを文脈~menuを呼出す前に配送するモノトスル。 ◎ A user agent MUST dispatch this event before invoking a context menu.

`contextmenu$et ~eventが右~mouse~buttonにより誘発されたときは、 `mousedown$et ~eventより後に配送するモノトスル。 ◎ When the contextmenu event is triggered by right mouse button, the contextmenu event MUST be dispatched after the mousedown event.

注記： `contextmenu$et ~eventが `mouseup$et ~eventより前に配送されるか後に配送されるかは、 ~platformに依存する。 ◎ Depending on the platform, the contextmenu event may be dispatched before or after the mouseup event.

3.4.5.4. `dblclick^et

~UAは、［ 要素~上で~pointing装置の首~buttonが 【ある時間内に】 二回~clickされた ］とき，この~eventを発火するモノトスル。 ~double-clickの定義は、 その~targetが［ `mousedown$et ／ `mouseup$et ／ `dblclick$et ］と同じになるモノトスルことを除いて，環境設定0に依存する。 この~event型は、［ ~clickと~double-clickが同時に生じた場合は `click$et ／ 他の場合は `mouseup$et ］の後に配送するモノトスル。 ◎ A user agent MUST dispatch this event when the primary button of a pointing device is clicked twice over an element. The definition of a double click depends on the environment configuration, except that the event target MUST be the same between mousedown, mouseup, and dblclick. This event type MUST be dispatched after the event type click if a click and double click occur simultaneously, and after the event type mouseup otherwise.

`click$et ~eventと同様に， `dblclick$et ~eventが発火されるのは、 首~pointer~buttonからに限られるベキであり， 副~buttonからは発火されないモノトスル。 ◎ As with the click event, the dblclick event should only be fired for the primary pointer button. Secondary buttons MUST NOT fire dblclick events.

注記： `click$et ~eventを取消しても、 `dblclick$et ~eventが発火されるかどうかには影響しない。 ◎ Canceling the click event does not affect the firing of a dblclick event.

`click$et ~event型と同様に、 `dblclick$et ~event型の`既定~動作$は，文脈依存であり、 ~eventの`~target$および［ `MouseEvent.button$m ／ `MouseEvent.buttons$m ］属性の値に基づく。 `dblclick$et ~event型の代表的な`既定~動作$は、 `click$et ~event型のそれと合致する。 ◎ As with the click event type, the default action of the dblclick event type varies based on the event target of the event and the value of the button or buttons attributes. The typical default actions of the dblclick event type match those of the click event type.

3.4.5.5. `mousedown^et

~UAは、［ ~pointing装置の~buttonが要素~上で押された ］とき，この~eventを発火するモノトスル。 ◎ A user agent MUST dispatch this event when a pointing device button is pressed over an element.

注記： 多くの実装が、 `mousedown$et ~eventを利用して，文脈に依存する種々の`既定~動作$を開始する。 これらの既定~動作は、 この~eventを取消すことにより，防止できる。 これらの既定~動作には、 画像や~linkに対し［ ~drag／~drop ］によるヤリトリを始めたり，~text選択を開始する, 等々がある。 加えて、 ~mouse駆動な~pan~~操作 特能を供する実装もある （ `mousedown$et ~eventの配送-時に，中央~mouse~buttonが押されていた場合に作動化されるような）。 ◎ Many implementations use the mousedown event to begin a variety of contextually dependent default actions. These default actions can be prevented if this event is canceled. Some of these default actions could include: beginning a drag/drop interaction with an image or link, starting text selection, etc. Additionally, some implementations provide a mouse-driven panning feature that is activated when the middle mouse button is pressed at the time the mousedown event is dispatched.

3.4.5.6. `mouseenter^et

~UAは、［ `~pointing先$が`有効に変化-$して，ある要素とその子孫たちが成す境界に入った† ］とき、 その要素に向けて，この~eventを発火するモノトスル。 この~event型は， `mouseover$et に類似するが、 浮上しないこと, および［ 以前の`~pointing先$が要素の子孫である場合、 要素に向けて発火してはナラナイ ］点で相違する。 ◎ A user agent MUST dispatch this event when a pointing device is moved onto the boundaries of an element or one of its descendent elements. A user agent MUST also dispatch this event when the element or one of its descendants moves to be underneath the primary pointing device. This event type is similar to mouseover, but differs in that it does not bubble, and MUST NOT be dispatched when the pointer device moves from an element onto the boundaries of one of its descendent elements.

注記： この~event型と~CSS `~hover_ps 疑似類$ `CSS2$r には、 類似性がある。 `mouseleave$et ~event型も見よ。 ◎ There are similarities between this event type and the CSS :hover pseudo-class [CSS2]. See also the mouseleave event type.

3.4.5.7. `mouseleave^et

~UAは、［ `~pointing先$が`有効に変化-$して，ある要素とその子孫たちが成す境界から出た† ］とき、 その要素に向けて，この~eventを発火するモノトスル。 この~event型は， `mouseout$et に類似するが、 浮上しないこと, および［ 新たな`~pointing先$が要素の子孫である場合、 要素に向けて発火してはナラナイ ］点で相違する。 ◎ A user agent MUST dispatch this event when a pointing device is moved off of the boundaries of an element and all of its descendent elements. A user agent MUST also dispatch this event when the element or one of its descendants moves to be no longer underneath the primary pointing device. This event type is similar to mouseout, but differs in that does not bubble, and that it MUST NOT be dispatched until the pointing device has left the boundaries of the element and the boundaries of all of its children.

注記： この~event型と~CSS `~hover_ps 疑似類$ `CSS2$r には、 類似性がある。 `mouseenter$et ~event型も見よ。 ◎ There are similarities between this event type and the CSS :hover pseudo-class [CSS2]. See also the mouseenter event type.

3.4.5.8. `mousemove^et

~UAは、［ `~pointing先$が要素~上で動いた ］とき，その要素に向けて，この~eventを発火するモノトスル。 ~pointing装置が動かされる間に~eventが生じる頻度0は［ 実装／装置／~platform ］に特有であるが、 ~~持続的な動きに対しては，動きが止まる度にではなく，複数の `mousemove$et ~eventが連続して発火されるベキである。 実装には、 即応性と処理能との兼ね合いをとる最適な頻度0を決定することが奨励される。 ◎ A user agent MUST dispatch this event when a pointing device is moved while it is over an element. The frequency rate of events while the pointing device is moved is implementation-, device-, and platform-specific, but multiple consecutive mousemove events SHOULD be fired for sustained pointer-device movement, rather than a single event for each instance of mouse movement. Implementations are encouraged to determine the optimal frequency rate to balance responsiveness with performance.

注記： ~browserなどの一部の実装~環境においては、 `mousemove$et~eventは，利用者が（~mouse~buttonを押すなどして）~drag操作oを始めてから ~pointing装置が~UAの境界を離れた後も，発火し続け得る。 ◎ In some implementation environments, such as a browser, mousemove events can continue to fire if the user began a drag operation (e.g., a mouse button is pressed) and the pointing device has left the boundary of the user agent.

注記： この~eventは、 以前は DOM Level 2 Events において`取消~可能$でないと指定されていたが， 既存の~UA間の相互運用能を反映するよう変更された。 ◎ This event was formerly specified to be non-cancelable in DOM Level 2 Events, but was changed to reflect existing interoperability between user agents.

3.4.5.9. `mouseout^et

~UAは、 `~pointing先$が`有効に変化-$したとき，以前の`~pointing先$が要素であるならば、 この~eventをその要素に向けて発火するモノトスル。 この~event型は， `mouseleave$et に類似するが、 浮上すること, および［ 新たな`~pointing先$が要素の子孫であっても、 要素に向けて発火するモノトスル ］点で相違する。 ◎ A user agent MUST dispatch this event when a pointing device is moved off of the boundaries of an element or when the element is moved to be no longer underneath the primary pointing device. This event type is similar to mouseleave, but differs in that does bubble, and that it MUST be dispatched when the pointer device moves from an element onto the boundaries of one of its descendent elements.

注記： `mouseover$et ~event型も見よ。 ◎ See also the mouseover event type.

3.4.5.10. `mouseover^et

~UAは、 `~pointing先$が`有効に変化-$したとき，新たな`~pointing先$が要素であるならば、 この~eventを当の要素に向けて発火するモノトスル。 この~event型は， `mouseenter$et に類似するが、 浮上すること, および［ 以前の`~pointing先$が要素の子孫であっても、 要素に向けて発火するモノトスル ］点で相違する。 ◎ A user agent MUST dispatch this event when a pointing device is moved onto the boundaries of an element or when the element is moved to be underneath the primary pointing device. This event type is similar to mouseenter, but differs in that it bubbles, and that it MUST be dispatched when the pointer device moves onto the boundaries of an element whose ancestor element is the event target for the same event listener instance.

注記： `mouseout$et ~event型も見よ。 ◎ See also the mouseout event type.

3.4.5.11. `mouseup^et

~UAは、［ ~pointing装置の~buttonが要素~上で離された ］とき，この~eventを発火するモノトスル。 ◎ A user agent MUST dispatch this event when a pointing device button is released over an element.

注記： ~browserなど，実装~環境によっては、 `mouseup$et ~eventは，~pointing装置が~UAの境界から出たときにも発火され得る。 例： 利用者が~mouse~buttonを押して~drag操作oを始めたときなど。 ◎ In some implementation environments, such as a browser, a mouseup event can be dispatched even if the pointing device has left the boundary of the user agent, e.g., if the user began a drag operation with a mouse button pressed.

3.5.1.1. `WheelEvent^I

[`Exposed$=Window]
interface `WheelEvent@I : `MouseEvent$I {
    `WheelEvent@mc(`DOMString$ %type, optional `WheelEventInit$I %eventInitDict = {});

    // `deltaMode^m 値がとり得る定数
    const `unsigned long$ `DOM_DELTA_PIXEL$m = 0x00;
    const `unsigned long$ `DOM_DELTA_LINE$m = 0x01;
    const `unsigned long$ `DOM_DELTA_PAGE$m = 0x02;

    readonly attribute `double$ `deltaX$m;
    readonly attribute `double$ `deltaY$m;
    readonly attribute `double$ `deltaZ$m;
    readonly attribute `unsigned long$ `deltaMode$m;
};

`DOM_DELTA_PIXEL@m

`deltaMode$m 属性がこの値をとる場合、 `~delta$用の`測定~単位$は，画素~数になるモノトスル。 これは、 ほとんどの~OSや実装の環境設定における，最も代表的な事例である。 ◎ The units of measurement for the delta MUST be pixels. This is the most typical case in most operating system and implementation configurations.

`DOM_DELTA_LINE@m

`deltaMode$m 属性がこの値をとる場合、 `~delta$用の`測定~単位$は，~textの行~数になるモノトスル。 これは，多くの~form~controlに該当する。 ◎ The units of measurement for the delta MUST be individual lines of text. This is the case for many form controls.

`DOM_DELTA_PAGE@m

`deltaMode$m 属性がこの値をとる場合、 `~delta$用の`測定~単位$は，［ 単独の~screen, または ~page~~区分 ］に基いて定義される~page数になるモノトスル。 ◎ The units of measurement for the delta MUST be pages, either defined as a single screen or as a demarcated page.

`deltaX@m

`deltaY@m

`deltaZ@m

`wheel$et ~eventの既定~動作が~scrollである~UAでは、 ~eventが取消されなかった場合の値は，当該の軸に沿って~scrollされることになる（いずれかの`測定~単位$による）測定になるモノトスル。 他の場合、 これは［ 当該の軸~廻りの~wheel装置の動き ］の実装に特有な（いずれかの`測定~単位$による）測定。 ◎ deltaX, of type double, readonly • In user agents where the default action of the wheel event is to scroll, the value MUST be the measurement along the x-axis (in pixels, lines, or pages) to be scrolled in the case where the event is not cancelled. Otherwise, this is an implementation-specific measurement (in pixels, lines, or pages) of the movement of a wheel device around the x-axis. • The un-initialized value of this attribute MUST be 0.0. ◎ deltaY, of type double, readonly • In user agents where the default action of the wheel event is to scroll, the value MUST be the measurement along the y-axis (in pixels, lines, or pages) to be scrolled in the case where the event is not cancelled. Otherwise, this is an implementation-specific measurement (in pixels, lines, or pages) of the movement of a wheel device around the y-axis. • The un-initialized value of this attribute MUST be 0.0. ◎ deltaZ, of type double, readonly • In user agents where the default action of the wheel event is to scroll, the value MUST be the measurement along the z-axis (in pixels, lines, or pages) to be scrolled in the case where the event is not cancelled. Otherwise, this is an implementation-specific measurement (in pixels, lines, or pages) of the movement of a wheel device around the z-axis. • The un-initialized value of this attribute MUST be 0.0.

`未初期化~値$： 0.0 ◎ ↑

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

`deltaMode^m 属性~値は、 `~delta$値~用の`測定~単位$を指示する。 既定~値は `DOM_DELTA_PIXEL$m （画素~数）。 ◎ The deltaMode attribute contains an indication of the units of measurement for the delta values. The default value is DOM_DELTA_PIXEL (pixels).

この属性は、［ `~delta$値~用の`測定~単位$を指示する，いずれかの `DOM_DELTA_…^m 定数 ］に設定するモノトスル。 精確な測定は，［ 装置／~OS／~app ］の環境設定に特有になる。 ◎ This attribute MUST be set to one of the DOM_DELTA constants to indicate the units of measurement for the delta values. The precise measurement is specific to device, operating system, and application configurations.

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

3.5.1.2. `WheelEventInit^I

dictionary `WheelEventInit@I : `MouseEventInit$I {
    `double$ `deltaX@m = 0.0;
    `double$ `deltaY@m = 0.0;
    `double$ `deltaZ@m = 0.0;
    `unsigned long$ `deltaMode@m = 0;
};

この辞書の各~memberは、 `WheelEvent$I ~obj上の同じ名前の属性を初期化する。 それぞれがとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ deltaX, of type double, defaulting to 0.0 • See deltaZ attribute. ◎ deltaY, of type double, defaulting to 0.0 • See deltaZ attribute. ◎ deltaZ, of type double, defaulting to 0.0 • Initializes the deltaZ attribute of the WheelEvent object. Relative positive values for this attribute (as well as the deltaX and deltaY attributes) are given by a right-hand coordinate system where the X, Y, and Z axes are directed towards the right-most edge, bottom-most edge, and farthest depth (away from the user) of the document, respectively. Negative relative values are in the respective opposite directions. ◎ deltaMode, of type unsigned long, defaulting to 0 • Initializes the deltaMode attribute on the WheelEvent object to the enumerated values 0, 1, or 2, which represent the amount of pixels scrolled (DOM_DELTA_PIXEL), lines scrolled (DOM_DELTA_LINE), or pages scrolled (DOM_DELTA_PAGE) if the rotation of the wheel would have resulted in scrolling.

3.5.2.1. `wheel^et

~UAは、 ~mouse~wheelが いずれかの軸で回転されたとき — あるいは、 等価な入力~装置 （~mouse-ballや, 一部の~tabletや~touchpad, 等々） が そのような動作を模倣したとき — この~eventを発火するモノトスル。 同時に複数の軸が回転された場合の~wheel`~delta$は、 ~platformや入力~装置に依存して，［ 単独の `wheel$et ~eventにまとめて, あるいは 軸ごとに別々な `wheel$et ~eventとして ］送達されることもある。 ◎ A user agent MUST dispatch this event when a mouse wheel has been rotated around any axis, or when an equivalent input device (such as a mouse-ball, certain tablets or touchpads, etc.) has emulated such an action. Depending on the platform and input device, diagonal wheel deltas MAY be delivered either as a single wheel event with multiple non-zero axes or as separate wheel events for each non-zero axis.

`wheel$et ~event型の代表的な`既定~動作$は、 指示された量だけ文書を~scrollする （あるいは一部の事例では，~zoomする）。 この~eventが取消された場合、 実装は，文書を［ ~scroll／~zoom ］しないモノトスル （あるいは，何であれ、 この~event型に結付けられた他の実装に特有な既定~動作も）。 ◎ The typical default action of the wheel event type is to scroll (or in some cases, zoom) the document by the indicated amount. If this event is canceled, the implementation MUST NOT scroll or zoom the document (or perform whatever other implementation-specific default action is associated with this event type).

注記： ~UA や入力~装置によっては、 ~wheelが回される速度も`~delta$値に影響し得る — 高速になる程 高い`~delta$値を生産するよう。 ◎ In some user agents, or with some input devices, the speed that the wheel has been turned can affect the delta values, with a faster speed producing a higher delta value.

3.5.2.2. `wheel^et ~eventの取消~可否

`wheel$et ~eventに対し `preventDefault()$m を~callした場合、 ~scrollingを［ 防止-／中断- ］し得る。 ~UAは，~scroll処理能を最大にするためとして、 ~scrollに結付けられた `wheel^et ~event連列を成す各~eventに対し，それが — 取消されたかどうか見るために — 処理されるまで待機しなくてもヨイ。 そのような事例では、 ~UAは，生成する `wheel^et ~eventの `cancelable$m を ~F にするべきである — これは、 `preventDefault()$m を利用しても，~scrollingを［ 防止-／中断- ］し得ないことを指示する。 他の場合、 `cancelable$m は ~T になる。 ◎ Calling preventDefault on a wheel event can prevent or otherwise interrupt scrolling. For maximum scroll performance, a user agent may not wait for each wheel event associated with the scroll to be processed to see if it will be canceled. In such cases the user agent should generate wheel events whose cancelable property is false, indicating that preventDefault cannot be used to prevent or interrupt scrolling. Otherwise cancelable will be true.

特に，~UAは、 ~event用の`受動的でない~listenerは無いことを観測した＠~DOM4#observing-event-listeners$ならば， 生成するどの `wheel$et ~eventも取消~不能にする【 `cancelable^m を ~F にする】ベキである。 ◎ In particular, a user agent should generate only uncancelable wheel events when it observes that there are no non-passive listeners for the event.

3.6.1.1. `InputEvent^I

[`Exposed$=Window]
interface `InputEvent@I : `UIEvent$I {
    `InputEvent@mc(`DOMString$ %type, optional `InputEventInit$I %eventInitDict = {});

    readonly attribute `USVString$? `data$m;
    readonly attribute `boolean$ `isComposing$m;
    readonly attribute `DOMString$ `inputType$m;
};

`data@m ◎ data, of type USVString, readonly, nullable

~IMEにより生成される~Unicode文字 `Unicode$r 並びの値を保持する — `空~文字列$にもなり得る。 一連の文字は、 `UAX15$r にて定義される~Unicode正規化~形 `NFC^em による定義に従って正規化されるベキである。 ◎ data holds the value of the characters generated by an input method. This MAY be a single Unicode character or a non-empty sequence of Unicode characters [Unicode]. Characters SHOULD be normalized as defined by the Unicode normalization form NFC, defined in [UAX15]. This attribute MAY contain the empty string.

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

`isComposing@m ◎ isComposing, of type boolean, readonly

入力~eventが組成~sessionの一部として — すなわち， `compositionstart$et ~eventの後, かつ 対応する `compositionend$et ~eventの前に — 生じたならば~T。 ◎ true if the input event occurs as part of a composition session, i.e., after a compositionstart event and before the corresponding compositionend event.

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

`inputType@m ◎ inputType, of type DOMString, readonly

~eventに結付けられた［ 入力の型 ］を識別する文字列を包含する。 ◎ inputType contains a string that identifies the type of input associated with the event.

この属性に妥当な値たちが成す~listは `Input-Events$r を見よ。 ◎ For a list of valid values for this attribute, refer to the [Input-Events] specification.

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

3.6.1.2. `InputEventInit^I

dictionary `InputEventInit@I : `UIEventInit$I {
    `DOMString$? `data@m = null;
    `boolean$ `isComposing@m = false;
    `DOMString$ `inputType@m = "";
};

この辞書の各~memberは、 `InputEvent$I ~obj上の同じ名前の属性を初期化する。 それぞれがとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ data, of type DOMString, nullable, defaulting to null • Initializes the data attribute of the InputEvent object. ◎ isComposing, of type boolean, defaulting to false • Initializes the isComposing attribute of the InputEvent object. ◎ inputType, of type DOMString, defaulting to "" • Initializes the inputType attribute of the InputEvent object.

3.6.3.1. `beforeinput^et

~UAは、 ~DOMが更新されつつあるとき，この~eventを発火するモノトスル。 ◎ A user agent MUST dispatch this event when the DOM is about to be updated.

3.6.3.2. `input^et

~UAは、 ~DOMが更新された直後に，この~eventを発火するモノトスル。 ◎ A user agent MUST dispatch this event immediately after the DOM has been updated.

3.7.1.1. `KeyboardEvent^I

[`Exposed$=Window]
interface `KeyboardEvent@I : `UIEvent$I {
    `KeyboardEvent@mc(`DOMString$ %type, optional `KeyboardEventInit$I %eventInitDict = {});

    // `location$m 属性がとり得る定数
    const `unsigned long$ `DOM_KEY_LOCATION_STANDARD$m = 0x00;
    const `unsigned long$ `DOM_KEY_LOCATION_LEFT$m = 0x01;
    const `unsigned long$ `DOM_KEY_LOCATION_RIGHT$m = 0x02;
    const `unsigned long$ `DOM_KEY_LOCATION_NUMPAD$m = 0x03;

    readonly attribute `DOMString$ `key$m;
    readonly attribute `DOMString$ `code$m;
    readonly attribute `unsigned long$ `location$m;

    readonly attribute `boolean$ `ctrlKey$m;
    readonly attribute `boolean$ `shiftKey$m;
    readonly attribute `boolean$ `altKey$m;
    readonly attribute `boolean$ `metaKey$m;

    readonly attribute `boolean$ `repeat$m;
    readonly attribute `boolean$ `isComposing$m;

    `boolean$ `getModifierState$m (`DOMString$ %keyArg);
};

`DOM_KEY_LOCATION_STANDARD@m

作動化された~UIkeyは、 ~UIkeyの左／右 ~versionとして判別されるものではなく，かつ 十key（ `NumLock^cap ~UIkeyは除く）, または それに対応する~virtual~UIkeyからも出生されていないことを指示する。 ◎ The key activation MUST NOT be distinguished as the left or right version of the key, and (other than the NumLock key) did not originate from the numeric keypad (or did not originate with a virtual key corresponding to the numeric keypad).

~PC101US~keyboardの `Q^cap ~UIkey。 ◎ The Q key on a PC 101 Key US keyboard.

~PC101US~keyboardの `NumLock^cap ~UIkey。 ◎ The NumLock key on a PC 101 Key US keyboard.

~PC101US~keyboardの主区画に所在する `1^cap ~UIkey。 ◎ The 1 key on a PC 101 Key US keyboard located in the main section of the keyboard.

`DOM_KEY_LOCATION_LEFT@m

作動化された~UIkeyは、 左~UIkey所在から出生されていることを指示する （当の~UIkey用にアリな所在が複数ある場合に限る）。 ◎ The key activated originated from the left key location (when there is more than one possible location for this key).

~PC101US~keyboardの左 `Control^cap ~UIkey。 ◎ The left Control key on a PC 101 Key US keyboard.

`DOM_KEY_LOCATION_RIGHT@m

作動化された~UIkeyは、 右~UIkey所在から出生されていることを指示する （当の~UIkey用にアリな所在が複数ある場合に限る）。 ◎ The key activation originated from the right key location (when there is more than one possible location for this key).

~PC101US~keyboardの 右 `Shift^cap ~UIkey。 ◎ The right Shift key on a PC 101 Key US keyboard.

`DOM_KEY_LOCATION_NUMPAD@m

作動化された~UIkeyは、 十key, または それに 対応する~virtual~UIkeyから出生されていることを指示する （当の~UIkey用にアリな所在が複数ある場合に限る）。 `NumLock^cap ~UIkeyは常に，所在 `DOM_KEY_LOCATION_STANDARD$m を伴って符号化されるベキであることに注意。 ◎ The key activation originated on the numeric keypad or with a virtual key corresponding to the numeric keypad (when there is more than one possible location for this key). Note that the NumLock key should always be encoded with a location of DOM_KEY_LOCATION_STANDARD.

~PC101US~keyboardの ~numpadに所在する `1^cap ~UIkey。 ◎ The 1 key on a PC 101 Key US keyboard located on the numeric pad.

`key@m ◎ key, of type DOMString, readonly

押された~UIkeyに対応する`~UIkey属性~値$を保持する。 ◎ key holds a key attribute value corresponding to the key pressed.

注記： `key^m 属性は，旧来の `keyCode$m 属性には関係しない — とり得る値の集合も同じでない。 ◎ The key attribute is not related to the legacy keyCode attribute and does not have the same set of values.

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

`code@m ◎ code, of type DOMString, readonly

`code^m は、 押されている物理的~UIkeyを識別する文字列を保持する。 値は，現在の~keyboard~layoutや修飾~状態からは影響されないので、 同じ~UIkeyからは常に同じ値が返されることになる。 ◎ code holds a string that identifies the physical key being pressed. The value is not affected by the current keyboard layout or modifier state, so a particular key will always return the same value.

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

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

`location^m 属性は、 装置~上の~UIkeyの論理的な所在の指示を包含する。 ◎ The location attribute contains an indication of the logical location of the key on the device.

この属性は、［ 装置~上の~UIkeyの所在を指示する， `DOM_KEY_LOCATION-…^m 定数 ］のうちの，いずれかに設定するモノトスル。 ◎ This attribute MUST be set to one of the DOM_KEY_LOCATION constants to indicate the location of a key on the device.

【環境設定により】~UIkeyを対応付-直すことを許容する~UAは、 対応付けられた~~元の~UIkey用の `location$m 値を，新たな~UIkeyに適切な値に設定するモノトスル。 例えば， `ControlLeft$kC ~UIkeyが `KeyQ$kC ~UIkeyに対応付-直されたなら、 この属性は `DOM_KEY_LOCATION_STANDARD$m に設定するモノトスル。 逆に， `KeyQ$kC ~UIkeyが左右いずれかの `Control^cap ~UIkeyに対応付-直された場合、 それに応じて，この属性も［ `DOM_KEY_LOCATION_LEFT$m, `DOM_KEY_LOCATION_RIGHT$m ］のいずれかに設定するモノトスル。 ◎ If a user agent allows keys to be remapped, then the location value for a remapped key MUST be set to a value which is appropriate for the new key. For example, if the "ControlLeft" key is mapped to the "KeyQ" key, then the location attribute MUST be set to DOM_KEY_LOCATION_STANDARD. Conversely, if the "KeyQ" key is remapped to one of the Control keys, then the location attribute MUST be set to either DOM_KEY_LOCATION_LEFT or DOM_KEY_LOCATION_RIGHT.

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

`ctrlKey@m ◎ ctrlKey, of type boolean, readonly

`Control^cap （ control ）修飾が作動中であったならば~T ◎ true if the Control (control) key modifier was active.

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

`shiftKey@m ◎ shiftKey, of type boolean, readonly

`Shift^cap （ shift ）修飾が作動中であったならば~T。 ◎ true if the shift (Shift) key modifier was active.

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

`altKey@m ◎ altKey, of type boolean, readonly

`Alt^cap （ alternative, ~~別名 `Option^cap ）修飾が作動中であったならば~T。 ◎ true if the Alt (alternative) (or "Option") key modifier was active.

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

`metaKey@m ◎ metaKey, of type boolean, readonly

`Meta^cap（ meta ）修飾が作動中であったならば~T。 ◎ true if the meta (Meta) key modifier was active.

注記： Macintosh ~system上の `Command^cap （ `⌘^cap ）~UIkey修飾は この~UIkey修飾を利用して表現される。 ◎ The "Command" ("⌘") key modifier on Macintosh systems is represented using this key modifier.

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

`repeat@m ◎ repeat, of type boolean, readonly

~UIkeyが~~持続的に押されているならば ~T 。 ~UIkeyが~~押下げ続けられている下では、［ `keydown$et, `beforeinput$et, `input$et ］~eventが、 この順序で，~system環境設定から決定される頻度で，繰返すモノトスル。 `~UIkeyの長押し^em に対する挙動を備える携帯~機器においては、 `repeat$m 属性~値に ~T を伴う最初の~UIkey~eventが，その挙動を指示する~~役割を果たすモノトスル。 繰返され始めるまで~UIkeyを押し続ける必要がある時間の長さは、 環境設定に依存する。 ◎ true if the key has been pressed in a sustained manner. Holding down a key MUST result in the repeating the events keydown, beforeinput, input in this order, at a rate determined by the system configuration. For mobile devices which have long-key-press behavior, the first key event with a repeat attribute value of true MUST serve as an indication of a long-key-press. The length of time that the key MUST be pressed in order to begin repeating is configuration-dependent.

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

`isComposing@m ◎ isComposing, of type boolean, readonly

~UIkey~eventが組成~sessionの一部として — すなわち， `compositionstart$et ~eventの後, かつ 対応する `compositionend$et ~eventの前に — 生じたならば~T。 ◎ true if the key event occurs as part of a composition session, i.e., after a compositionstart event and before the corresponding compositionend event.

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

`getModifierState(keyArg)@m

`~UIkey値$を利用して，ある修飾の状態を~queryする。 ◎ Queries the state of a modifier using a key value.

［ %keyArg は修飾~UIkey用の`~UIkey値$であって，その~UIkeyは作動化されているならば ~T ／ ~ELSE_ ~F ］を返す。 ◎ Returns true if it is a modifier key and the modifier is activated, false otherwise.

引数 %keyArg には、 修飾`~UIkey値$を与える。 妥当な`修飾~UIkey$は、 `UIEvents-Key$r の`修飾~UIkeyの表t$にて定義される。 ◎ DOMString keyArg ◎ A modifier key value. Valid modifier keys are defined in the Modifier Keys table in [UIEvents-Key].

注記： ~appが 右, 左の修飾を判別したいと望む場合、 この情報は， ~keyboard~event, および `KeyboardEvent.location$m を利用して演繹することもできる。 ◎ If an application wishes to distinguish between right and left modifiers, this information could be deduced using keyboard events and location.

3.7.1.2. `KeyboardEventInit^I

dictionary `KeyboardEventInit@I : `EventModifierInit$I {
    `DOMString$ `key@m = "";
    `DOMString$ `code@m = "";
    `unsigned long$ `location@m = 0;
    `boolean$ `repeat@m = false;
    `boolean$ `isComposing@m = false;
};

この辞書の各~memberは、 `KeyboardEvent$I ~obj上の同じ名前の属性を初期化する。 それぞれがとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ key, of type DOMString, defaulting to "" • Initializes the key attribute of the KeyboardEvent object to the unicode character string representing the meaning of a key after taking into account all keyboard modifiers (such as shift-state). This value is the final effective value of the key. If the key is not a printable character, then it should be one of the key values defined in [UIEvents-Key]. ◎ code, of type DOMString, defaulting to "" • Initializes the code attribute of the KeyboardEvent object to the unicode character string representing the key that was pressed, ignoring any keyboard modifications such as keyboard layout. This value should be one of the code values defined in [UIEvents-Code]. ◎ location, of type unsigned long, defaulting to 0 • Initializes the location attribute of the KeyboardEvent object to one of the following location numerical constants: • DOM_KEY_LOCATION_STANDARD (numerical value 0) • DOM_KEY_LOCATION_LEFT (numerical value 1) • DOM_KEY_LOCATION_RIGHT (numerical value 2) • DOM_KEY_LOCATION_NUMPAD (numerical value 3) ◎ repeat, of type boolean, defaulting to false • Initializes the repeat attribute of the KeyboardEvent object. This attribute should be set to true if the the current KeyboardEvent is considered part of a repeating sequence of similar events caused by the long depression of any single key, false otherwise. ◎ isComposing, of type boolean, defaulting to false • Initializes the isComposing attribute of the KeyboardEvent object. This attribute should be set to true if the event being constructed occurs as part of a composition sequence, false otherwise.

3.7.3.1. `KeyboardEvent^I 用の大域的な状態

3.7.5.1. `keydown^et

~UAは、［ ~UIkeyが押された ］とき，この~eventを発火するモノトスル。 `keydown$et ~event型は装置~依存であり， 入力~装置の能力, および それらが~OSにおいて対応付けられている方法に依拠する。 この~event型は、 `~UIkey対応付け$の後に生成するモノトスル。 この~event型は、 同じ~UIkeyに結付けられた［ `beforeinput$et, `input$et, `keyup$et ］~eventの前に配送するモノトスル。 ◎ A user agent MUST dispatch this event when a key is pressed down. The keydown event type is device dependent and relies on the capabilities of the input devices and how they are mapped in the operating system. This event type MUST be generated after the key mapping. This event type MUST be dispatched before the beforeinput, input, and keyup events associated with the same key.

`keydown$et ~eventの既定~動作は，~UIkeyに依存する： ◎ The default action of the keydown event depends upon the key:

• ~UIkeyが文字に結付けられた場合の既定~動作は、［ `beforeinput$et ~event, 後続する `input$et ~event ］を発火するモノトスル。 ~UIkeyが複数の文字に結付けられた場合 （~macroを伴うものや ~dead-keyからなる連列など） の既定~動作は、 各~文字に対し［ `beforeinput$et, `input$et ］~event対を発火するモノトスル。 ◎ If the key is associated with a character, the default action MUST be to dispatch a beforeinput event followed by an input event. In the case where the key which is associated with multiple characters (such as with a macro or certain sequences of dead keys), the default action MUST be to dispatch one set of beforeinput / input events for each character
• ~UIkeyが`~text組成~system$に結付けられた場合の既定~動作は、 その~systemを立上げるモノトスル。 ◎ If the key is associated with a text composition system, the default action MUST be to launch that system
• ~UIkeyが `Tab^cap ~UIkeyの場合の既定~動作は、 `~focus~event$型にて述べたとおり，文書~focusを現在の被focus要素（もしあれば）から新たな被focus要素へ移転するモノトスル。 ◎ If the key is the Tab key, the default action MUST be to shift the document focus from the currently focused element (if any) to the new focused element, as described in Focus Event Types
• ~UIkeyが `Enter^cap ／ `~SPACEBAR^cap ~UIkeyであって, かつ 現在の~focusが状態~変化-中にある要素~上にある場合の既定~動作は、［ `click$et ~eventに加えて，~UAが~supportするならば `DOMActivate$et ~event ］を発火するモノトスル。 ◎ If the key is the Enter or (Space) key and the current focus is on a state-changing element, the default action MUST be to dispatch a click event, and a DOMActivate event if that event type is supported by the user agent.

この~eventが取消された場合、［ 結付けられた~event型は発火しないことに加え， 結付けられた動作も遂行しない ］モノトスル。 ◎ If this event is canceled, the associated event types MUST NOT be dispatched, and the associated actions MUST NOT be performed.

注記： ［ `keydown$et ／ `keyup$et ］~eventは、 伝統的に［ `文字~値$を生産する~UIkeyに限らず，他の~UIkeyの検出-法 ］にも結付けられる。 ◎ The keydown and keyup events are traditionally associated with detecting any key, not just those which produce a character value.

3.7.5.2. `keyup^et

~UAは、［ ~UIkeyが離された ］とき，この~eventを発火するモノトスル。 `keyup$et ~event型は装置~依存であり， 入力~装置の能力, および それらが~OSにおいて対応付けられている方法 に依拠する。 この~event型は，`~UIkey対応付け$の後に生成するモノトスル。 この~event型は、 同じ~UIkeyに結付けられた［ `keydown$et, `beforeinput$et, `input$et ］~eventの後に発火するモノトスル。 ◎ A user agent MUST dispatch this event when a key is released. The keyup event type is device dependent and relies on the capabilities of the input devices and how they are mapped in the operating system. This event type MUST be generated after the key mapping. This event type MUST be dispatched after the keydown, beforeinput, and input events associated with the same key.

注記： ［ `keydown$et ／ `keyup$et ］~eventは、 伝統的に［ `文字~値$を生産する~UIkeyに限らず，他の~UIkeyの検出-法 ］にも結付けられる。 ◎ The keydown and keyup events are traditionally associated with detecting any key, not just those which produce a character value.

3.8.1.1. `CompositionEvent^I

[`Exposed$=Window]
interface `CompositionEvent@I : `UIEvent$I {
    `CompositionEvent@mc(`DOMString$ %type, optional `CompositionEventInit$I %eventInitDict = {});

    readonly attribute `USVString$ `data$m;
};

`data@m ◎ data, of type USVString, readonly

`data^c は~IMEにより生成された一連の`文字~値$を保持する — `空~文字列$にもなり得る。 一連の文字は、［ `UAX15$r にて定義される~Unicode正規化~形 `NFC^em ］による定義に従って正規化されるベキである。 ◎ data holds the value of the characters generated by an input method. This MAY be a single Unicode character or a non-empty sequence of Unicode characters [Unicode]. Characters SHOULD be normalized as defined by the Unicode normalization form NFC, defined in [UAX15]. This attribute MAY be the empty string.

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

3.8.1.2. `CompositionEventInit^I

dictionary `CompositionEventInit@I : `UIEventInit$I {
    `DOMString$ `data@m = "";
};

この辞書の各~memberは、 `CompositionEvent!I ~obj上の同じ名前の属性を初期化する。 それぞれがとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ data, of type DOMString, defaulting to "" • Initializes the data attribute of the CompositionEvent object to the characters generated by the IME composition.

3.8.7.1. `compositionstart^et

~UAは、 `~text組成~system$が可能化されている下で，［ ~textの一節を組成する準備として，新たな組成~sessionが始まりつつある （または，`~text組成~system$に依存して始まった） ］とき，この~eventを発火するモノトスル。 この~event型は、 装置に依存し，［ ~text変換~systemの能力, ~OSの中へ対応付けられる方法 ］に依拠することもある。 この~event型は、 ~IMEへの~~入力が~keyboardから投入された場合は， `keydown$et ~eventの後に生成されるが、［ 発話／手書き ］認識~systemにおいては ~keyboard~eventを伴わずに送信されてもヨイ。 実装は、 `compositionstart$et ~eventの `CompositionEvent.data$m 属性を［ 文書にて現在（編集／置換~用に）選択されている~text ］で拡充してもヨイ — そうしない場合、 `空~文字列$にするモノトスル。 ◎ A user agent MUST dispatch this event when a text composition system is enabled and a new composition session is about to begin (or has begun, depending on the text composition system) in preparation for composing a passage of text. This event type is device-dependent, and MAY rely upon the capabilities of the text conversion system and how it is mapped into the operating system. When a keyboard is used to feed an input method editor, this event type is generated after a keydown event, but speech or handwriting recognition systems MAY send this event type without keyboard events. Some implementations MAY populate the data attribute of the compositionstart event with the text currently selected in the document (for editing and replacement). Otherwise, the value of the data attribute MUST be the empty string.

この~eventは、 `~text組成~system$が新たな組成~sessionを始める直前に, かつ 組成~処理により~DOMが改変される前に，発火するモノトスル。 この~eventの，`~text組成~system$用の既定~動作は、 新たな組成~sessionを開始させる。 この~eventが取消された場合、 `~text組成~system$は，現在の組成~sessionを破棄するベキである。 ◎ This event MUST be dispatched immediately before a text composition system begins a new composition session, and before the DOM is modified due to the composition process. The default action of this event is for the text composition system to start a new composition session. If this event is canceled, the text composition system SHOULD discard the current composition session.

注記： `compositionstart$et ~eventを取消すことと，`~text組成~system$自身を取消すこと （例： 取消~buttonを叩いたり, `~IME$ ~UIwindowを閉じるなど） とは、 別物である。 ◎ Canceling the compositionstart event type is distinct from canceling the text composition system itself (e.g., by hitting a cancel button or closing an IME window).

注記： ~IMEには、 進捗-中にある組成~sessionの取消~法を~supportしないものもある （例： GTK などは，~~現時点ではそのような~APIを備えていない）。 そのような事例では、 `preventDefault()$m を~callしても，この~eventの既定~動作は停止されないことになる。 ◎ Some IMEs do not support cancelling an in-progress composition session (e.g., such as GTK which doesn’t presently have such an API). In these cases, calling preventDefault() will not stop this event’s default action.

3.8.7.2. `compositionupdate^et

~UAは、［ 組成~sessionの最中に，`~text組成~system$が その作動中な~text一節を新たな文字で更新するとき ］に，この~eventを発火するベキである。 また、 配送するときは， `CompositionEvent.data$m 値にその更新を反映するモノトスル。 ◎ A user agent SHOULD dispatch this event during a composition session when a text composition system updates its active text passage with a new character, which is reflected in the string in data.

［ 進行中な組成と入力~controlとの同期cを保つ ］ような `~text組成~system$においては、 `compositionupdate$et ~eventは，その~controlが更新される前に配送するモノトスル。 ◎ In text composition systems which keep the ongoing composition in sync with the input control, the compositionupdate event MUST be dispatched before the control is updated.

`~text組成~system$には、 この情報を~DOMに公開しないものもある — その場合、 この~eventは，組成~処理nの最中には発火されないことになる。 ◎ Some text composition systems might not expose this information to the DOM, in which case this event will not fire during the composition process.

組成~sessionが取消された場合、 この~eventは， `compositionend$et ~eventの直前に — その `CompositionEvent.data$m 属性を`空~文字列$に設定した上で — 発火されることになる。 ◎ If the composition session is canceled, this event will be fired immediately before the compositionend event, and the data attribute will be set to the empty string.

3.8.7.3. `compositionend^et

~UAは、［ `~text組成~system$が 現在の組成~sessionを 完了した, または取消された ］とき，この~eventを発火するモノトスル。 この~eventは、 ~controlが更新された後に配送するモノトスル。 ◎ A user agent MUST dispatch this event when a text composition system completes or cancels the current composition session, and the compositionend event MUST be dispatched after the control is updated.

この~eventは、 `~text組成~system$が組成~sessionを完了した直後に配送される （例： `~IME$が［ 閉じられた ／ 最小~化された ／ ~focusが他へ切替えられた ／ その他~退けられた ］後に，~focusが~~元の~UAに切替わったときなど）。 ◎ This event is dispatched immediately after the text composition system completes the composition session (e.g., the IME is closed, minimized, switched out of focus, or otherwise dismissed, and the focus switched back to the user agent).

4.3.3.1. ~IME~mode~UIkey

ある種の装置では、 一部の~UIkeyに，［ `~IME$を作動化したり, 作動中な`~IME$の~modeを変更する ］ような機能性が意図されている。 これを目的とする~UIkeyは、 装置や言語~modeごとに異なるものが定義され得る。 この仕様では、 次に挙げるものが，これを目的とする~UIkeyとして定義される ⇒＃ `Alphanumeric$kY, `CodeInput$kY, `FinalMode$kY, `HangulMode$kY, `HanjaMode$kY, `Hiragana$kY, `JunjaMode$kY, `KanaMode$kY, `KanjiMode$kY, `Katakana$kY, `Romaji$kY ◎ Some keys on certain devices are intended to activate input method editor functionality, or to change the mode of an active input method editor. Custom keys for this purpose can be defined for different devices or language modes. The keys defined in this specification for this purpose are: "Alphanumeric", "CodeInput", "FinalMode", "HangulMode", "HanjaMode", "Hiragana", "JunjaMode", "KanaMode", "KanjiMode", "Katakana", and "Romaji".＼

`~IME$が作動中でない下で，これらいずれかの~UIkeyが押されたときは、 （可用なら）適切な`~IME$が，~UIkeyにより指示される~modeで作動化されるものと期待される。 ~UIkeyが押されたとき，`~IME$がすでに作動中である場合、［ 装置／~app ］に特有なふるまいに基づいて，`~IME$が 指示された~modeへ変更されたり, 異なる`~IME$が立上げられたり, あるいは無視されることもある。 ◎ When one of these keys is pressed, and no IME is currently active, the appropriate IME is expected to be activated in the mode indicated by the key (if available). If an IME is already active when the key is pressed, the active IME might change to the indicated mode, or a different IME might be launched, or the might MAY be ignored, on a device- and application-specific basis.

この仕様は、 他の~UIkey — 特定的には、 次に挙げる`~IME$に意図される操作o用の~UIkey — も定義する ⇒＃ `Accept$kY, `AllCandidates$kY, `Cancel$kY, `Convert$kY, `Compose$kY, `Zenkaku$kY （ `FullWidth^en ）, `Hankaku$kY （ `HalfWidth^en ）, `NextCandidate$kY, `NonConvert$kY, `PreviousCandidate$kY ◎ This specification also defines other keys which are intended for operation specifically with input method editors: "Accept", "AllCandidates", "Cancel", "Convert", "Compose", "Zenkaku" (FullWidth), "Hankaku" (HalfWidth), "NextCandidate", "NonConvert", and "PreviousCandidate".＼

これらの~UIkeyの機能は、 この仕様では定義されない — `~IME$機能性についての詳細は、 他の資料を見よ。 ◎ The functions of these keys are not defined in this specification — refer to other resources for details on input method editor functionality.

注記： `~IME$機能を伴う~UIkeyは、 その目的に制約されず，他の装置や実装に特有な目的があることもある。 ◎ Keys with input method editor functions are not restricted to that purpose, and can have other device- or implementation-specific purposes.