Pointer Events — Level 2

1. 序論

今日のほとんどの `HTML5$r 内容は、 ~mouse入力~向けに利用され／設計されている。 入力を~custom方式で取扱う~codeは、 概して `~mouse~event$向けに書かれている。 しかしながら，今日のより新たな~computing機器は、 ~touchscreen, ~pen入力, 等々も含む，他の形による入力も組入れている。 これらの入力~形の各々に対し，それを取扱うための~event型が個別に提案されてきている。 しかしながら，そのような~approachでは、 新たな型の入力~用に~supportが追加される度に，不必要な~logicの重複や, ~eventの取扱いにおける~overheadも招かれ易くなる。 これはまた、 内容が ある型の装置のみを念頭に書かれるときにも，互換性の問題を生じさせ易い。 加えて、 ~mouse用に書かれている既存の内容との互換性のため、 ほとんどの`~UA$は，どの型の入力に対しても`~mouse~event$を発火する。 このため、 `~mouse~event$が［ 実際の~mouse装置を表現している ］のか, ［ 別の型の入力~装置から，互換性のために生産されたもの ］なのか，多義的になり、 双方の型の装置に対応する~codeを書くのも難しくなっている。 ◎ Today, most [HTML5] content is used with and/or designed for mouse input. Those that handle input in a custom manner typically code to [UIEVENTS] Mouse Events. Newer computing devices today, however, incorporate other forms of input, including touchscreens, pen input, etc. Event types have been proposed for handling each of these forms of input individually. However, that approach often incurs unnecessary duplication of logic and event handling overhead when adding support for a new input type. This often creates a compatibility problem when content is written with only one device type in mind. Additionally, for compatibility with existing mouse-based content, most user agents fire Mouse Events for all input types. This makes it ambiguous whether a Mouse Event represents an actual mouse device or is being produced from another input type for compatibility, which makes it hard to code to both device types simultaneously.

複数の入力~型に対応する~codeを書く手間を減らすため，および 上に述べた`~mouse~event$の多義性に~~対処し易くするため、 この仕様は，`~pointer$と呼ばれる より抽象的な入力~形を定義する。 ［ ~mouse~cursor, ~pen, ~touch（複-~touchも含む）, その他 ］の~pointing装置により ~screen上に入力される どの接触~点も，~pointerになり得る。 この~modelにより、 利用者~側の~hardwareを問わず，~siteや~appを上手く働くように書くことは、 より容易になる。 装置に特有な取扱いが欲される局面においては、 この仕様は，当の~eventを生産した装置の型を検分するための属性も定義する。 ◎ To reduce the cost of coding to multiple input types and also to help with the above described ambiguity with Mouse Events, this specifications defines a more abstract form of input, called a pointer. A pointer can be any point of contact on the screen made by a mouse cursor, pen, touch (including multi-touch), or other pointing input device. This model makes it easier to write sites and applications that work well no matter what hardware the user has. For scenarios when device-specific handling is desired, this specification also defines properties for inspecting the device type which produced the event.＼

この仕様の首な目標は、［ 装置に依らない~pointer入力に対応する著作は より容易にする ］一方で，［ 利用者体験の~~向上に必要yな所では 装置に特有な取扱いに限り許容する ］ような、 一式の［ ~event, および~interface ］を供することである。 ◎ The primary goal is to provide a single set of events and interfaces that allow for easier authoring for cross-device pointer input while still allowing for device-specific handling only when necessary for an augmented experience.

~~第二の目標は、［ ~UAが，~script実行を阻むことなく, 既定の~touch動作（~scrollingなど）を取扱える ］ように，複-~thread化も可能化することである。 ◎ An additional key goal is to enable multi-threaded user agents to handle default touch actions, such as scrolling, without blocking on script execution.

注記： この仕様は、 種々の~pointer入力~用に 統一された~event~modelを定義する。 ~keyboardに類する~UIなど，他の形の入力は、 この~modelは受持たない（一例として、 ~touchscreenのみの装置~上で稼働中の~screenreaderや類似な支援技術 — ~focus可能な［ ~controlや要素 ］を通して，利用者による連列的~naviを許容するような）。 その種の~UIに呼応して~pointer~eventを生成する~UAもあるかもしれないが、 それについては，この仕様は受持たない。 ◎ While this specification defines a unified event model for a variety of pointer inputs, this model does not cover other forms of input such as keyboards or keyboard-like interfaces (for instance, a screenreader or similar assistive technology running on a touchscreen-only device, which allows users sequential navigation through focusable controls and elements). While user agents might choose to also generate pointer events in response to these interfaces, this scenario is not covered in this specification.

注記： 作者には、 まず~~第一に，どの形の入力に対しても `focus$et, `blur$et, `click$et などの高~levelな~eventで応答することで，等価な機能性を供することが奨励される。 しかしながら、 低~levelな~event（`~pointer~event$など）を利用するときは、 すべての型の入力~用の~supportを確保することが奨励される。 ~keyboardに類する~UIの事例においては、 これには，~keyboard~event用の明示的な取扱いの追加を要することもある。 詳細は、 `WCAG 2.0 指針 2.1＠~TR/WCAG20/#keyboard-operation$ 見よ。 ◎ In the first instance, authors are encouraged to provide equivalent functionality for all forms of input by responding to high-level events such as focus, blur and click. However, when using low-level events (such as Pointer Events), authors are encouraged to ensure that all types of input are supported. In the case of keyboards and keyboard-like interfaces, this might require the addition of explicit keyboard event handling. See WCAG 2.0 Guideline 2.1 for further details.

汎用~pointer入力を取扱うための~eventは、 ~mouse用のものとよく似る： `pointerdown$et, `pointermove$et, `pointerup$et, `pointerover$et, `pointerout$et, 等々。 これにより、 内容を，各種`~mouse~event$から`~pointer~event$へ移行するのも容易になる。 `~pointer~event$は、 各種`~mouse~event$に在る通例の属性すべて（ ~client座標, ~target要素, ~button状態, 等々 ）を供することに加え、 他の形の入力 — 押圧（ `pressure^en ）, `接触~幾何$（ `contact geometry^en ）, 傾き（ `tilt^en ）, 等々 — のための新たな属性も供する。 作者は、 `~pointer~event$の~codeを，異なる【装置】型の入力~間で同じ~logicを共有するように書くことが容易になり、 利用者体験の~~向上に必要yな所に限って，特定0の型の入力を~custom化できる。 ◎ The events for handling generic pointer input look a lot like those for mouse: pointerdown, pointermove, pointerup, pointerover, pointerout, etc. This facilitates easy content migration from Mouse Events to Pointer Events. Pointer Events provide all the usual properties present in Mouse Events (client coordinates, target element, button states, etc.) in addition to new properties for other forms of input: pressure, contact geometry, tilt, etc. So authors can easily code to Pointer Events to share logic between different input types where it makes sense, and customize for a particular type of input only where necessary to get the best experience.

様々な入力~装置が`~pointer~event$の~sourceになり得るが、 `~pointer~event$が，他の［ 何らかの装置に特有な~eventの集合（例： 各種 `~mouse~event$, ~touch~event, 等々） ］に属する~eventに伴って生成されるものとして定義されることはない。 この仕様は、 他の装置に特有な~eventの~supportは，要求しない。 そうすることもアリであり，互換性のために奨励されるが。 ~UAは、 他のどの装置~eventも~supportすることなく，~pointer~eventを~supportできる。 ［ ~mouseに特有な~event用に書かれた内容 ］との互換性のため、 この仕様は，［ ~mouse以外の装置による~pointer入力に基づいて，`互換性~mouse~event$を生成する ］ための方法も述べる。 ◎ While Pointer Events are sourced from a variety of input devices, they are not defined as being generated from some other set of device-specific events. While possible and encouraged for compatibility, this spec does not require other device-specific events be supported (e.g. mouse events, touch events, etc.). A user agent could support pointer events without supporting any other device events. For compatibility with content written to mouse-specific events, this specification does provide an optional section describing how to generate compatibility mouse events based on pointer input from devices other than a mouse.

この仕様は、［ `~pointer~event$と `TOUCH-EVENTS$r に定義される~touch~eventの両者とも~supportする~UA ］に期待される挙動について，何も~~述べない。 これら二つの仕様の関係性についての更なる情報は、 `Touch Events Community Group＠https://www.w3.org/community/touchevents/$ を見よ。 ◎ This specification does not provide any advice on the expected behavior of user agents that support both Touch Events (as defined in [TOUCH-EVENTS]) and Pointer Events. For more information on the relationship between these two specifications, see the Touch Events Community Group.

2. 適合性

【 以下、 この節の他の内容は `~W3C日本語訳 共通~page＠~W3Ccommon#conformance$ に移譲。 】

【この訳に特有な表記規約】

3. 例

この仕様に定義される~APIの利用を以下の作者~code例にデモる。 ◎ The following are example author code that demonstrates how the APIs in this specification might be used.

/* 
`~pointer~event$, または［
伝統的 ~touch／~mouse
］のいずれかを~bindする
◎
Bind to either Pointer Events or traditional touch/mouse
 */

if (window.PointerEvent) {
    /* 
`~pointer~event$が~supportされる場合は、
~pointer~eventのみを~listenする
◎
if Pointer Events are supported, only listen to pointer events
 */
    %target.addEventListener("pointerdown", function(%event) {
        /* 
必要yなら、［
~touch／~pen／~mouse
］に対する異なる挙動~用に，
%event`.pointerType^c
に基づいて，別々な~logicを適用する
◎
if necessary, apply separate logic based on e.pointerType for different touch/pen/mouse behavior
 */
        ...
    });
    ...
} else {
    /* 
伝統的な ~touch／~mouse ~event~handler
◎
traditional touch/mouse event handlers
 */
    %target.addEventListener('touchstart', function(%event) {
        /* 
互換性~mouse~eventと~clickを防止する
◎
prevent compatibility mouse events and click
 */
        %event.preventDefault();
        ...
    });
    ...
    %target.addEventListener('mousedown', ...);
    ...
}

/* 
~keyboardを取扱うための，追加的な~event~listener
◎
additional event listeners for keyboard handling
 */
...

window.addEventListener("pointerdown", %detectInputType);

function detectInputType(%event) {
    switch(%event.pointerType) {
        case "mouse":
            /* 
~mouse入力が検出された
◎
mouse input detected
 */
            break;
        case "pen":
            /* 
~pen／~stylus入力が検出された
◎
pen/stylus input detected
 */
            break;
        case "touch":
            /* 
~touch入力が検出された
◎
touch input detected
 */
            break;
        case "":
            /* 
空~文字列は、
~UAが検出できない装置を意味する
◎
↓ */
            break;
        default:
            /* 
~UAに特有な~custom型
◎
pointerType is empty (could not be detected) or UA-specific custom type
 */
    }
}

<style>
  /* 
`~touch用の既定の挙動$（~pan-zoomなど）を不能化して、
`canvas^e 要素~上のすべての~eventを，~appに仕向ける。
◎
Disable intrinsic user agent touch behaviors (such as panning or zooming) so that all events on the canvas element are given to the application instead.
 */

  canvas { 
    `touch-action$p: none; 
  }
</style>

<canvas
    id="drawSurface"
    width="500px" height="500px"
    style="border:1px solid black;"
></canvas>

<script>
    var %canvas = document.getElementById("drawSurface"),
    %context = %canvas.getContext("2d");

    if (window.PointerEvent) {
        %canvas.addEventListener("pointermove", paint);
        if(window.navigator.maxTouchPoints > 1) {
    	   /* 
~UAと~hardwareは複-~touchを~supportする
◎
user agent and hardware support multi-touch
 */
        }
    }
    else {
        /* 
`~pointer~event$を~supportしない~UA用の~fallback
◎
provide fallback for user agents that do not support Pointer Events
 */
        %canvas.addEventListener("mousemove", paint);
    }

    function paint(%event) {
        if(%event.buttons > 0)
    	   %context.fillRect(%event.clientX, %event.clientY, 5, 5);
    }

    /* 
~keyboardを取扱うための，追加的な~event~listener／関数
◎
additional event listeners/functions for keyboard handling
 */
    ...

</script>

<div style=
    "position:absolute;
    top:0px; left:0px;
    width:100px; height:100px;"
></div>
<script>
window.addEventListener("pointerdown", checkPointerSize);

function checkPointerSize(%event) {
    %event.target.style.width = %event.width + "px";
    %event.target.style.height = %event.height + "px";
}
</script>

var %event = new PointerEvent("pointerover", {
    bubbles: true,
    cancelable: true,
    composed: true,
    pointerId: 42,
    pointerType: "pen",
    clientX: 300,
    clientY: 500
});
eventTarget.dispatchEvent(%event); 

4. 用語集

~pointerの~buttonが`作動~状態@にある

`~pointer~event$の `buttons$m 属性が非 0 値をとる条件を満たしている：

• ~mouseに対しては、 装置にて何らかの~buttonが押下されているとき。
• ~touchに対しては、 `~digitizer$との物理的~接触があるとき。
• ~penに対しては、 ~penによる`~digitizer$との物理的~接触があるとき, または ~hover中にいずれかの~buttonが押下されているとき。

◎ The condition when a pointer has a non-zero value for the buttons property. For mouse, this is when the device has at least one button depressed. For touch, this is when there is physical contact with the digitizer. For pen, this is when either the pen has physical contact with the digitizer, or at least one button is depressed while hovering.

`作動中な~pointer@, または 単に~pointer†

~touch接触, ~penや~stylus, ~mouse~cursor, その他，~eventを生産し得るような~pointer。 所与の~pointer（ `pointerId$m により一意に識別される）が，文書の中で追加的な~eventを生産し得るならば、 その~pointerは，依然として作動中と見なされる。 例えば： ◎ Any touch contact, pen stylus, mouse cursor, or other pointer that can produce events. If it is possible for a given pointer (identified by a unique pointerId) to produce additional events within the document, then that pointer is still considered active. Examples:

• 機器に接続された~mouseは、 常に作動中と見なされる。 ◎ A mouse connected to the device is always active.
• ~screen上の~touch接触は、 作動中と見なされる。 ◎ A touch contact on the screen is considered active.
• ~touch接触／~penや~stylus が`~digitizer$の範囲を超えるように持上げられた場合、 それは もはや作動中とは見なされない。 ◎ If a touch contact or pen stylus is lifted beyond the range of the digitizer, then it is no longer considered active.

注記： ~platformによっては、 `作動中な~pointer$の集合には，~UAを~targetにしていない（例： 他の~appを~targetにしている）ものも含め，装置へのすべての~pointer入力も含まれる。 ◎ On some platforms, the set of active pointers includes all pointer input to the device, including any that are not targeted at the user agent (e.g. those targeted at other applications).

【† `~pointer~event$を生産する装置を意味する用語として， “`~pointer$” が下に定義されていて，紛らわしいが、 ~event処理の文脈における，語 “~pointer” は，この`作動中な~pointer$を（暗黙的に）指している — 定義により，作動中でない~pointer`装置^emからは~eventは生じ得ないので。 すなわち，~pointerは、 装置が同じであっても，`作動中な$ 各~期間ごとに別々な~instanceを表現する（原文には明示的にそう記されていないが、 そう解釈しなければ，~modelをきちんと定義できなくなる）。 】

各 `作動中な~pointer$には、 少なくとも`~top-level閲覧~文脈$ `HTML$r の視野の中では，同じ識別子（ `pointerId$m ）が付与されるべきである。 しかしながら、 複数の`~top-level閲覧~文脈$にまたがって そうなる保証は，ない。 ◎ Each active pointer should have the same id within the scope of the top-level browsing context (as defined by [HTML]). However, there is no such guarantee across multiple top-level browsing contexts.

`取消された@~event （ `canceled event^en ）

`UIEVENTS$r, `HTML$r の定義に従って，`既定~動作$が防止された~event — `preventDefault()$m により ／ ~event~handlerから ~F が返されたため ／ 他の手段により。 ◎ An event whose default action was prevented by means of preventDefault(), returning false in an event handler, or other means as defined by [UIEVENTS] and [HTML].

`接触~幾何@（ `contact geometry^en ）

`~digitizer$上で入力された~~地点を囲う矩形域（最も共通的なものは，~touch ）。 これは概して、 ~pointer入力の分解能が単独の画素より粗い装置を指す 【指先の大きさなど】 。 この~dataを全く報告しない装置もある。 ◎ The bounding box of an input (most commonly, touch) on a digitizer. This typically refers to devices with coarser pointer input resolution than a single pixel. Some devices do not report this data at all.

`~digitizer@ （ `digitizer^en ）

物理面に接触-あるいは近接している入力を検出できる型の入力~感知器。 最も共通的なものは、［ ~touch接触／~penや~stylus ］からの入力を感知する物理面である。 ◎ A type of input sensing device in which a surface can detect input which is in contact and/or in close proximity. Most commonly, this is the surface that senses input from the touch contact or a pen stylus.

`接触判定@ （ `hit test^en ）

~UAが `~pointer~event$用の~target要素を決定する処理-。 これは概して、 ~pointerの所在, および ~screen媒体~上の文書~内の要素たちの視覚的な~layoutを考慮して決定される。 接触判定の仕組みは、 この仕様の視野から外れる。 ◎ The process by which a user agent determines a target element for a pointer event. Typically, this is determined by considering the pointer's location and also the visual layout of elements in a document on screen media.

【 `~pointer捕捉$は，この仕組みを上書きする。 】

`~pointer@ （ `pointer^en ）

~screen上の特定の座標（または座標の集合）を~targetに捉えられる入力~装置 — ~mouse, ~pen, ~touch接触 など — の，~hardwareに不問な表現。 ◎ A hardware agnostic representation of input devices that can target a specific coordinate (or set of coordinates) on a screen, such as a mouse, pen, or touch contact.

【 上に述べたように、 この語は，`作動中な~pointer$を意味する場合もある。 】

`~UA@ （ `user agent^en ）

~browserや内容~著作~toolなど，通常は~client~machine上で稼働中の~programであって、 利用者に利するように，内容を［ 検索取得- ／ 解釈- ／ 実行- ／ 呈示- ／ 作成- ］するものとして動作するもの。 ◎ A program, such as a browser or content authoring tool, normally running on a client machine, which acts on a user's behalf in retrieving, interpreting, executing, presenting, or creating content.

`~taskを~queueする@ （ `queue a task^en ）`HTML5$r

【 この用語は利用されていないので、 和訳は省略する。 ◎ Adding the task to events task queue of the relevant event loop, as defined in [HTML5].

【 以下に挙げる用語は、 この訳による補完, もしくは明示的な定義／集約。 】

`~event連列@

`作動中な~pointer$から所定の順序で同期的に生じる一連の~event。

`~mouse~event@ （ `Mouse Events^en ）

`UIEVENTS$r にて定義される各種~mouse~eventのうち， `click$et, `dblclick$et を除くものの総称（ `mouseXXX^et ~event — 概ね、 `MouseEvent$I ~interfaceを実装しつつ， `PointerEvent$I など，拡張された~interfaceは実装しない~event）。

`~pointer~event@ （ `Pointer Events^en ）

この仕様にて定義される各種~pointer~eventの総称（言い換えれば、 `PointerEvent$I ~interfaceを実装する~event）。

`~pointing先@ （ `pointing^en 先 ）

`作動中な~pointer$に対し，`接触判定$により決定される要素。

`捕捉~込みの~pointing先@

~pointerを捕捉している要素がある場合、 ~event配送の目的において`~pointing先$とされ得るものは，要素または その子孫に拘束されることもある。 すなわち，ある要素 %要素 が`作動中な~pointer$を`捕捉$している（すなわち， %要素 は その~pointerの`処理待ち捕捉~target$である）, かつ `~pointing先$は［ %要素 でも その子孫でもない ］ならば %要素 ／ 他の場合は`~pointing先$。

`境界~event@ （ `boundary event^en ）

`~pointing先$が要素~境界をまたいだときに生じる~eventの総称 — 具体的には，次に挙げるものなど【正確には定義されていない】 ⇒ `pointerover$et, `pointerout$et, `pointerenter$et, `pointerleave$et

~touch （ `touch^en ）

~penなどの装置を介さない、 人の手指による入力。

接触（ `contact^en ）

`~digitizer$が検出できる程に，物理的に接触-／近接している状態を意味する。

`~touch用の既定の挙動@

~UAにより定義される，~touch入力~用の既定の挙動（表示域の~pan-zoomなど）。

`~mouse~eventは防止するか@ （ `PREVENT MOUSE EVENT^c ~flag ）

真偽値 — 初期時は ~F とする。 これは、 ~pointer装置の各~型に結び付けられる。 ~T にされたときは、 その型の~pointer装置からは`互換性~mouse~event$は，生成されなくなる。

各 `作動中な~pointer$には、 次に挙げるものが結付けられる：

`捕捉~target@ （ `pointer capture target override^en ）

`処理待ち捕捉~target@ （ `pending pointer capture target override^en ）

要素, または ~NULL（初期~値）。 これらは，`~pointer捕捉$の制御に利用され、 当の~pointerにより生じる~eventの~targetを上書きする。

5. 各種~pointer~eventと各種~interface

dictionary `PointerEventInit@I : `MouseEventInit$I {
    long      `pointerId@m = 0;
    double    `width@m = 1;
    double    `height@m = 1;
    float     `pressure@m = 0;
    float     `tangentialPressure@m = 0;
    long      `tiltX@m = 0;
    long      `tiltY@m = 0;
    long      `twist@m = 0;
    DOMString `pointerType@m = "";
    boolean   `isPrimary@m = false;
};

[`Exposed$=Window]
interface `PointerEvent@I : `MouseEvent$I {
    constructor(DOMString %type, optional `PointerEventInit$I %eventInitDict = {});
    readonly attribute long      `pointerId$m;
    readonly attribute double    `width$m;
    readonly attribute double    `height$m;
    readonly attribute float     `pressure$m;
    readonly attribute float     `tangentialPressure$m;
    readonly attribute long      `tiltX$m;
    readonly attribute long      `tiltY$m;
    readonly attribute long      `twist$m;
    readonly attribute DOMString `pointerType$m;
    readonly attribute boolean   `isPrimary$m;
};

6. `Element^I ~interfaceに対する拡張

以下の各~節では、 `HTML5$r にて定義される既存の `Element^I ~interfaceに対する拡張を述べる。 これにより、 ~scriptは，~pointer捕捉を設定-／解放できるようになる。 ◎ The following section describes extensions to the existing Element interface, defined in [HTML5], to facilitate the setting and releasing of pointer capture.

partial interface `Element!I {
    undefined `setPointerCapture$m(long %pointerId);
    undefined `releasePointerCapture$m(long %pointerId);
    boolean `hasPointerCapture$m(long %pointerId);
};

`setPointerCapture(pointerId)@m

コレが［ %pointerId により識別される~pointer ］を`捕捉$するよう`設定-$する。 この~pointerにより生じる後続な~eventに対しては、 当の~pointerが常に それを捕捉している~targetに重なっているかのように，通常の接触判定の結果は~targetに置き換えられ、 この捕捉が解放されるまで，常にコレを~targetにするモノトスル。 この~methodが有効になるのは，~pointerの~buttonが`作動~状態$にあるときに限られ、 そうでなければ，何もしないモノトスル。 %pointerId が`作動中な$どの~pointerにも合致しない場合、 `NotFoundError^E 例外が投出される。 ◎ Sets pointer capture for the pointer identified by the argument pointerId to the element on which this method is invoked. For subsequent events of the pointer, the capturing target will substitute the normal hit testing result as if the pointer is always over the capturing target, and they MUST always be targeted at this element until capture is released. The pointer MUST be in its active buttons state for this method to be effective, otherwise it fails silently. Throws a DOMException with the name NotFoundError when the provided method's argument does not match any of the active pointers.

【 ~methodの定義は、 `§ ~pointer捕捉の設定-法＠#setting-pointer-capture$に。 】

`releasePointerCapture(pointerId)@m

コレが`捕捉$している［ %pointerId により識別される~pointer ］を`明示的に解放-$する。 すなわち、 ~pointerにより生じる後続な~eventにおける~targetは、 通常の`~pointing先$になる。 %pointerId が`作動中な$どの~pointerにも合致しない場合、 `NotFoundError^E 例外が投出される。 ◎ Releases pointer capture for the pointer identified by the argument pointerId from the element on which this method is invoked. Subsequent events for the pointer follow normal hit testing mechanisms (out of scope for this specification) for determining the event target. Throws a DOMException with the name NotFoundError when the provided the method's argument does not match any of the active pointers.

【 ~methodの定義は、 `§ ~pointer捕捉の解放-法＠#releasing-pointer-capture$に。 】

`hasPointerCapture(pointerId)@m

コレが［ %pointerId により識別される~pointer ］を`捕捉$しているかどうかを指示する。 すなわち、［ %pointerId 用の`処理待ち捕捉~target$ ~EQ コレ ならば ~T ／ ~ELSE_ ~F ］を返す。 ◎ Indicates whether the element on which this method is invoked has pointer capture for the pointer identified by the argument pointerId. In particular, returns true if the pending pointer capture target override for pointerId is set to the element on which this method is invoked, and false otherwise.

注記： この~methodは、 `setPointerCapture()$m を~callした直後において， 当の要素が まだ `gotpointercapture$et ~eventを受取っていなくても、 ~T を返す。 その結果、 `pointerdown$et ~event用の~listenerの内側から`暗黙的な~pointer捕捉$を検出するときに有用になる。 ◎ This method will return true immediately after a call to setPointerCapture, even though that element will not yet have received a gotpointercapture event. As a result it can be useful for detecting implicit pointer capture from inside of a pointerdown event listener.

7. `GlobalEventHandlers^I ~mixinに対する拡張

この節では、 既存の `GlobalEventHandlers$I ~mixin `HTML5$r に対し，~event~handlerを登録し易くするための拡張を述べる。 ◎ The following section describes extensions to the existing GlobalEventHandlers interface, defined in [HTML5], to facilitate the event handler registration.

partial interface mixin `GlobalEventHandlers!I {
    attribute `EventHandler^I `ongotpointercapture@m;
    attribute `EventHandler^I `onlostpointercapture@m;
    attribute `EventHandler^I `onpointerdown@m;
    attribute `EventHandler^I `onpointermove@m;
    attribute `EventHandler^I `onpointerup@m;
    attribute `EventHandler^I `onpointercancel@m;
    attribute `EventHandler^I `onpointerover@m;
    attribute `EventHandler^I `onpointerout@m;
    attribute `EventHandler^I `onpointerenter@m;
    attribute `EventHandler^I `onpointerleave@m;
};

これらの属性は、 いずれも，対応する名前の~event型~用の`~event~handler~IDL属性$ `HTML5$r である。 ◎ ongotpointercapture ◎ The event handler IDL attribute (see [HTML5]) for the gotpointercapture event type. ◎ onlostpointercapture ◎ The event handler IDL attribute (see [HTML5]) for the lostpointercapture event type. ◎ onpointerdown ◎ The event handler IDL attribute (see [HTML5]) for the pointerdown event type. ◎ onpointermove ◎ The event handler IDL attribute (see [HTML5]) for the pointermove event type. ◎ onpointerup ◎ The event handler IDL attribute (see [HTML5]) for the pointerup event type. ◎ onpointercancel ◎ The event handler IDL attribute (see [HTML5]) for the pointercancel event type. ◎ onpointerover ◎ The event handler IDL attribute (see [HTML5]) for the pointerover event type. ◎ onpointerout ◎ The event handler IDL attribute (see [HTML5]) for the pointerout event type. ◎ onpointerenter ◎ The event handler IDL attribute (see [HTML5]) for the pointerenter event type. ◎ onpointerleave ◎ The event handler IDL attribute (see [HTML5]) for the pointerleave event type.

8. `Navigator^I ~interfaceに対する拡張

装置の検出~supportを供するため、 この仕様は， `Navigator^I ~interface `HTML5$r を拡張する。 ◎ The Navigator interface is defined in [HTML5]. This specification extends the Navigator interface to provide device detection support.

partial interface `Navigator!I {
    readonly    attribute long `maxTouchPoints$m;
};

`maxTouchPoints@m

装置により~supportされる同時~touch接触の最大~数。 複数の`~digitizer$を備える装置の事例では（例： 複数の~touchscreen）、 値は，［ 個々の~digitizerにより~supportされる最大~接触~数 ］のうちの最大になるモノトスル。 ◎ The maximum number of simultaneous touch contacts supported by the device. In the case of devices with multiple digitizers (e.g. multiple touchscreens), the value MUST be the maximum of the set of maximum supported contacts by each individual digitizer.

例えば、 装置が 3 つの~touchscreenを備えていて ~supportする同時~touch接触~数が 2, 5, 10 ならば、 `maxTouchPoints$m 値は `10^c にされるべきである。 ◎ For example, suppose a device has 3 touchscreens, which support 2, 5, and 10 simultaneous touch contacts, respectively. The value of maxTouchPoints should be 10.

注記： `maxTouchPoints$m に対する 0 より大きい値が，利用者の装置が~touch入力を~supportすることを指示するとしても、 利用者が~touch入力を利用している`とは限らない^em。 作者は、［ ~mouse, ~pen, ~screenreader, 等々 ］，~system上に在り得る他の入力~様式も考慮するよう気を付けるべきである。 ◎ While a maxTouchPoints value of greater than 0 indicates the user's device is capable of supporting touch input, it does not necessarily mean the user will use touch input. Authors should be careful to also consider other input modalities that could be present on the system, such as mouse, pen, screen readers, etc.

注記： `maxTouchPoints$m は、［ 現在の~hardwareでも，内容の対話~modelを認識できるようにする ］ことを確保するために利用されることが多い。 ~hardware~~能力がより限られた下でも、 利用者に~UI ~affordancesを供することはできる。 精確な最大~接触~数が既知でない~platform上では、 認識されることが保証される最小~数が供される。 したがって、 認識される~touch接触~数が `maxTouchPoints$m の値を超過する可能性もある。 ◎ maxTouchPoints is often used to ensure that the interaction model of the content can be recognized by the current hardware. UI affordances can be provided to users with less capable hardware. On platforms where the precise number of touch points is not known, the minimum number guaranteed to be recognized is provided. Therefore, it is possible for the number of recognized touch points to exceed the value of maxTouchPoints.

9. ~touch用の既定の挙動~用の候補~領域の宣言-法

~touch入力に対しては、 どの`~pointer~event$であれ，その`既定~動作$は 表示域の操作（例： ~pan-zoom）にならないモノトスル。 ◎ For touch input, the default action of any and all pointer events MUST NOT be a manipulation of the viewport (e.g. panning or zooming).

注記： ~touch操作は、 意図的に，~pointer~eventの`既定~動作$にされていない。 この，［ ~eventの取消nに対する依存関係 ］を除去することは、 ~UAによる処理能の最適化を手助けするためである。 ◎ Touch manipulations are intentionally not a default action of pointer events. Removing this dependency on the cancellation of events facilitates performance optimizations by the user agent.

注記： 表示域の操作-時に利用される~pointerに関する課題は，一般に~touch入力に限られるが（利用者の手指が，内容とのヤリトリ-にも, ~pageの~pan／~zoomにも利用され得る所で）、 他の`~pointer型$に対しても（直接的／間接的を問わず）同じ型の操作を許容する~UAも中にはある。 一例として，携帯~装置／~tablet装置においては、 利用者は~stylusを利用して~panすることもできるかもしれない。 この節は、 そのような局面にも適用される（この仕様における語 “~touch” の用-法にかかわらず）。 ◎ While the issue of pointers used to manipulate the viewport is generally limited to touch input (where a user's finger can both interact with content and pan/zoom the page), certain user agents may also allow the same types of (direct or indirect) manipulation for other pointer types. For instance, on mobile/tablet devices, users may also be able to pan using a stylus. This section applies to these scenarios as well (despite the specification's use of "touch").

<div style="touch-action: none;">

この要素は、
すべての~touchに対し~pointer~eventを受取る。
◎
This element receives pointer events for all touches.

</div>

<div style="touch-action: pan-x;">

この要素は、
横方向へ~panしていないときは~pointer~eventを受取る
◎
This element receives pointer events when not panning in the horizontal direction.

</div>

<div style="overflow: auto;">
    <div style="touch-action: none;">

この要素は、
すべての~touchに対し~pointer~eventを受取る。
◎
This element receives pointer events for all touches.

    </div>
    <div>

この要素~上の~touchは、
親を操作するために消費され得る。
◎
Touches on this element MAY be consumed for manipulating the parent.

    </div>
</div>

<div style="overflow: auto;">
    <div style="touch-action: pan-y;">
        <div style="touch-action: pan-x;">

この要素は、
すべての~touchに対し~pointer~eventを受取る
— 横方向への~panningのみを許容する要素と `auto$v 先祖との間には，縦方向の~panningのみを許容する先祖があるので。
したがって、
要素に対しては，`~touch用の既定の挙動$は許容されない。
◎
This element receives pointer events for all touches because
it allows only horizontal panning yet an intermediate ancestor 
(between it and the pannable element) only allows vertical panning. 
Therefore, no touch behaviors are allowed.

        </div>
    </div>
</div>

10. ~pointer捕捉

11. ~mouse~eventとの互換性のための対応付け

今日の~web内容では、 `~mouse~event$向けのみに書かれている~codeが大勢を占めている。 ~UAは、 その種の内容との互換性を得るためとして，以下に与える~algoにより，汎用~pointer入力を~mouse~eventに対応付けてもヨイ。 ◎ The vast majority of web content existing today codes only to Mouse Events. The following describes an algorithm for how a user agent MAY map generic pointer input to mouse events for compatibility with this content.

互換性のための ~mouse~eventへの対応付けは、 この仕様の任意選択な特能である。 ~UAには、 既存の旧来の内容との最良な互換性を得るために，この特能を~supportすることが奨励される。 `互換性~mouse~event$を~supportしない~UAにも、 依然として `click$et, `contextmenu$et ~eventは~supportすることが奨励される（下の注記を見よ）。 ◎ The compatibility mapping with mouse events are an OPTIONAL feature of this specification. User agents are encouraged to support the feature for best compatibility with existing legacy content. User agents that do not support compatibility mouse events are still encouraged to support the click and contextmenu events (see the note below).

作者は、 `pointerdown$et ~eventを取消すことにより， 一定の`互換性~mouse~event$の生産を防止できる。 ◎ Authors can prevent the production of certain compatibility mouse events by canceling the pointerdown event.

注記： ~mouse~eventは、 ~pointerの~buttonが押されたときにのみ防止できる。 ~hoverしている~pointer（例： どの~buttonも押されていない~mouse）による~mouse~eventは、 防止できない。 加えて、［ `mouseover$et, `mouseout$et, `mouseenter$et, `mouseleave$et ］~eventは，（~pointerの~buttonが押されていても）決して防止されない。 ◎ Mouse events can only be prevented when the pointer is down. Hovering pointers (e.g. a mouse with no buttons pressed) cannot have their mouse events prevented. And, the mouseover, mouseout, mouseenter, and mouseleave events are never prevented (even if the pointer is down).

12. ~securityと~privacy上の考慮点

この付録では、 Pointer Events 実装における~securityと~privacy上の考慮点について論じる。 論点は、 この仕様に定義される［ ~event~model, ~API, ~event ］の実装から直に発生する ~security／~privacy 上の課題に限られる。 ◎ This appendix discusses security and privacy considerations for Pointer Events implementations. The discussion is limited to security and privacy issues that arise directly from implementation of the event model, APIs and events defined in this specification.

この仕様に定義される~event型の多くは、 利用者の動作に呼応して配送される。 これは、 悪意的な~event~listenerが［ 概して，利用者が機密的と考える情報 ］ — 例：利用者が~pageとヤリトリしている間の［ ~mouse／~stylus／手指 ］の正確な経路や動きなど — への~accessを得られるようにする。 ◎ Many of the event types defined in this specification are dispatched in response to user actions. This allows malicious event listeners to gain access to information users would typically consider confidential, e.g., the exact path/movement of a user's mouse/stylus/finger while interacting with a page.

~pointer~eventは、 追加的な情報を（利用者の装置が~supportする所で）包含する — ~pen入力に保持されている角度や傾き／ 接触~物理面の幾何／ ~stylusや~touch~screen上に~~感知された押圧 など。 ［ 角度, 傾き, 幾何, 押圧 ］の情報は、 利用者~機器の~sensorに直に関係する。 すなわち、 この仕様は，そのような~sensorへの~accessを生成元に許容する。 ◎ Pointer events contain additional information (where supported by the user's device), such as the angle or tilt at which a pen input is held, the geometry of the contact surface, and the pressure exerted on the stylus or touch screen. Information about angle, tilt, geometry and pressure are directly related to sensors on the user's device, meaning that this specification allows an origin access to these sensors.

この~sensor~dataは、［ どの型の仕組み（~mouse, ~touch, ~pen, 等）が入力に利用されているか ］を決定する能とともに，［ 利用者, あるいは利用者の装置や環境 ］についての特性を推定するために利用され得る。 このように推定された特性, および装置や環境の情報それ自体も敏感になり得る — 一例として、 悪意的な~siteは，さらに利用者が支援技術を利用しているか推定できるようになる。 この情報はまた、 特定0の利用者を追跡しようと試みるために［ 利用者~profileを築く, あるいは “指紋収集する” ］目的にも利用され得る。 ◎ This sensor data, as well as the ability to determine the type of input mechanism (mouse, touch, pen) used, may be used to infer characteristics of a user, or of the user's device and environment. These inferred characteristics and any device/environment information may themselves be sensitive - for instance, they may allow a malicious site to further infer if a user is using assistive technologies. This information can also be potentially used for the purposes of building a user profile and/or attempting to "fingerprint" and track a particular user.

当 working group は、 上述を超えるような考慮点は，この仕様には無いものと予見している： ◎ Beyond these considerations, the working group believes that this specification:

• 個人識別可能な情報は、 公開しない。 ◎ Does not expose personally-identifiable information.
• 高価値な~dataは、 ~~扱わない。 ◎ Does not deal with high-value data.
• 複数の閲覧~sessionに持続するような，生成元~用の新たな状態は、 導入しない。 ◎ Does not introduce new state for an origin that persists across browsing sessions.
• 異なる生成元にわたって持続するような状態は、 ~webに公開しない。 ◎ Does not expose persistent, cross-origin state to the web.
• 現在~accessできない他のどのような~dataも、 生成元に公開しない。 ◎ Does not expose any other data to an origin that it doesn’t currently have access to.
• ~scriptを［ 実行する／読込む ］ような新たな仕組みは、 可能化しない。 ◎ Does not enable new script execution/loading mechanisms.
• 利用者の所在への~accessは、 生成元に許容しない。 ◎ Does not allow an origin access to a user’s location.
• ~UAが “私的閲覧” ~mode下にあるときの特別な取扱いは、 要求しない。 ◎ Does not require any special handling when the user agent is in "incognito" mode.
• 他の装置への~accessは、 生成元に許容しない。 ◎ Does not allow an origin access to other devices.
• ~UAに~nativeな~UI越しの制御は、 生成元に許容しない。 ◎ Does not allow an origin control over a user agent’s native UI.
• 一時的な識別子は、 ~webに公開しない。 ◎ Does not expose temporary identifiers to the web.
• 挙動が［ 当事者-主体, 第三者-主体 ］どちらの文脈におけるものかは、 判別しない。 ◎ Does not distinguish between behavior in first-party and third-party contexts.
• 利用者に局所的な装置には、 ~dataを持続しない。 ◎ Does not persist data to a user’s local device.
• 既定の~security特性へ降格することは、 許容しない。 ◎ Does not allow downgrading default security characteristics.

謝辞

たくさんの方々からの提案や助言に感謝する。 それらの一部は、 この文書に組入れられている。 次に挙げる，~~現在／~~過去の~group~memberの方々による貢献にも： ◎ Many thanks to lots of people for their proposals and recommendations, some of which are incorporated into this document. The group's Chair acknowledges contributions from the following past and present group members and participants:

Mustaq Ahmed, Arthur Barstow, Matt Brubeck, Rick Byers, Cathy Chan, Ted Dinklocker, Dave Fleck, Ella Ge, Scott González, Philippe Le Hégaret, Hayato Ito, Patrick Kettner, Patrick H. Lauke, Scott Low, Sangwhan Moon, Olli Pettay, Jacob Rossi, Doug Schepers, Ming-Chou Shih, Brenton Simpson, Dave Tapuska, Asir Vedamuthu, Lan Wei, Navid Zolghadr

この~modelの最初の版のために先駆的な仕事をされた方々にも特別な謝意を — とりわけ次の方々に：

Special thanks to those that helped pioneer the first edition of this model, including especially: Charu Chandiram, Peter Freiling, Nathan Furtwangler, Thomas Olsen, Matt Rakow, Ramu Ramanathan, Justin Rogers, Jacob Rossi, Reed Townsend and Steve Wright.

改訂~履歴

最初の `PointerEvents1$r 仕様からの，~~主要な, および編集上の~~主な変更点を以下に要約する （この仕様の編集者草案の`完全な改訂~履歴＠https://github.com/w3c/pointerevents/commits$）。 ◎ The following is an informative summary of substantial and major editorial changes between publications of this specification, relative to the first [PointerEvents1] specification. See the complete revision history of the Editor's Drafts of this specification.

• 規範的でない節からの規範的な参照を除去した。 （加えて， `COMPAT$r は純粋に規範的でないとした） （ `commit＠https://github.com/w3c/pointerevents/commit/d2779fe71e3b1c26d6b4657ad0330bed378b8b69$ ） ◎ Remove normative references from informative sections (and mark [COMPAT] as purely informative)
• `270$pull： `§ ~pointer捕捉＠#pointer-capture$ 全体を規範的でないものとしていたのを修正した。 ◎ Fix Pointer Capture section erroneously marked as informative
• `251$pull： 暗黙的な捕捉の局面における`境界~event$を追加した。 ◎ Add boundary events in implicit capture scenarios
• `246$pull： 注釈文における `DOM4$r の `ownerDocument^m ~tree【`文書~内$】の概念を `接続されて$いる／いない に置換した。【全部ではない】 ◎ Replace prose about ownerDocument tree with DOM4 concept of connected
• `235$pull： § ~securityと~privacy上の考慮点を追加した。 ◎ Add security and privacy considerations section
• `234$pull： 旧来の属性 `fromElement^m, `toElement^m （ `MouseEvent$I から継承される）は、 ~NULL を返すモノトスルことについての注記を追加した。 ◎ Add note about legacy attributes fromElement and toElement (inherited from MouseEvents) must be null
• `218$pull： 構築子に [Exposed=Window] を追加した。 ◎ Add [Exposed=Window] to Constructor
• `138$pull： 捕捉の間に`境界~event$を送信しないようにした。 ◎ Don't send boundary events during capture
• `129$pull： 直接~操作~pointing装置~用の暗黙的な捕捉。 ◎ Implicit capture for direct manipulation pointing devices
• `122$pull： `~pointer捕捉$が暗黙的に解放された場合を除き、 ~pointer捕捉~処理は遅延される~modelに従うようにした。 ◎ Add pointer capture processing follow delayed model except implicit release and set the pointer capture events attributes
• `127$pull： `hasPointerCapture()$m を追加した。 ◎ Add hasPointerCapture
• `96$pull： `button^m ／ `buttons^m から “~pen接触” 条件を除去した。 ◎ Removed "pen contact" condition on button/buttons
• `92$pull： すべての~pointer~eventを~composed~eventにした。 ◎ Make all pointer events composed events
• `87$pull： ~digitizer／~pen による接線方向（~barrel）圧を追加した。 ◎ Add digitizer/pen tangential (barrel) pressure
• `79$pull： ~digitizer／~penの~twistを追加。 ◎ Add digitizer/pen twist
• `69$pull： `width$m ／ `height$m の既定を 1 にした上で、 ~UAによる幾何の “~~推測／~~偽造” を除去した。 ◎ Make width/height default to 1, remove UA "guessing"/faking geometry
• `56$pull： `mouseover$et／ `mouseout$et／ `mouseenter$et／ `mouseleave$et ~eventは，対応する~pointer~eventとは独立に発火されるようにした。 ◎ Made mouseover/out/enter/leave event firing independent of corresponding PEs
• `53$pull： § `首~pointer$を，言い回しを単純~化した上で、 複数の~mouse入力~装置の可能性を許容した。 ◎ Rewrite of primary pointer section to simplify the wording and allow for possibility of multiple mouse input devices
• `50$pull： `首~pointer$が除去された場合についての~~言及。 ◎ Cover the case when primary pointer is removed
• `43$pull： `touch-action$p の動的な変化について明確化した。 ◎ Clarification about dynamic touch-action changes
• `36$pull： `処理待ち~pointer捕捉を処理-$する際の，抜けていた `pointerover$et／`pointerenter$et ~eventを追加した。 ◎ Add the missing pointerover/enter events to the "Process Pending Pointer Capture" section
• `34$pull： ~mouse~drag用に~button値を明確化した。 ◎ Clarify the button value for mouse drag
• `24$pull： ~zoomにおける `touch-action$p の処理~modelを修正した。 ◎ Fix the touch-action processing model for zoom scenarios