From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/pointerevent/getcoalescedevents/index.html | 53 +++++++ files/ja/web/api/pointerevent/height/index.html | 63 +++++++++ files/ja/web/api/pointerevent/index.html | 156 +++++++++++++++++++++ files/ja/web/api/pointerevent/isprimary/index.html | 75 ++++++++++ .../web/api/pointerevent/pointerevent/index.html | 70 +++++++++ files/ja/web/api/pointerevent/pointerid/index.html | 70 +++++++++ .../ja/web/api/pointerevent/pointertype/index.html | 96 +++++++++++++ files/ja/web/api/pointerevent/pressure/index.html | 81 +++++++++++ .../api/pointerevent/tangentialpressure/index.html | 78 +++++++++++ files/ja/web/api/pointerevent/tiltx/index.html | 68 +++++++++ files/ja/web/api/pointerevent/tilty/index.html | 67 +++++++++ files/ja/web/api/pointerevent/twist/index.html | 71 ++++++++++ files/ja/web/api/pointerevent/width/index.html | 69 +++++++++ 13 files changed, 1017 insertions(+) create mode 100644 files/ja/web/api/pointerevent/getcoalescedevents/index.html create mode 100644 files/ja/web/api/pointerevent/height/index.html create mode 100644 files/ja/web/api/pointerevent/index.html create mode 100644 files/ja/web/api/pointerevent/isprimary/index.html create mode 100644 files/ja/web/api/pointerevent/pointerevent/index.html create mode 100644 files/ja/web/api/pointerevent/pointerid/index.html create mode 100644 files/ja/web/api/pointerevent/pointertype/index.html create mode 100644 files/ja/web/api/pointerevent/pressure/index.html create mode 100644 files/ja/web/api/pointerevent/tangentialpressure/index.html create mode 100644 files/ja/web/api/pointerevent/tiltx/index.html create mode 100644 files/ja/web/api/pointerevent/tilty/index.html create mode 100644 files/ja/web/api/pointerevent/twist/index.html create mode 100644 files/ja/web/api/pointerevent/width/index.html (limited to 'files/ja/web/api/pointerevent') diff --git a/files/ja/web/api/pointerevent/getcoalescedevents/index.html b/files/ja/web/api/pointerevent/getcoalescedevents/index.html new file mode 100644 index 0000000000..3a6779b119 --- /dev/null +++ b/files/ja/web/api/pointerevent/getcoalescedevents/index.html @@ -0,0 +1,53 @@ +--- +title: PointerEvent.getCoalescedEvents() +slug: Web/API/PointerEvent/getCoalescedEvents +tags: + - API + - DOM + - Deprecated + - Method + - Pointer Events + - PointerEvent + - Reference +translation_of: Web/API/PointerEvent/getCoalescedEvents +--- +

{{APIRef("Pointer Events")}}{{seecompattable}}

+ +

{{domxref("PointerEvent")}} インターフェイスの getCoalescedEvents() メソッドは、送出された {{event("pointermove")}} イベントに合体したすべての PointerEvent インスタンスのシーケンスを返します。

+ +

構文

+ +
var pointerEvents[] = PointerEvent.getCoalescedEvents()
+ +

パラメーター

+ +

なし。

+ +

Returns

+ +

{{domxref("PointerEvent")}} インスタンスのシーケンス。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2 Ext','#dom-pointerevent-getcoalescedevents','getCoalescedEvents()')}}{{Spec2('Pointer Events 2 Ext')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.getCoalescedEvents")}}

diff --git a/files/ja/web/api/pointerevent/height/index.html b/files/ja/web/api/pointerevent/height/index.html new file mode 100644 index 0000000000..69c9d0dec2 --- /dev/null +++ b/files/ja/web/api/pointerevent/height/index.html @@ -0,0 +1,63 @@ +--- +title: PointerEvent.height +slug: Web/API/PointerEvent/height +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/height +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの height 読み取り専用プロパティは、y 軸に沿ったポインタの接触ジオメトリの高さを表します（CSS ピクセル単位）。 ポインタデバイスのソース（指など）によっては、特定のポインタに対して、各イベントが異なる値を生成することがあります。

+ +

入力ハードウェアが接触ジオメトリをブラウザーに報告できない場合、高さのデフォルトは 1 です。

+ +

構文

+ +
var contactHeight = pointerEvent.height;
+
+ +

戻り値

+ +
+
contactHeight
+
イベントの接触面積の高さ（CSS ピクセル単位）。
+
+ +

例

+ +

このプロパティの例は、PointerEvent.width の例に含まれています。

+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#widl-PointerEvent-height', 'height')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('Pointer Events', '#widl-PointerEvent-height', 'height')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.height")}}

diff --git a/files/ja/web/api/pointerevent/index.html b/files/ja/web/api/pointerevent/index.html new file mode 100644 index 0000000000..af14ec223d --- /dev/null +++ b/files/ja/web/api/pointerevent/index.html @@ -0,0 +1,156 @@ +--- +title: PointerEvent +slug: Web/API/PointerEvent +tags: + - API + - DOM + - Interface + - Pointer Events + - PointerEvent + - Reference +translation_of: Web/API/PointerEvent +--- +

{{ APIRef("Pointer Events") }}

+ +

PointerEvent インターフェイスは、接触点のジオメトリ、イベントを生成したデバイスタイプ、接触面に加えられた圧力の量など、ポインタによって生成された DOM イベントの状態を表します。

+ +

ポインタは、入力デバイス（マウス、ペン、またはタッチ対応面上の接触点など）のハードウェアにとらわれない表現です。 ポインタは、画面などの接触面上の特定の座標（または座標のセット）をターゲットにすることができます。

+ +

ポインタのヒットテストは、ブラウザーがポインタイベントのターゲット要素を決定するために使用するプロセスです。 通常、これはポインタの位置と、画面媒体上のドキュメント内の要素の視覚的なレイアウトを考慮して決定します。

+ +

コンストラクタ

+ +
+
{{domxref("PointerEvent.PointerEvent", "PointerEvent()")}}
+
信頼できない合成 PointerEvent を作成します。
+
+ +

プロパティ

+ +

このインターフェイスは、{{domxref("MouseEvent")}} および {{domxref("Event")}} からプロパティを継承します。

+ +
+
{{ domxref('PointerEvent.pointerId')}} {{readonlyInline}}
+
イベントの原因となっているポインタの一意の識別子。
+
{{ domxref('PointerEvent.width')}} {{readonlyInline}}
+
ポインタの接触ジオメトリの幅（X 軸の大きさ、CSS ピクセル単位）。
+
{{ domxref('PointerEvent.height')}} {{readonlyInline}}
+
ポインタの接触ジオメトリの高さ（Y 軸上の大きさ、CSS ピクセル単位）。
+
{{ domxref('PointerEvent.pressure')}} {{readonlyInline}}
+
0 から 1 の範囲のポインタ入力の正規化された圧力。 ここで、0 と 1 は、それぞれハードウェアが検出できる最小圧力と最大圧力を表します。
+
{{ domxref('PointerEvent.tangentialPressure')}} {{readonlyInline}}
+
ポインタ入力の正規化された接線圧力（バレル圧力またはシリンダー応力（cylinder stress）とも呼ばれます）は -1 から 1 の範囲で、0 はコントロールの中立位置です。
+
{{ domxref('PointerEvent.tiltX')}} {{readonlyInline}}
+
Y-Z 平面と、ポインタ（ペン/スタイラスなど）軸と Y 軸の両方を含む平面との間の平面角度（度単位、-90 から 90 の範囲）。
+
{{ domxref('PointerEvent.tiltY')}} {{readonlyInline}}
+
X-Z 平面と、ポインタ（ペン/スタイラスなど）軸と X 軸の両方を含む平面との間の平面角度（度単位、-90 から 90 の範囲）。
+
{{ domxref('PointerEvent.twist')}} {{readonlyInline}}
+
ポインタ（ペン/スタイラスなど）の長軸を中心とした時計回りの回転の度数（0 から 359の範囲の値）。
+
{{ domxref('PointerEvent.pointerType')}} {{readonlyInline}}
+
イベントの原因となったデバイスタイプ（マウス、ペン、タッチなど）を示します。
+
{{ domxref('PointerEvent.isPrimary')}} {{readonlyInline}}
+
ポインタがこのポインタタイプのプライマリポインタを表すかどうかを示します。
+
+ +

メソッド

+ +
+
{{ domxref('PointerEvent.getCoalescedEvents()')}} {{deprecated_inline}}
+
送出された {{event("pointermove")}} イベントに合体したすべての PointerEvent インスタンスのシーケンスを返します。
+
+ +

ポインタイベントタイプ

+ +

PointerEvent インターフェイスにはいくつかのイベントタイプがあります。 どのイベントが発生したかを判断するには、イベントの {{ domxref("Event.type", "type") }} プロパティを調べます。

+ +
注: 多くの場合、ポインタとマウスの両方のイベントが送信されることに注意することが重要です（ポインタ固有でないコードでもユーザーと対話できるようにするため）。 ポインタイベントを使用する場合は、{{ domxref("event.preventDefault()") }} を呼び出してマウスイベントも送信されないようにする必要があります。
+ +
+
{{event('pointerover')}}
+
このイベントは、ポインティングデバイスが要素のヒットテスト境界内に移動したときに発生します。
+
{{event('pointerenter')}}
+
このイベントは、ポインティングデバイスが要素またはその子孫の1つのヒットテスト境界内に移動したときに発生します。 これには、ホバーをサポートしないデバイスからの pointerdown イベントの結果も含まれます（pointerdown を参照）。 このイベントタイプは pointerover に似ていますが、バブリングしないという点で異なります。
+
{{event('pointerdown')}}
+
このイベントは、ポインタがアクティブになると発生します。 マウスの場合、ボタンが押されていない状態から少なくとも1つのボタンが押された状態に移行したときに発生します。 タッチの場合、物理的な接触がデジタイザとなされたときに発生します。 ペンの場合、スタイラスがデジタイザと物理的に接触したときに発生します。
+
{{event('pointermove')}}
+
このイベントは、ポインタが座標を変更したときに発生します。
+
{{event('pointerup')}}
+
このイベントは、ポインタがアクティブでなくなったときに発生します。
+
{{event('pointercancel')}}
+
ブラウザーは、ポインタがイベントを生成できなくなったと判断した場合（例えば、関連するデバイスが無効になった場合）、このイベントを発生させます。
+
{{event('pointerout')}}
+
このイベントは、次のようないくつかの理由で発生します。 ポインティングデバイスが要素のヒットテスト境界外に移動した。 ホバーをサポートしていないデバイスの pointerup イベントが発生した（pointerup を参照）。 pointercancel イベントの発生後（pointercancel を参照）。 ペン/スタイラスがデジタイザで検出可能なホバー範囲を離脱したとき。
+
{{event('pointerleave')}}
+
このイベントは、ポインティングデバイスが要素のヒットテスト境界外に移動したときに発生します。 ペンデバイスの場合、このイベントは、スタイラスがデジタイザで検出可能なホバー範囲を離脱したときに発生します。
+
{{event('gotpointercapture')}}
+
このイベントは、要素がポインタキャプチャを受け取ったときに発生します。
+
{{event('lostpointercapture')}}
+
このイベントは、ポインタに対するポインタキャプチャが解放された後に発生します。
+
+ +

GlobalEventHandlers

+ +
+
{{ domxref('GlobalEventHandlers.onpointerover') }}
+
{{event('pointerover')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
{{ domxref('GlobalEventHandlers.onpointerenter') }}
+
{{event('pointerenter')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
{{ domxref('GlobalEventHandlers.onpointerdown') }}
+
{{event('pointerdown')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
{{ domxref('GlobalEventHandlers.onpointermove') }}
+
{{event('pointermove')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
{{ domxref('GlobalEventHandlers.onpointerup') }}
+
{{event('pointerup')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
{{ domxref('GlobalEventHandlers.onpointercancel') }}
+
{{event('pointercancel')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
{{ domxref('GlobalEventHandlers.onpointerout') }}
+
 {{event('pointerout')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
{{ domxref('GlobalEventHandlers.onpointerleave') }}
+
{{event('pointerleave')}} イベントのための{{domxref('GlobalEventHandlers','グローバルイベントハンドラ')}}。
+
+ +

例

+ +

各プロパティ、イベントタイプ、およびグローバルイベントハンドラの例は、それぞれの参照ページに含まれています。

+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2 Ext','#extensions-to-the-pointerevent-interface', 'PointerEvent')}}{{Spec2('Pointer Events 2 Ext')}}{{DOMxRef('PointerEvent.getCoalescedEvents()', 'getCoalescedEvents()')}} メソッドを追加しました。
{{SpecName('Pointer Events 2','#pointerevent-interface', 'PointerEvent')}}{{Spec2('Pointer Events 2')}}{{DOMxRef('PointerEvent.twist', 'twist')}} プロパティと {{DOMxRef('PointerEvent.tangentialPressure', 'tangentialPressure')}} プロパティを追加しました。
{{SpecName('Pointer Events', '#pointerevent-interface', 'PointerEvent')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/pointerevent/isprimary/index.html b/files/ja/web/api/pointerevent/isprimary/index.html new file mode 100644 index 0000000000..ce7346a3bd --- /dev/null +++ b/files/ja/web/api/pointerevent/isprimary/index.html @@ -0,0 +1,75 @@ +--- +title: PointerEvent.isPrimary +slug: Web/API/PointerEvent/isPrimary +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/isPrimary +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの isPrimary 読み取り専用プロパティは、イベントを作成したポインタデバイスがプライマリポインタであるかどうかを示します。 イベントの発生原因となったポインタがプライマリデバイスの場合は true を返し、それ以外の場合は false を返します。

+ +

マルチポインタのシナリオ（複数のタッチ点をサポートするタッチ画面など）では、このプロパティを使用して、各ポインタタイプのアクティブポインタのセットからマスタポインタを識別します。 プライマリポインタのみが互換性マウスイベントを生成します。 単一のポインタによる相互作用のみを希望する作成者は、非プライマリポインタを無視することによってそれを達成することができます。

+ +

マウスデバイスを表すポインタの場合、ポインタはプライマリと見なされます。 ペン入力を表す他のアクティブポインタが存在しないときに、その {{event("pointerdown")}} イベントが送出された場合、ペン入力を表すポインタはプライマリペン入力と見なされます。 タッチ入力を表す他のアクティブポインタが存在しないときに、その {{event("pointerdown")}} イベントが送出された場合、タッチ入力を表すポインタはプライマリタッチ入力と見なされます。

+ +

2つ以上のポインタデバイスタイプが同時に使用されている場合、複数のポインタ（各 {{domxref("PointerEvent.pointerType", "pointerType")}} に1つ）がプライマリと見なされます。 例えば、タッチ接触とマウスカーソルが同時に動かされると、両方ともプライマリと見なされるポインタが生成されます。 複数のプライマリポインタがある場合、これらのポインタはすべて互換性マウスイベントを生成します（ポインタ、マウス、およびタッチの相互作用の詳細については、{{domxref("Pointer events")}} を参照）。

+ +

構文

+ +
var isPrimary = pointerEvent.isPrimary;
+
+ +

戻り値

+ +
+
isPrimary
+
このイベントのポインタがプライマリポインタの場合は true を返し、そうでない場合は false を返します。
+
+ +

例

+ +

この例は、isPrimary の値を使用して適切な処理関数を呼び出す方法を示しています。

+ +
target.addEventListener('pointerdown', function(event) {
+   if (event.isPrimary)
+     process_primary_pointer(event);
+   else
+     process_secondary_pointer(event);
+ }, false);
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#widl-PointerEvent-isPrimary', 'isPrimary')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('Pointer Events', '#widl-PointerEvent-isPrimary', 'isPrimary')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.isPrimary")}}

diff --git a/files/ja/web/api/pointerevent/pointerevent/index.html b/files/ja/web/api/pointerevent/pointerevent/index.html new file mode 100644 index 0000000000..78e10d6d34 --- /dev/null +++ b/files/ja/web/api/pointerevent/pointerevent/index.html @@ -0,0 +1,70 @@ +--- +title: PointerEvent.PointerEvent() +slug: Web/API/PointerEvent/PointerEvent +tags: + - API + - Constructor + - PointerEvent + - Reference +translation_of: Web/API/PointerEvent/PointerEvent +--- +

{{APIRef("Pointer Events")}}

+ +

PointerEvent() コンストラクタは、新しい信頼できない合成 {{domxref("PointerEvent")}} オブジェクトのインスタンスを作成します。

+ +

構文

+ +
 event = new PointerEvent(type, PointerEventInit);
+ +

引数

+ +
+
type
+
イベントの名前を表す {{domxref("DOMString")}} です（PointerEvent のイベントタイプを参照）。
+
PointerEventInit{{optional_inline}}
+
+ +
+
次のフィールドを持つ PointerEventInit ディクショナリです。 + +
    +
  • pointerId — インスタンスの {{domxref("PointerEvent.pointerId")}} の値を設定する long 型のオプションで、デフォルトは 0 です。
    • +
  • width — インスタンスの {{domxref("PointerEvent.width")}} の値を設定する double 型のオプションで、デフォルトは 1 です。
    • +
  • height — インスタンスの {{domxref("PointerEvent.height")}} の値を設定する double 型のオプションで、デフォルトは 1 です。
    • +
  • pressure — インスタンスの {{domxref("PointerEvent.pressure")}} の値を設定する float 型のオプションで、デフォルトは 0 です。
    • +
  • tangentialPressure — インスタンスの {{domxref("PointerEvent.tangentialPressure")}} の値を設定する float 型のオプションで、デフォルトは 0 です。
    • +
  • tiltX — インスタンスの {{domxref("PointerEvent.tiltX")}} の値を設定する long 型のオプションで、デフォルトは 0 です。
    • +
  • tiltY — インスタンスの {{domxref("PointerEvent.tiltY")}} の値を設定する long 型のオプションで、デフォルトは 0 です。
    • +
  • twist — インスタンスの {{domxref("PointerEvent.twist")}} の値を設定する long 型のオプションで、デフォルトは 0 です。
    • +
  • pointerType — インスタンスの {{domxref("PointerEvent.pointerType")}} の値を設定する {{domxref("DOMString")}} 型のオプションで、デフォルトは "" です。
    • +
  • isPrimary — インスタンスの {{domxref("PointerEvent.isPrimary")}} の値を設定する {{jsxref("Boolean")}} 型のオプションで、デフォルトは false です。
    • +
+ +
+

注: PointerEventInit ディクショナリは、{{domxref("MouseEvent.MouseEvent","MouseEvent")}}、{{domxref("UIEvent.UIEvent", "UIEventInit")}}、および {{domxref("Event.Event", "EventInit")}} ディクショナリからのフィールドも受け入れます。

+
+
+
+ +

例

+ +
var moveEvent = new PointerEvent("pointermove");
+
+var downEvent = new PointerEvent("pointerdown",
+   {pointerId: 1,
+    bubbles: true,
+    cancelable: true,
+    pointerType: "touch",
+    width: 100,
+    height: 100,
+    isPrimary: true
+   });
+
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.PointerEvent")}}

diff --git a/files/ja/web/api/pointerevent/pointerid/index.html b/files/ja/web/api/pointerevent/pointerid/index.html new file mode 100644 index 0000000000..7dee6bc465 --- /dev/null +++ b/files/ja/web/api/pointerevent/pointerid/index.html @@ -0,0 +1,70 @@ +--- +title: PointerEvent.pointerId +slug: Web/API/PointerEvent/pointerId +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/pointerId +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの pointerId 読み取り専用プロパティは、特定のポインタのイベントに割り当てられた識別子です。 識別子は一意であり、他のすべてのアクティブポインタのイベントの識別子とは異なります。 値はランダムに生成される可能性があるため、特定の意味を伝えることは保証されません。

+ +

構文

+ +
var id = pointerEvent.pointerId;
+
+ +

戻り値

+ +
+
id
+
ポインタイベントの一意の識別子番号。
+
+ +

例

+ +

次のコードスニペットは、以前に保存された pointerId と、発生したばかりの {{event("pointerdown")}} イベントのものとを比較します。

+ +
let id; // これが以前に保存された pointerId であると仮定しましょう
+
+target.addEventListener('pointerdown', function(event) {
+  // キャッシュされた前のイベントの ID を現在の
+  // イベントの ID と比較し、それに応じて処理する
+  if (id === event.pointerId) process_event(event);
+}, false);
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#dom-pointerevent-pointerid', 'pointerId')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('Pointer Events', '#dom-pointerevent-pointerid', 'pointerId')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.pointerId")}}

diff --git a/files/ja/web/api/pointerevent/pointertype/index.html b/files/ja/web/api/pointerevent/pointertype/index.html new file mode 100644 index 0000000000..7d2ce28a48 --- /dev/null +++ b/files/ja/web/api/pointerevent/pointertype/index.html @@ -0,0 +1,96 @@ +--- +title: PointerEvent.pointerType +slug: Web/API/PointerEvent/pointerType +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/pointerType +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの pointerType 読み取り専用プロパティは、特定のポインタイベントを引き起こしたデバイスタイプ（マウス、ペン、またはタッチ）を示します。

+ +

構文

+ +
var pType = pointerEvent.pointerType;
+
+ +

戻り値

+ +
+
pType
+
イベントのポインタタイプ。 サポートする値は次の文字列です。
+ +
+
"mouse"
+
イベントはマウスデバイスによって生成されました。
+
"pen"
+
イベントはペンデバイスまたはスタイラスデバイスによって生成されました。
+
"touch"
+
イベントは指などのタッチによって生成されました。
+
+
+
+ +

デバイスタイプがブラウザーで検出できない場合、値は空の文字列（""）になります。 ブラウザーが上記以外のポインタデバイスタイプをサポートしている場合は、異なるタイプのデバイスと名前が競合しないように、値に{{glossary("Vendor Prefix","ベンダー接頭辞")}}を付ける必要があります。

+ +

例

+ +

この例は、pointerType プロパティの値を使用して適切なポインタタイプ処理関数を呼び出す方法を示しています。

+ +
targetElement.addEventListener('pointerdown', function(event) {
+  // 適切なポインタタイプのハンドラを呼び出す
+  switch (event.pointerType) {
+    case 'mouse':
+      process_pointer_mouse(event);
+      break;
+    case 'pen':
+      process_pointer_pen(event);
+      break;
+    case 'touch':
+      process_pointer_touch(event);
+      break;
+    default:
+      console.log(`pointerType ${event.pointerType} はサポートしていません`);
+  }
+}, false);
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events', '#dom-pointerevent-pointertype', 'pointerType')}}{{Spec2('Pointer Events')}}初期定義
{{SpecName('Pointer Events 2','#dom-pointerevent-pointertype', 'pointerType')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('CSSOM View','#extensions-to-the-mouseevent-interface', 'MouseEvent')}}{{Spec2('CSSOM View')}}{{domxref("MouseEvent")}} を long 型から double 型に再定義します。 これは、pointerType がマウスである {{domxref("PointerEvent")}} が double 型になることを意味します。
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.pointerType", 2)}}

diff --git a/files/ja/web/api/pointerevent/pressure/index.html b/files/ja/web/api/pointerevent/pressure/index.html new file mode 100644 index 0000000000..d2f4d3635c --- /dev/null +++ b/files/ja/web/api/pointerevent/pressure/index.html @@ -0,0 +1,81 @@ +--- +title: PointerEvent.pressure +slug: Web/API/PointerEvent/pressure +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/pressure +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの pressure 読み取り専用プロパティは、ポインタ入力の正規化された圧力を示します。

+ +

構文

+ +
var pressure = pointerEvent.pressure;
+
+ +

戻り値

+ +
+
pressure
+
0 から 1 までの範囲のポインタ入力の正規化された圧力。 ここで、0 と 1 は、それぞれハードウェアが検出できる最小圧力と最大圧力を表します。 マウスなど、圧力をサポートしていないハードウェアの場合、値はポインタがアクティブボタン状態のときは 0.5、それ以外のときは 0 です。
+
+ +

例

+ +

このスニペットでは、{{event("pointerdown")}} イベントが発生すると、そのイベントの pressure プロパティの値に応じてさまざまな関数が呼び出されます。

+ +
someElement.addEventListener('pointerdown', function(event) {
+  if (event.pressure == 0) {
+    // 圧力なし
+    process_no_pressure(event);
+  } else if (event.pressure == 1) {
+    // 最大圧力
+    process_max_pressure(event);
+  } else {
+    // デフォルト
+    process_pressure(event);
+  }
+}, false);
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#dom-pointerevent-pressure', 'pressure')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('Pointer Events', '#dom-pointerevent-pressure', 'pressure')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.pressure")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/pointerevent/tangentialpressure/index.html b/files/ja/web/api/pointerevent/tangentialpressure/index.html new file mode 100644 index 0000000000..31b3c2e265 --- /dev/null +++ b/files/ja/web/api/pointerevent/tangentialpressure/index.html @@ -0,0 +1,78 @@ +--- +title: PointerEvent.tangentialPressure +slug: Web/API/PointerEvent/tangentialPressure +tags: + - API + - DOM + - Pointer Events + - PointerEvent + - Property + - Reference + - tangentialPressure +translation_of: Web/API/PointerEvent/tangentialPressure +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの tangentialPressure 読み取り専用プロパティは、ポインタ入力の正規化された接線方向の圧力（バレル圧力またはシリンダー応力（cylinder stress）とも呼ばれます）を表します。

+ +

（訳注：エアブラシスタイラスのホイールのようなものを想定しています。）

+ +

構文

+ +
var tanPressure = pointerEvent.tangentialPressure;
+
+ +

戻り値

+ +

ポインタ入力の正規化された接線方向の圧力を表す -1 から 1 の範囲の float 型。ここで、0 はコントロールの中立位置です。

+ +

ハードウェアによっては、0 から 1 の範囲の正の値しかサポートしない場合があることに注意してください。 接線方向の圧力をサポートしないハードウェアの場合、値は 0 になります。

+ +

例

+ +

このスニペットでは、{{event("pointerdown")}} イベントが発生すると、イベントの tangentialPressure プロパティの値に応じてさまざまな関数が呼び出されます。

+ +
someElement.addEventListener('pointerdown', function(event) {
+  if (event.tangentialPressure == 0) {
+    // 圧力なし
+    process_no_tanPressure(event);
+  } else if (event.tangentialPressure == 1) {
+    // 最大圧力
+    process_max_tanPressure(event);
+  } else {
+    // デフォルト
+    process_tanPressure(event);
+  }
+}, false);
+
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#dom-pointerevent-tangentialpressure', 'tangentialPressure')}}{{Spec2('Pointer Events 2')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.tangentialPressure")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/pointerevent/tiltx/index.html b/files/ja/web/api/pointerevent/tiltx/index.html new file mode 100644 index 0000000000..527818b8c3 --- /dev/null +++ b/files/ja/web/api/pointerevent/tiltx/index.html @@ -0,0 +1,68 @@ +--- +title: PointerEvent.tiltX +slug: Web/API/PointerEvent/tiltX +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/tiltX +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの tiltX 読み取り専用プロパティは、ポインタの Y-Z 平面と画面との間の角度（度単位）です。 このプロパティは通常、ペン/スタイラスポインタタイプにのみ役立ちます。

+ +

このプロパティの説明については、仕様の図 2 を参照してください。

+ +

構文

+ +
var tiltX = pointerEvent.tiltX;
+
+ +

戻り値

+ +
+
tiltX
+
ポインタ（スタイラス）の Y-Z 平面と画面の間の角度（度単位）。 値の範囲は -90 から 90 です。 ここで、正の値は右への傾きです。 このプロパティをサポートしていないデバイスの場合、値は 0 です。
+
+ +

例

+ +

この例は、tiltX プロパティおよび {{domxref("PointerEvent.tiltY","tiltY")}} プロパティへの簡単なアクセスを示しています。

+ +
someElement.addEventListener("pointerdown", function(event) {
+  process_tilt(event.tiltX, event.tiltY);
+}, false);
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#dom-pointerevent-tiltx', 'tiltX')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('Pointer Events', '#dom-pointerevent-tiltx', 'tiltX')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.tiltX")}}

diff --git a/files/ja/web/api/pointerevent/tilty/index.html b/files/ja/web/api/pointerevent/tilty/index.html new file mode 100644 index 0000000000..4dfe6ac2d2 --- /dev/null +++ b/files/ja/web/api/pointerevent/tilty/index.html @@ -0,0 +1,67 @@ +--- +title: PointerEvent.tiltY +slug: Web/API/PointerEvent/tiltY +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/tiltY +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの tiltY 読み取り専用プロパティは、ポインタの X-Z 平面と画面の間の角度（度単位）です。 このプロパティは通常、ペン/スタイラスポインタタイプにのみ役立ちます。

+ +

このプロパティの説明については、仕様の図 3 を参照してください。

+ +

構文

+ +
var tiltY = pointerEvent.tiltY;
+
+ +

戻り値

+ +
+
tiltY
+
ポインタ（スタイラス）の X-Z 平面と画面の間の角度（度単位）。 値の範囲は -90 から 90 です。 ここで、正の値はユーザーの方への傾きです。 このプロパティをサポートしていないデバイスの場合、値は 0 です。
+
+ +

例

+ +

この例は、{{domxref("PointerEvent.tiltX","tiltX")}} プロパティおよび tiltY プロパティへの簡単なアクセスを示しています。

+ +
someElement.addEventListener("pointerdown", function(event) {
+  process_tilt(event.tiltX, event.tiltY);
+}, false);
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#dom-pointerevent-tilty', 'tiltY')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('Pointer Events', '#dom-pointerevent-tilty', 'tiltY')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.tiltY")}}

diff --git a/files/ja/web/api/pointerevent/twist/index.html b/files/ja/web/api/pointerevent/twist/index.html new file mode 100644 index 0000000000..b8830ce906 --- /dev/null +++ b/files/ja/web/api/pointerevent/twist/index.html @@ -0,0 +1,71 @@ +--- +title: PointerEvent.twist +slug: Web/API/PointerEvent/twist +tags: + - API + - DOM + - Pointer Events + - PointerEvent + - Property + - Reference + - twist +translation_of: Web/API/PointerEvent/twist +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの twist 読み取り専用プロパティは、ポインタ（例えばペン/スタイラス）の主軸を中心とした時計回りの回転を度数で表します。

+ +

構文

+ +
var twist = pointerEvent.twist;
+
+ +

戻り値

+ +

トランスデューサ（ポインタ）に適用される、ねじれの量を度数で表す long 値。 値の範囲は 0 から 359 です。 twist を報告しないデバイスの場合、値は 0 です。

+ +

例

+ +

{{event("pointerdown")}} イベントが発生すると、イベントの twist プロパティの値に応じてさまざまな関数が呼び出されます。

+ +
someElement.addEventListener('pointerdown', function(event) {
+  if (event.twist == 0) {
+    // ねじれなし
+    process_no_twist(event);
+  } else {
+    // デフォルト
+    process_twist(event);
+  }
+}, false);
+
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#dom-pointerevent-twist', 'twist')}}{{Spec2('Pointer Events 2')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.twist")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/pointerevent/width/index.html b/files/ja/web/api/pointerevent/width/index.html new file mode 100644 index 0000000000..e6c160a4ea --- /dev/null +++ b/files/ja/web/api/pointerevent/width/index.html @@ -0,0 +1,69 @@ +--- +title: PointerEvent.width +slug: Web/API/PointerEvent/width +tags: + - API + - DOM + - Interface + - PointerEvent + - Property + - Reference +translation_of: Web/API/PointerEvent/width +--- +
{{ APIRef("Pointer Events") }}
+ +

{{domxref("PointerEvent")}} インターフェイスの width 読み取り専用プロパティは、CSS ピクセルで測定された、x 軸に沿ったポインタの接触ジオメトリの幅を表します。 ポインタデバイスのソース（指など）に応じて、特定のポインタに対して、各イベントは異なる値を生成することがあります。

+ +

入力ハードウェアが接触ジオメトリをブラウザーに報告できない場合、幅のデフォルトは 1 です。

+ +

構文

+ +
var contactWidth = pointerEvent.width;
+
+ +

戻り値

+ +
+
contactWidth
+
イベントの接触面積の幅（CSS ピクセル単位）。
+
+ +

例

+ +

この例では、{{domxref("PointerEvent")}} インターフェイスの {{domxref("PointerEvent.width","width")}} プロパティと {{domxref("PointerEvent.height","height")}} プロパティを使用して接触面積を計算する方法を示します。

+ +
target.addEventListener("pointerdown", function(ev) {
+   // 接触面積を計算する
+   var area = ev.width * ev.height;
+ }, false);
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Pointer Events 2','#widl-PointerEvent-width', 'width')}}{{Spec2('Pointer Events 2')}}不安定版
{{SpecName('Pointer Events', '#widl-PointerEvent-width', 'width')}}{{Spec2('Pointer Events')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.PointerEvent.width")}}

-- cgit v1.2.3-54-g00ecf