Element: gotpointercapture Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

Das gotpointercapture-Ereignis wird ausgelöst, wenn ein Element einen Zeiger mit setPointerCapture() erfasst.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Ereignishandler-Eigenschaft fest.

js
addEventListener("gotpointercapture", (event) => {});

ongotpointercapture = (event) => {};

Ereignistyp

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Nur lesbar Experimentell

Stellt den Winkel zwischen der Achse eines Wandlers (einem Zeiger oder Stylus) und der X-Y-Ebene eines Gerätebildschirms dar.

PointerEvent.azimuthAngle Nur lesbar Experimentell

Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Achse des Wandlers (einem Zeiger oder Stylus) als auch die Y-Achse enthält.

PointerEvent.persistentDeviceId Nur lesbar Experimentell

Eine eindeutige Kennung für das Zeigegerät, das das PointerEvent erzeugt.

PointerEvent.pointerId Nur lesbar

Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.

PointerEvent.width Nur lesbar

Die Breite (Magnitude auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.

PointerEvent.height Nur lesbar

Die Höhe (Magnitude auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.

PointerEvent.pressure Nur lesbar

Der normalisierte Druck des Zeigereingangs im Bereich von 0 bis 1, wobei 0 und 1 den minimalen und maximalen Druck darstellen, den die Hardware erfassen kann.

PointerEvent.tangentialPressure Nur lesbar

Der normalisierte tangentiale Druck des Zeigereingangs (auch bekannt als Fassdruck oder Zylinderstress) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Kontrolle ist.

PointerEvent.tiltX Nur lesbar

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. eines Stift-Sstylus) als auch die Y-Achse enthält.

PointerEvent.tiltY Nur lesbar

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. eines Stift-Sstylus) als auch die X-Achse enthält.

PointerEvent.twist Nur lesbar

Die Drehung des Zeigers (z.B. eines Stift-Sstylus) um seine Hauptachse im Uhrzeigersinn in Grad, mit einem Wert im Bereich von 0 bis 359.

PointerEvent.pointerType Nur lesbar

Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung, etc.).

PointerEvent.isPrimary Nur lesbar

Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Beispiele

Dieses Beispiel erhält ein <p>-Element und lauscht auf das gotpointercapture-Ereignis. Es ruft dann setPointerCapture() auf dem Element bei einem pointerdown-Ereignis auf, was gotpointercapture auslösen wird.

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

para.addEventListener("gotpointercapture", () => {
  console.log("I've been captured!");
});

para.addEventListener("pointerdown", (event) => {
  para.setPointerCapture(event.pointerId);
});

Dasselbe Beispiel unter Verwendung der ongotpointercapture-Ereignishandler-Eigenschaft:

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

para.ongotpointercapture = () => {
  console.log("I've been captured!");
};

para.addEventListener("pointerdown", (event) => {
  para.setPointerCapture(event.pointerId);
});

Spezifikationen

Specification
Pointer Events
# the-gotpointercapture-event
Pointer Events
# dom-globaleventhandlers-ongotpointercapture

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch