Skip to content

Latest commit

 

History

History
104 lines (77 loc) · 5.95 KB

File metadata and controls

104 lines (77 loc) · 5.95 KB
title short-title slug l10n
Element: pointerdown イベント
pointerdown
Web/API/Element/pointerdown_event
sourceCommit
6636dfb792a72346c68e44c9d042e3c2219e522b

{{APIRef}}

pointerdown イベントは、ポインターがアクティブになったときに発生します。マウスでは、その機器のボタンが押されていない状態から 1 つ以上のボタンが押されている状態に遷移したときに発生します。タッチ操作では、デジタイザーに物理的な接触が行われたときに発生します。ペンでは、スタイラスがデジタイザーに物理的に接触したときに発生します。

メモ: 直接操作ができるタッチ画面のブラウザーでは、 pointerdown イベントで暗黙的なポインターキャプチャが発生するため、ターゲットが以降のすべてのポインターイベントをキャプチャし、キャプチャターゲット上で発生したかのように扱います。そのため、 pointerover, pointerenter, pointerleave, pointerout はこのキャプチャーが発生している間は発生しません。このキャプチャはターゲット要素上で {{domxref('element.releasePointerCapture')}} を呼び出すことで手動で解除することができ、 pointerup または pointercancel イベントの後で暗黙的に解除されます。

構文

このイベント名を {{domxref("EventTarget.addEventListener", "addEventListener()")}} などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

addEventListener("pointerdown", (event) => {});

onpointerdown = (event) => {};

イベント型

{{domxref("PointerEvent")}} です。 {{domxref("Event")}} を継承しています。

{{InheritanceDiagram("PointerEvent")}}

イベントプロパティ

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

  • {{domxref('PointerEvent.altitudeAngle')}} {{ReadOnlyInline}} {{experimental_inline}}
    • : トランスデューサー(ポインターまたはスタイラス)の軸と端末画面の X-Y 平面との間の角度を表します。
  • {{domxref('PointerEvent.azimuthAngle')}} {{ReadOnlyInline}} {{experimental_inline}}
    • : Y-Z 平面と、トランスデューサー(ポインターまたはスタイラス)の軸と Y 軸の両方を格納する平面との間の角度を表します。
  • {{domxref('PointerEvent.pointerId')}} {{ReadOnlyInline}}
    • : イベントを発生させたポインターの固有の識別子です。
  • {{domxref('PointerEvent.width')}} {{ReadOnlyInline}}
    • : ポインターが接触するジオメトリーの幅(X 軸の大きさ、CSS ピクセル単位)。
  • {{domxref('PointerEvent.height')}} {{ReadOnlyInline}}
    • : ポインターが接触するジオメトリーの高さ(Y 軸の大きさ、CSS ピクセル単位)。
  • {{domxref('PointerEvent.pressure')}} {{ReadOnlyInline}}
    • : ポインター入力の正規化された圧力で、範囲は 0 から 1 です。ここで 01 は、それぞれハードウェアが検出可能な最小圧力と最大圧力を表します。
  • {{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}}
    • : このポインターがこのポインター種別の主ポインターを表すかどうかを示します。

addEventListener() を使用した例です。

const para = document.querySelector("p");

para.addEventListener("pointerdown", (event) => {
  console.log("Pointer down event");
});

onpointerdown イベントハンドラープロパティを使用した例です。

const para = document.querySelector("p");

para.onpointerdown = (event) => {
  console.log("Pointer down event");
};

仕様書

{{Specifications}}

ブラウザーの互換性

{{Compat}}

関連情報

  • 関連イベント

    • {{domxref('Element/gotpointercapture_event', 'gotpointercapture')}}
    • {{domxref('Element/lostpointercapture_event', 'lostpointercapture')}}
    • {{domxref('Element/pointerover_event', 'pointerover')}}
    • {{domxref('Element/pointerenter_event', 'pointerenter')}}
    • {{domxref('Element/pointerdown_event', 'pointerdown')}}
    • {{domxref('Element/pointermove_event', 'pointermove')}}
    • {{domxref('Element/pointerup_event', 'pointerup')}}
    • {{domxref('Element/pointercancel_event', 'pointercancel')}}
    • {{domxref('Element/pointerout_event', 'pointerout')}}
    • {{domxref('Element/pointerleave_event', 'pointerleave')}}
    • {{domxref('Element/pointerrawupdate_event', 'pointerrawupdate')}}