Pointer Events — Level 4

4.1.1. `MouseEvent^I

[`Exposed$=Window]
interface `MouseEvent@I : `UIEvent$I {
    `constructor$(`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

~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

横方向を縦方向に読み替える下で， `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

当の~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

横方向を縦方向に読み替える下で， `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

~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

横方向を縦方向に読み替える下で， `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 • Refer to the KeyboardEvent's ctrlKey attribute. • The un-initialized value of this attribute MUST be false. ◎ shiftKey • Refer to the KeyboardEvent's shiftKey attribute. • The un-initialized value of this attribute MUST be false. ◎ altKey • Refer to the KeyboardEvent's altKey attribute. • The un-initialized value of this attribute MUST be false. ◎ metaKey • Refer to the KeyboardEvent's metaKey attribute. • The un-initialized value of this attribute MUST be false.

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

`button@m

~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状態を［ 供する／模倣sする ］ものもあり、 そのような~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ではなく，既定の値として解釈すること。 ◎ Note 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 default value.

注記： `mousedown$et や `mouseup$et などの~eventに関係する`既定~動作$には、 利用-中にある特定の~mouse~buttonに依存するものもある。 ◎ Note 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

~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 ）も表現できるので。 ◎ Note 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を［ 供する／模倣sする ］ものもある — そのような~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が押されたことを指示する。 ◎ Note 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.

注記： 【！複製】 一部の~event — `mousedown$et や `mouseup$et など — に関係する`既定~動作$には、 どの~mouse~buttonが利用-中にあるかに依存するものもある。 ◎ Note 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

~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

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

当の~UIkeyは作動化されて［ いるならば ~T ／ いないならば ~F ］を返す。 ◎ Returns true if it is a modifier key and the modifier is activated, false otherwise.

妥当な`修飾~UIkey$は、 `UIEvents-Key$r の`修飾~UIkeyの表t$にて定義される。 ◎ DOMString keyArg • Refer to the KeyboardEvent's getModifierState() method for a description of this parameter.

【 `KeyboardEvent$I の `getModifierState()＠~UIEVENTS#dom-keyboardevent-getmodifierstate$m ~methodと同様にふるまう。 】

4.1.2. `MouseEventInit^I

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

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

この辞書の各~memberは、 `MouseEvent$I ~obj上の同じ名前の属性を初期化する。 それぞれがとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ screenX • 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 • 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 • 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 • 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 • 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 • 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 • 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された数を指示する負でない整数になるモノトスル。 どの程度の遅延で回数が 1 に設定し直されるかは、 環境設定に特有になる。 ◎ 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回数は設定し直される？ 】

4.2.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
• ~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

4.2.2. ~mouse~eventの構築-法

この節は改訂される必要がある。 ◎ Warning This section needs to be revised.

一般に、 `Event$I ~interface またはそれを継承する~interfaceの構築子が呼出されたときは， `DOM$r に述べられる手続きに従うべきである。 しかしながら、 `MouseEvent$I ~interfaceは，［ `Event$I ~objにおける`~UIkey修飾＠#keys-modifiers$の内部~状態を初期化する ］ための追加的な辞書~memberも供する。 この内部~状態は、 特定的には `getModifierState()$m ~methodを利用して~queryできる。 この節では、 `DOM$r による新たな `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 [DOM] steps for intializing a new MouseEvent object with these optional modifier states.

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

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

この節は改訂される必要がある。 ◎ Warning This section needs to be revised.

~UAは、 ~UA全体~用に共有される値をとして，次を保守するモノトスル ⇒ `~mouse~button~bitmask@ ⇒ 各~mouse~buttonの現在の状態を追跡する。 ◎ 4.2.3.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.2.3.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） — 初期~時は空とする。

  【 順序が指定されていないため、 この用語を利用している~algoにおいて~eventたちを発火する順序が不明瞭になっている。 】

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

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

この節は改訂される必要がある。 ◎ Warning This section needs to be revised.

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

4.2.5 〜 4.2.18. 各種~algo

この節を成す ほとんどの~algoは、 改訂される必要がある。

4.4.1. `auxclick^et

`auxclick$et ~event型は、 利用者が非~首~pointer~buttonを［ 押してから, 離した ］とき, あるいは［ そのような動作を模倣sする方式で~pointerが作動化された ］ときに、 `最上層な~event~target$が要素であるならば，それに向けて発火するモノトスル。 ~mouse~buttonがどのように作動されるかは、［ ~pointing装置, 環境設定 ］に依存する。 例えば、 ~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して【下記 例を見よ】。 環境設定に依存して、 `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 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 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 Example 7 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.
 */
 }
});

4.4.2. `click^et

`click$et ~event型は、 利用者が首~pointer~buttonを［ 押してから, 離した ］とき, あるいは［ そのような動作を模倣sする方式で~pointerが作動化された ］ときに、 `最上層な~event~target$が要素であるならば，それに向けて発火するモノトスル。 ~mouse~buttonがどのように作動されるかは、［ ~pointing装置, 環境設定 ］に依存する。 例えば、 ~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して【下記 例を見よ】。 環境設定に依存して、 `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型と見なせるので。 ◎ Note 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 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 target has associated activation behavior, the default action MUST be to execute that activation behavior.
• `~target$が~focus可能ならば、 `既定~動作$は，その要素に文書~focusを与えるモノトスル。 ◎ If the target is focusable, the default action MUST be to give that element document focus.

4.4.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に依存する。 ◎ Note Depending on the platform, the contextmenu event may be dispatched before or after the mouseup event.

4.4.4. `dblclick^et

`~UA$は、［ 要素~上で~pointing装置の首~buttonが 【ある時間内に】 二回~clickされた ］とき，この~eventを発火するモノトスル。 ~double-clickの定義は、 その~targetが［ `mousedown$et ／ `mouseup$et ／ `dblclick$et ］と同じになるモノトスルことを除いて，環境設定に依存する。 この~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が発火されるかどうかには影響しない。 ◎ Note Canceling the click event does not affect the firing of a dblclick event.

`click$et ~event型と同じく， `dblclick$et ~event型の`既定~動作$は、 文脈依存であり， ~eventの`~target$および［ `button$m ／ `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 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.

4.4.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駆動な~panning特能を供する実装もある （ `mousedown$et ~eventの配送-時に，中央~mouse~buttonが押されていた場合に作動化されるような）。 ◎ Note 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.

4.4.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型も見よ。 ◎ Note There are similarities between this event type and the CSS :hover pseudo-class [CSS2]. See also the mouseleave event type.

4.4.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型も見よ。 ◎ Note There are similarities between this event type and the CSS :hover pseudo-class [CSS2]. See also the mouseenter event type.

4.4.8. `mousemove^et

`~UA$は、［ `~pointing先$が要素~上で動いた ］とき，その要素に向けて，この~eventを発火するモノトスル。 ~pointing装置が動かされる間に~eventが生じる頻度は［ 実装／装置／~platform ］に特有であるが、 ~~持続的な動きに対しては，動きが止まる度にではなく，複数の `mousemove$et ~eventが連続して発火されるベキである。 実装には、 応答性と処理能との兼ね合いをとる最適な頻度を決定することが奨励される。 ◎ 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の境界から離れた後も，発火し続け得る。 ◎ Note 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間の相互運用能を反映するよう変更された。 ◎ Note This event was formerly specified to be non-cancelable in DOM Level 2 Events, but was changed to reflect existing interoperability between user agents.

4.4.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型も見よ。 ◎ Note See also the mouseover event type.

4.4.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 target for the same event listener instance.

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

4.4.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を始めたときなど。 ◎ Note 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.

4.4.X. 各種~mouse~eventに共通な文脈~情報

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

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

`target$m

`最上層な~event~target$ ◎ Event.target : topmost event target

`UIEvent$I の各~属性：

`UIEVENTS$r `§ 各種~UI~eventに共通な文脈~情報＠~UIEVENTS#_common-UI-event-context$を見よ。

`MouseEvent$I ：

`screenX$m

~screen上の~pointer位置に基づく値 ◎ MouseEvent.screenX : value based on the pointer position on the screen

`screenY$m

~screen上の~pointer位置に基づく値 ◎ MouseEvent.screenY : value based on the pointer position on the screen

`clientX$m

`表示域$の中の~pointer位置に基づく値 ◎ MouseEvent.clientX : value based on the pointer position within the viewport

`clientY$m

`表示域$の中の~pointer位置に基づく値 ◎ MouseEvent.clientY : value based on the pointer position within the viewport

`layerX$m

包含している要素の中の~pointer位置に基づく値 ◎ MouseEvent.layerX : value based on the pointer position within the containing element

`layerY$m

包含している要素の中の~pointer位置に基づく値 ◎ MouseEvent.layerY : value based on the pointer position within the containing element

`altKey$m

`Alt^cap 修飾が作動中であったなら ~T， ~ELSE_ ~F ◎ MouseEvent.altKey : true if Alt modifier was active, otherwise false

`ctrlKey$m

`Control^cap 修飾が作動中であったなら ~T， ~ELSE_ ~F ◎ MouseEvent.ctrlKey : true if Control modifier was active, otherwise false

`shiftKey$m

`Shift^cap 修飾が作動中であったなら ~T， ~ELSE_ ~F ◎ MouseEvent.shiftKey : true if Shift modifier was active, otherwise false

`metaKey$m

`Meta^cap 修飾が作動中であったなら ~T， ~ELSE_ ~F ◎ MouseEvent.metaKey : true if Meta modifier was active, otherwise false

`button$m

現在 押されている~buttonに基づく値。 ◎ MouseEvent.button : value based on current button pressed

`buttons$m

現在の押下げられているすべての~buttonに基づく値。 押された~buttonが無ければ 0 になる。 ◎ MouseEvent.buttons : value based on all buttons currently depressed, 0 if no buttons pressed

`relatedTarget$m

~NULL ◎ MouseEvent.relatedTarget : null

5.1.1. ~button状態

5.1.2. 首~pointer

複-~pointer装置（例：複-~touch） 【複数の装置ではなく，複数の同時並行な接触を~supportする~pointer装置】 に対しては、 `isPrimary$m 属性が，`首~pointer$を識別するために利用される。 各`~pointer型$に対し， `首~pointer@ （ `primary pointer^en ） とは、 その型の~pointer用の`作動中な~pointer$たちが成す集合の中で，主導的とされる~pointerである： ◎ In a multi-pointer (e.g. multi-touch) scenario, the isPrimary property is used to identify a master pointer amongst the set of active pointers for each pointer type.

• どの時点であれ、 `首~pointer$は，各`~pointer型$に対し高々一つまでとする。 ◎ At any given time, there can only ever be at most one primary pointer for each pointer type.
• 特定0の`~pointer型$に対し最初に作動中になる~pointer（例えば 複-~touchによるヤリトリなら，手指による~screenへの最初の~touch）が、 その`~pointer型$の`首~pointer$になる。 ◎ The first pointer to become active for a particular pointer type (e.g. the first finger to touch the screen in a multi-touch interaction) becomes the primary pointer for that pointer type.
• `首~pointer$のみが`互換性~mouse~event$を生産することになる。 【複数の型の~pointer装置が同時並行に利用されていて】`首~pointer$が複数ある事例では、 各~首~pointerが`互換性~mouse~event$を生産することになる。 ◎ Only a primary pointer will produce compatibility mouse events. In the case where there are multiple primary pointers, these pointers will all produce compatibility mouse events.

注記： 作者は、 欲するなら， 首~pointer以外を無視することで単独の~pointerによるヤリトリを達成できる （しかしながら，下の `複数の首~pointerについての注記＠#multiple-primary-pointers$ を見よ）。 ◎ Note Authors who desire single-pointer interaction can achieve this by ignoring non-primary pointers (however, see the note below on multiple primary pointers).

注記： 複数の型の~pointer装置が同時並行に利用されている場合、 それぞれの~pointer（各`~pointer型$【！pointerType】ごとに一つ）が首と見なされる。 例えば，同時に動いた［ ~touch接触と~mouse~cursor ］は、 どちらも首と見なされる~pointerを生産することになる。 ◎ Note When two or more pointer device types are being used concurrently, multiple pointers (one for each pointerType) are considered primary. For example, a touch contact and a mouse cursor moved simultaneously will produce pointers that are both considered primary.

注記： ~OSや~UAは、 一部の装置に対し — 偶発的なヤリトリを避けるため — 複数の型の~pointer入力の同時並行な利用を無視することもある。 一例として，［ ~touch, ~pen ］両者によるヤリトリを~supportする装置は、 ~penが利用-中にある間は — 利用者が~touchscreen上で手を休めれるよう — ~touch入力を無視することもある（この特能は “`palm rejection^en” 【 “手のひらが触れても~~無視する” 】 と共通的に称されている）。 現時点では、 作者がこの挙動を抑止することはアリでない。 ◎ Note Some devices, operating systems and user agents may ignore the concurrent use of more than one type of pointer input to avoid accidental interactions. For instance, devices that support both touch and pen interactions may ignore touch inputs while the pen is actively being used, to allow users to rest their hand on the touchscreen while using the pen (a feature commonly referred to as "palm rejection"). Currently, it is not possible for authors to suppress this behavior.

注記： ~UAが、 どの~pointerも`首~pointer$とされていない下で， ~pointer~eventを発火する可能性もある。 一例として、 特定0の型の`作動中な~pointer$が複数あって（例：複-~touchによるヤリトリ）， `首~pointer$が除去された場合（例：~screenから離された）、 首~pointerは無いことになろう。 また、 `首~pointer$が［ ~UAを~targetにしていないものも含む，装置~上で作動中かつ型も同じ~pointerすべて ］を利用して決定される~platformにおいては、 首~pointerが~UAの外側にあって，別の~pointerが~UAの内側を~targetにしている場合、 ~UAは， 後者の~pointer用に `isPrimary$m が ~F にされた`~pointer~eventを発火-$し得る。 ◎ Note In some cases, it is possible for the user agent to fire pointer events in which no pointer is marked as a primary pointer. For instance, when there are multiple active pointers of a particular type, like a multi-touch interaction, and the primary pointer is removed (e.g. it leaves the screen), there may end up being no primary pointers. Also on platforms where the primary pointer is determined using all active pointers of the same type on the device (including those targeted at an application other than the user agent), if the first (primary) pointer is outside of the user agent and other (non-primary) pointers targeted inside the user agent, then the user agent may fire pointer events for the other pointers with a value of false for isPrimary.

注記： 現在の~OSや~UAは、 通例的に複数の~mouseによる入力の概念を備えていない。 複数の~mouse装置が在る場合 （一例として、 ~trackpadと外部~mouseを備える~laptopなど）、 一般に，それらは一まとめに単独の装置として扱われる — どの装置による動きも，単独の~mouse~pointerの動きに翻訳され、 異なる~mouse装置で押される~buttonは~~区別されない。 この理由から、 ~mouse~pointerは通例的に一つだけあり，それが首~pointerになることになる。 【 したがって、 2 個の~mouseが接続されていて，互いに同種の~button（例：左~button）が［ 順に押されてから, 同じ順に離された ］とするとき、［ 2 回目に押されたとき, 1 回目に離されたとき ］は，無視されることになろう。 】 ◎ Note Current operating systems and user agents don't usually have a concept of multiple mouse inputs. When more than one mouse device is present (for instance, on a laptop with both a trackpad and an external mouse), all mouse devices are generally treated as a single device — movements on any of the devices are translated to movement of a single mouse pointer, and there is no distinction between button presses on different mouse devices. For this reason, there will usually only be a single mouse pointer, and that pointer will be primary.

5.1.3. `PointerEvent^I ~interfaceを利用する~eventの発火-法

注記： 通常の`~pointing先$に代えて`捕捉~target$を利用することは、 この仕様【！`UIEVENTS$r 】に定義されるとおり， 何らかの`境界~event$を発火する結果になり得る。 これは、 ~pointerが それまでの~targetから出て【 `pointerleave$et 】， この新たな［ それを`捕捉している~target$ ］に入った【 `pointerenter$et 】場合と同じになる。 捕捉が解放されたときにも — ~pointerが、 それを`捕捉している~target$から出て，接触判定による~targetに入るに伴い — 同じことが起こり得る。 ◎ Note Using the pointer capture target override as the target instead of the normal hit-test result may fire some boundary events, as defined by [UIEVENTS]. This is the same as the pointer leaving its previous target and entering this new capturing target. When the capture is released, the same scenario may happen, as the pointer is leaving the capturing target and entering the hit-test target.

5.1.4 ~layout変化

~pointing装置が静止中（ `stationary^en ）であるとは、［ 当の装置が~screenの物理面に相対的に移動していない ］かつ［ ~screenの各~prop【（~displayにおける）その方位や位置など】に何ら変化は生じていない ］ことをいう。 ~pointing装置は、 静止中でない間は， `§ 各種 ~pointer~event型＠#pointer-event-types$ にて定義されるとおりに`~pointer~event$を発火する。 静止中であっても，~layoutが変化したときは、 `~pointing先$に影響する結果，`境界~event$を発火させ得る【！モノトスル】。 ~UAは、 処理能の理由があるときは，これら`境界~event$の発火を遅延してもヨイ （例： 境界~event用の~event~handler【！~listener】により生じる［ 接触判定／~layout変化 ］†が多過ぎになることを避けるため）。 ◎ A pointing device that moved relative to the screen surface or underwent some change in any of its properties fires various events as defined in Pointer Event types. For a stationary pointing device (that neither moved relative to the screen surface nor underwent any change in any properties), the user agent MUST fire certain boundary events after a layout change that affected the hit test target for the pointer, see pointerover, pointerenter, pointerout and pointerleave for details. The user agent MAY delay the firing of these boundary events because of performance reasons (e.g. to avoid too many hit-tests or layout changes caused by boundary event listeners).

【† 例えば，~event~handlerが~pageの~styleを変更することにより。 したがって， “遅延する”とは、 `~event~loop$の各~反復における そのような発火の回数を抑制することを意味する。 】

注記： 静止中な~pointing装置は、 `pointermove$et ~eventを決して発火しない。 ◎ Note A stationary pointing device (that neither moved relative to the screen surface nor underwent any change in any properties) never fires a pointermove event.

5.1.5. ［ `tiltX^m, `tiltY^m ］と［ `altitudeAngle^m, `azimuthAngle^m ］の間の変換-法

`~pointer~event$は、 ~transducerに相対的な~X-Z平面の方位を表出するためとして， 2 つの相補的な属性~組を含む： ◎ Pointer Events include two complementary sets of attributes to express the orientation of a transducer relative to the X-Y plane:＼

• (T)： `tiltX$m, `tiltY$m （元の Pointer Events 仕様にて導入された） ◎ tiltX / tiltY (introduced in the original Pointer Events specification), and＼
• (A)： `altitudeAngle$m, `azimuthAngle$m （ `Touch Events, ~level 2＠~TOUCHEVENTS$cite 仕様から採用された） ◎ azimuthAngle / altitudeAngle (adopted from the Touch Events - Level 2 specification).

特定の［ ~hardware, ~platform ］に依存して、 ~UAは，~transducer方位に相対的な~screen平面~用の値として［ 上の属性~組 (T), (A) ］のうち片方しか受取らない見込みが高い。 ~UAは，これらの値を変換するときは、 以下の~algo【次の例に述べられる変換-法】を利用するモノトスル。 ◎ Depending on the specific hardware and platform, user agents will likely only receive one set of values for the transducer orientation relative to the screen plane — either tiltX / tiltY or altitudeAngle / azimuthAngle. User agents MUST use the following algorithm for converting these values.

~UAは，上の (A) から (T) を計算するときは、 `Math.round$c の規則 `ECMASCRIPT$r を利用して，整数~値を最終的に丸めるベキである。 ◎ When the user agent calculates tiltX / tiltY from azimuthAngle / altitudeAngle it SHOULD round the final integer values using Math.round [ECMASCRIPT] rules.

const π = Math.PI;  /* 
【これは、以下を読み易くするための，この訳による追加。】
 */

function spherical2tilt(%altitudeAngle, %azimuthAngle) {
  const %radToDeg = 180/π;

  let %tiltXrad = 0;
  let %tiltYrad = 0;

  if (%altitudeAngle == 0) {
    /* 
~penは~X-Y平面~内にある
◎
the pen is in the X-Y plane
 */
    if (%azimuthAngle == 0 || %azimuthAngle == 2*π) {
      /* 
~penは正な~X軸~上にある
◎
pen is on positive X axis
 */
      %tiltXrad = π/2;
    }
    if (%azimuthAngle == π/2) {
      /* 
~penは正な~Y軸~上にある
◎
pen is on positive Y axis
 */
      %tiltYrad = π/2;
    }
    if (%azimuthAngle == π) {
      /* 
~penは負な~X軸~上にある
◎
pen is on negative X axis
 */
      %tiltXrad = -π/2;
    }
    if (%azimuthAngle == 3*π/2) {
      /* 
~penは負な~Y軸~上にある
◎
pen is on negative Y axis
 */
      %tiltYrad = -π/2;
    }
    if (%azimuthAngle > 0 && %azimuthAngle < π/2) {
      %tiltXrad = π/2;
      %tiltYrad = π/2;
    }
    if (%azimuthAngle > π/2 && %azimuthAngle < π) {
      %tiltXrad = -π/2;
      %tiltYrad = π/2;
    }
    if (%azimuthAngle > π && %azimuthAngle < 3*π/2) {
      %tiltXrad = -π/2;
      %tiltYrad = -π/2;
    }
    if (%azimuthAngle > 3*π/2 && %azimuthAngle < 2*π) {
      %tiltXrad = π/2;
      %tiltYrad = -π/2;
    }
  }

  if (%altitudeAngle != 0) {
    const %tanAlt = Math.tan(%altitudeAngle);

    %tiltXrad = Math.atan(Math.cos(%azimuthAngle) / %tanAlt);
    %tiltYrad = Math.atan(Math.sin(%azimuthAngle) / %tanAlt);
  }

  return {"tiltX": %tiltXrad * %radToDeg, "tiltY": %tiltYrad * %radToDeg};
}

function tilt2spherical(%tiltX, %tiltY) {
  const %tiltXrad = %tiltX * π/180;
  const %tiltYrad = %tiltY * π/180;

  /* 
方位角を計算する
◎
calculate azimuth angle
 */
  let %azimuthAngle = 0;

  if (%tiltX == 0) {
    if (%tiltY > 0) {
      %azimuthAngle = π/2;
    }
    else if (%tiltY < 0) {
      %azimuthAngle = 3*π/2;
    }
  } else if (%tiltY == 0) {
    if (%tiltX < 0) {
      %azimuthAngle = π;
    }
  } else if (Math.abs(%tiltX) == 90 || Math.abs(%tiltY) == 90) {
    /* 
方位角を計算するための情報が足らない
◎
not enough information to calculate azimuth
 */
    %azimuthAngle = 0;
  } else {
    /* 
非~境界~事例：
%tiltX, %tiltY どちらも 90 の倍数でない
◎
Non-boundary case: neither tiltX nor tiltY is equal to 0 or +-90
 */
    const %tanX = Math.tan(%tiltXrad);
    const %tanY = Math.tan(%tiltYrad);

    %azimuthAngle = Math.atan2(%tanY, %tanX);
    if (%azimuthAngle < 0) {
      %azimuthAngle += 2*π;
    }
  }

  /* 
仰角を計算する
◎
calculate altitude angle
 */
  let %altitudeAngle = 0;

  if (Math.abs(%tiltX) == 90 || Math.abs(%tiltY) == 90) {
      %altitudeAngle = 0
  } else if (%tiltX == 0) {
    %altitudeAngle = π/2 - Math.abs(%tiltYrad);
  } else if (%tiltY == 0) {
    %altitudeAngle = π/2 - Math.abs(%tiltXrad);
  } else {
    /* 
非~境界~事例：
%tiltX, %tiltY どちらも 90 の倍数でない
◎
Non-boundary case: neither tiltX nor tiltY is equal to 0 or +-90
 */
    %altitudeAngle =  Math.atan(1.0/Math.sqrt(Math.pow(Math.tan(%tiltXrad),2) + Math.pow(Math.tan(%tiltYrad),2)));
  }

  return {"altitudeAngle": %altitudeAngle, "azimuthAngle": %azimuthAngle};
}

5.3.1. `pointerover@et ~event

5.3.2. `pointerenter@et ~event

注記： `pointerenter$et は、 `pointerover$et に類似するが，次において相違する ⇒＃ 浮上しない。 その配送には子孫~要素の`接触判定$境界も考慮される。 ◎ Note This event type is similar to pointerover but with two differences: pointerenter does not bubble, and its dispatch considers the hit test boundaries of even descendant elements.

注記： ［ この型の~event, `mouseenter$et ~event `UIEVENTS$r, ~CSSの `~hover_ps 疑似類$ `CSS21$r ］の間には類似性がある。 `pointerleave$et ~eventも見よ。 ◎ Note There are similarities between this event type, the mouseenter event described in [UIEVENTS], and the CSS :hover pseudo-class described in [CSS21]. See also the pointerleave event.

5.3.3. `pointerdown@et ~event

［ ~pointerの~buttonが非`作動~状態$から`作動~状態$へ遷移した ］とき，`~pointing先$が要素である（ ~NULL でない）ならば、 名前 `pointerdown$et の`~pointer~eventを発火する$モノトスル。 【この段落を成す他の内容は，作動~状態の定義に移譲。】 ◎ The user agent MUST fire a pointer event named pointerdown when a pointer enters the active buttons state. For mouse, this is when the device transitions from no buttons depressed to at least one button depressed. For touch, this is when physical contact is made with the digitizer. For pen, this is when the pen either makes physical contact with the digitizer without any button depressed, or transitions from no buttons depressed to at least one button depressed while hovering.

注記： ~mouse（または他の複-~button~pointer装置）に対しては、 このことは，［［ `mousedown$et ／ `mouseup$et ］が発火されるときと同じ状況下で，常に［ `pointerdown$et ／ `pointerup$et ］が発火されるとは限らない ］ことを意味する。 `~buttonの追加押下げ$を見よ。 ◎ Note For mouse (or other multi-button pointer devices), this means pointerdown and pointerup are not fired for all of the same circumstances as mousedown and mouseup. See chorded buttons for more information.

入力~装置が`~hoverを~supportしない$場合には、 `pointerdown$et ~eventを配送するより先に，順に，名前［ `pointerover$et, `pointerenter$et ］の`~pointer~eventを発火する$モノトスル。 ◎ For input devices that do not support hover, the user agent MUST also fire a pointer event named pointerover followed by a pointer event named pointerenter prior to dispatching the pointerdown event.

【 ~hoverを~supportする装置の~pointerが［ ~UIwindow外から瞬時に移動してきて，一瞬だけ静止した後、 作動~状態に遷移した ］ときの挙動と同様になる。 】

注記： 作者は、 `pointerdown$et ~eventを取消して（その `isPrimary$m 属性が ~T ならば）， ある種の`互換性~mouse~event$の発火を防止できる。 これは、 ~pointerの`~mouse~eventは防止するか$を ~T にする。 ただし、［ `mouseover$et ／ `mouseenter$et ／ `mouseout$et ／ `mouseleave$et ］~eventの発火は防止されないことに注意。 ◎ Note Authors can prevent the firing of certain compatibility mouse events by canceling the pointerdown event (if the isPrimary property is true). This sets the PREVENT MOUSE EVENT flag on the pointer. Note, however, that this does not prevent the mouseover, mouseenter, mouseout, or mouseleave events from firing.

5.3.4. `pointermove@et ~event

~pointerの~propのうち［ `pointerdown$et ／ `pointerup$et ］~eventを発火しないものが変化したときは、 名前 `pointermove$et の`~pointer~eventを発火する$モノトスル。 ◎ The user agent MUST fire a pointer event named pointermove when a pointer changes any properties that don't fire pointerdown or pointerup events.＼

該当する~propには、 次に挙げるものが含まれる ⇒＃ 座標／ 押圧／ 接線方向~圧／ 傾き／ ~twist／ `接触~幾何$（ `width$m, `height$m ）／ `~buttonの追加押下げ$ ◎ This includes any changes to coordinates, pressure, tangential pressure, tilt, twist, contact geometry (width and height) or chorded buttons.

`~UA$は、 `pointermove^et ~eventの配送を遅延してもヨイ （一例として，処理能の理由で）。 `合体された~event群$の情報は、 それ用に配送される 1 個の `pointermove$et ~event内に， `getCoalescedEvents()$m ~methodを介して公開されることになる。 `~UA$は、 この~eventの~targetを合体された~event群の最終-座標を利用して見出すベキである。 ◎ User agents MAY delay dispatch of the pointermove event (for instance, for performance reasons). The coalesced events information will be exposed via thegetCoalescedEvents method for the single dispatched pointermove event. The final coordinates of such events should be used for finding the target of the event.

5.3.5. `pointerrawupdate@et ~event

~pointerの~propのうち［ `pointerdown$et ／ `pointerup$et ］~eventを発火しないものが変化したときには （該当する~propについては、 `pointermove$et を見よ）、 `~secureな文脈$enVの中に限り， 名前 `pointerrawupdate$et の`~pointer~eventを発火する$モノトスル： ◎ The user agent MUST fire a pointer event named pointerrawupdate, and only do so within a secure context, when a pointer changes any properties that don't fire pointerdown or pointerup events. See pointermove event for a list of such properties.

• `~UA$は、 `pointerrawupdate$et ~eventを［ アリな限り早く, ~JSが~eventを取扱える限りの~rate ］で配送するベキである — `pointermove$et とは対照的に。 ◎ In contrast with pointermove, user agents SHOULD dispatch pointerrawupdate events as soon as possible and as frequently as the JavaScript can handle the events.
• `pointerrawupdate$et ~eventの `target$m は、 `pointermove$et ~eventのそれとは異なるかもしれない — 後者は、 遅延されたり合体され得るので。 また， `target^m を見出すために利用される最終-位置は、 合体された各~eventとは異なり得る。 ◎ The target of pointerrawupdate events might be different from the pointermove events due to the fact that pointermove events might get delayed or coalesced, and the final position of the event which is used for finding the target could be different from its coalesced events.
• `~event~loop$内に［ 同じ `pointerId$m を伴う別の `pointerrawupdate$et ~event ］を配送する`~task$が まだある場合、 `~UA$は — 新たな`~task$を作成する代わりに — その~eventに新たな `pointerrawupdate$et を合体してもヨイことに注意。 よって，それらの~eventは、 `~event~loop$内で処理される時点で［ 1 個の `pointerrawupdate$et ~eventに`合体された~event群$ ］として送達され得ることになる。 さらなる情報は `getCoalescedEvents()$m を見よ。 ◎ Note that if there is already another pointerrawupdate with the same pointerId that hasn't been dispatched in the event loop, the user agent MAY coalesce the new pointerrawupdate with that event instead of creating a new task. This may cause pointerrawupdate to have coalesced events, and they will all be delivered as coalesced events of one pointerrawupdate event as soon as the event is processed in the event loop. SeegetCoalescedEvents for more information.
• 【！In terms of ordering of ...】 `~UA$は、 ~platformから［ `pointerrawupdate$et, `pointermove$et ］両~eventを生じさせるような更新を受取った場合には， `pointerrawupdate$et ~eventから先に配送するモノトスル。 ◎ In terms of ordering of pointerrawupdate and pointermove, if the user agent received an update from the platform that causes both pointerrawupdate and pointermove events, then the user agent MUST dispatch the pointerrawupdate event before the corresponding pointermove.
• `target$m 以外の~event属性については、［ 最後の `pointermove$et ~event以降に配送された すべての `pointerrawupdate$et ~event ］が成す合体d~event~listたちが成す連結（ `concatenation^en ）【意図不明】は、 次回の `pointermove$et ~eventの合体d~eventたちと同じになる。 ◎ Other than the target, the concatenation of coalesced events lists of all dispatched pointerrawupdate events since the last pointermove event is the same as the coalesced events of the next pointermove event in terms of the other event attributes.＼
• `pointerrawupdate$et の各種~属性のほとんどは、 `pointermove$et のそれらと同じになる — 例外として， `pointerrawupdate$et 用には、 `cancelable$m は ~F にするモノトスル。 ◎ The attributes of pointerrawupdate are mostly the same as pointermove, with the exception of cancelable which MUST be false for pointerrawupdate.
• `~UA$は、 `pointerrawupdate$et 用には，`互換性~mouse~event$を発火しないベキである。 ◎ User agents SHOULD not fire compatibility mouse events for pointerrawupdate.

注記： `pointerrawupdate$et ~event用の~listenerを追加すると、 ~UAの実装によっては，~web~pageの処理能に悪影響を及ぼすかもしれない。 ほとんどの利用事例では、 他の型の~pointer~eventで足るはずである。 そのような~listenerは、 ~scriptが［ 高~頻度な~eventが必要で，それだけ速くそれらを取扱える場合 ］に限り，追加されるベキである。 これらの事例では、 他の型の~pointer~eventを~listenする必要はおそらく無い。 ◎ Note Adding listeners for the pointerrawupdate event might negatively impact the performance of the web page, depending on the implementation of the user agent. For most use cases the other pointerevent types should suffice. A pointerrawupdate listener should only be added if JavaScript needs high frequency events and can handle them just as fast. In these cases, there is probably no need to listen to other types of pointer events.

5.3.6. `pointerup@et ~event

`~UA$は、 ~pointerの~buttonが`作動~状態$から非`作動~状態$へ遷移したときは， 名前 `pointerup$et の`~pointer~eventを発火する$モノトスル。 【この段落を成す他の内容は，作動~状態の定義に移譲。】 ◎ The user agent MUST fire a pointer event named pointerup when a pointer leaves the active buttons state. For mouse, this is when the device transitions from at least one button depressed to no buttons depressed. For touch, this is when physical contact is removed from the digitizer. For pen, this is when the pen is removed from the physical contact with the digitizer while no button is depressed, or transitions from at least one button depressed to no buttons depressed while hovering.

`~UA$は、 入力~装置が`~hoverを~supportしない$場合には， `pointerup$et ~eventを配送した後に［ 順に，名前 `pointerout$et, `pointerleave$et の`~pointer~eventを発火する$ ］モノトスル。 ◎ For input devices that do not support hover, the user agent MUST also fire a pointer event named pointerout followed by a pointer event named pointerleave after dispatching the pointerup event.

【 ~hoverを~supportする装置の~pointerが［ 非~作動~状態に遷移してから、 一瞬だけ静止した後，瞬時に~UIwindow外へ移動した ］ときの挙動と同様になる。 】

どの `pointerup$et ~eventにおいても、 `pressure$m の値は 0 になる。 ◎ All pointerup events have a pressure value of 0.

`~UA$は、 当の~pointerが現在`捕捉-$されている場合には， `~pointer捕捉を暗黙的に解放する$モノトスル。 ◎ The user agent MUST also implicitly release the pointer capture if the pointer is currently captured.

注記： ~mouse（または他の複-~button~pointer装置）に対しては、 このことは，［［ `mousedown$et ／ `mouseup$et ］が発火されるときと同じ状況下で，常に［ `pointerdown$et ／ `pointerup$et ］が発火されるとは限らない ］ことを意味する。 `~buttonの追加押下げ$を見よ。 ◎ Note For mouse (or other multi-button pointer devices), this means pointerdown and pointerup are not fired for all of the same circumstances as mousedown and mouseup. See chorded buttons for more information.

5.3.7. `pointercancel@et ~event

`~UA$は、 `~pointer~event~streamを抑止する局面$を検出したときは， 名前 `pointercancel$et の`~pointer~eventを発火する$モノトスル： ◎ The user agent MUST fire a pointer event named pointercancel when it detects a scenario to suppress a pointer event stream.

`pointercancel$et ~eventは、 次に従うモノトスル： ◎ ↓

• 次に挙げる~propは、［ その取消nに先行して配送された~pointer~event ］のうち［ 同じ `pointerId$m を伴うもの ］のうち［ 最後のもの ］と同じ値をとる ⇒＃ `width$m, `height$m, `pressure$m, `tangentialPressure$m, `tiltX$m, `tiltY$m, `twist$m, `altitudeAngle$m, `azimuthAngle$m, `pointerType$m, `isPrimary$m, `UIEVENTS$r から継承した各~座標 ◎ The values of the following properties of the pointercancel event MUST match the values of the last dispatched pointer event with the same pointerId: width, height, pressure, tangentialPressure, tiltX, tiltY, twist, altitudeAngle, azimuthAngle, pointerType, isPrimary, and the coordinates inherited from [UIEVENTS].＼
• ［ `合体d~event~list$, `予測d~event~list$ 【！the coalescedEvents and predictedEvents lists】 ］は空。 ◎ The coalescedEvents and predictedEvents lists in the pointercancel event MUST be empty,＼
• `cancelable$m 属性は ~F をとる。 ◎ and the event's cancelable attribute MUST be false.

5.3.8. `pointerout@et ~event

5.3.9. `pointerleave@et ~event

注記： `pointerleave$et は、 `pointerout$et に類似するが，次において相違する ⇒＃ 浮上しない。 その配送には子孫~要素の`接触判定$境界も考慮される。 ◎ Note This event type is similar to pointerout but with two differences: pointerleave does not bubble, and its dispatch considers the hit test boundaries of even descendant elements.

注記： ［ この型の~event, `mouseleave$et ~event `UIEVENTS$r, ~CSSの `~hover_ps 疑似類$ `CSS21$r ］の間には類似性がある。 `pointerenter$et ~eventも見よ。 ◎ Note There are similarities between this event type, the mouseleave event described in [UIEVENTS], and the CSS :hover pseudo-class described in [CSS21]. See also the pointerenter event.

5.3.10. `gotpointercapture@et ~event

`~UA$は、 ~pointerが要素に`捕捉-$されたときは， 名前 `gotpointercapture$et の`~pointer~eventを発火する$モノトスル。 その~pointer用の後続な~eventは、 この要素に向けて発火されることになる。 ［ `§ ~pointer捕捉の設定-法＠#setting-pointer-capture$ ／ `§ 処理待ち~pointer捕捉の処理-法＠#process-pending-pointer-capture$ ］を見よ。 ◎ The user agent MUST fire a pointer event named gotpointercapture when an element receives pointer capture. This event is fired at the element that is receiving pointer capture. Subsequent events for that pointer will be fired at this element. See the setting pointer capture and process pending pointer capture sections.

5.3.11. `lostpointercapture@et ~event

`~UA$は、 要素による`~pointer捕捉$が解放されたときは， 名前 `lostpointercapture$et の`~pointer~eventを発火する$モノトスル。 この~eventは、 ~pointerが捕捉から解放された後に生じるどの~eventよりも先に発火するモノトスル。 ~pointerによる後続な~eventのうち［ `click$et, `auxclick$et, `contextmenu$et ］~eventを除くすべてにおいて、 その~targetは，通常の`~pointing先$になる。 ［ `§ ~pointer捕捉の解放-法＠#releasing-pointer-capture$ ／ `§ ~pointer捕捉の暗黙的な解放-法＠#implicit-release-of-pointer-capture$ ／ `§ 処理待ち~pointer捕捉の処理-法＠#process-pending-pointer-capture$ ］を見よ。 ◎ The user agent MUST fire a pointer event named lostpointercapture after pointer capture is released for a pointer. This event MUST be fired prior to any subsequent events for the pointer after capture was released. This event is fired at the element from which pointer capture was removed. All subsequent events for the pointer except click, auxclick, and contextmenu events follow normal hit testing mechanisms (out of scope for this specification) for determining the event target. See the releasing pointer capture, implicit release of pointer capture, and process pending pointer capture sections.

5.3.12. `click^et ／ `auxclick^et ／ `contextmenu^et ~event

この節は、 `UIEVENTS$r にて定義される［ `click$et, `auxclick$et, `contextmenu$et ］~eventに対する追加である。 これらの~eventは、 概して~UIの作動化に束ねられており， ~pointerでない入力~装置（~keyboardなど）からも発火されるので。 ◎ This section is an addition to click, auxclick and contextmenu events defined in [UIEVENTS]. These events are typically tied to user interface activation, and are fired even from non-pointer input devices, such as keyboards.

これらの~eventは、 `PointerEvent$I になるモノトスル — 加えて、 この節を成す以降に言及される追加的な要件の~subjectになる。 ◎ These events MUST be of type PointerEvent, and are subject to the additional requirements mentioned in the rest of this section.

6.1.1. `WheelEvent^I

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

    /* 
`deltaMode^m 値がとり得る定数
◎
DeltaModeCode */
    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の行l数になるモノトスル。 これは，多くの~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装置の動きの（いずれかの`測定~単位$による）測定 ］になる。 ◎ 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. ◎ 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. ◎ 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^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.

6.1.2. `WheelEventInit^I

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

この辞書の各~memberは、 `WheelEvent$I ~obj上の同じ名前の属性を初期化する。 各自がとり得る値とその意味については、 その~interface定義の記述を見よ。 ◎ deltaX • See deltaZ attribute. ◎ deltaY • See deltaZ attribute. ◎ deltaZ • 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 • 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.

6.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$値を生産するよう。 ◎ Note 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.

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