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 ⁨Juli 2020⁩.

Dasgotpointercapture Ereignis wird ausgelöst, wenn ein Element einen Zeiger mitsetPointerCapture() erfasst.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wieaddEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

addEventListener("gotpointercapture", (event) => { })ongotpointercapture = (event) => { }

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften vonMouseEvent undEvent.

PointerEvent.altitudeAngleSchreibgeschütztExperimentell: Repräsentiert den Winkel zwischen der Achse des Wandlers (eines Zeigers oder Stylus) und der X-Y-Ebene eines Gerätes.
PointerEvent.azimuthAngleSchreibgeschütztExperimentell: Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Wandlers (eines Zeigers oder Stylus) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceIdSchreibgeschütztExperimentell: Eine eindeutige Kennung für das Zeigegerät, das dasPointerEvent erzeugt.
PointerEvent.pointerIdSchreibgeschützt: Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.widthSchreibgeschützt: Die Breite (Ausdehnung auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.heightSchreibgeschützt: Die Höhe (Ausdehnung auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.pressureSchreibgeschützt: Der normalisierte Druck der Zeigereingabe im Bereich von0 bis1, wobei0 und1 den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann.
PointerEvent.tangentialPressureSchreibgeschützt: Der normalisierte tangentiale Druck der Zeigereingabe (auch als Fassdruck oderZylinderbelastung bekannt) im Bereich von-1 bis1, wobei0 die neutrale Position der Steuerung ist.
PointerEvent.tiltXSchreibgeschützt: Der Winkel (in Grad, im Bereich von-90 bis90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z. B. Stiftstylus) als auch die Y-Achse enthält.
PointerEvent.tiltYSchreibgeschützt: Der Winkel (in Grad, im Bereich von-90 bis90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z. B. Stiftstylus) als auch die X-Achse enthält.
PointerEvent.twistSchreibgeschützt: Die Drehung im Uhrzeigersinn des Zeigers (z. B. Stiftstylus) um seine Hauptachse in Grad, mit einem Wert im Bereich von0 bis359.
PointerEvent.pointerTypeSchreibgeschützt: Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Touch usw.).
PointerEvent.isPrimarySchreibgeschützt: Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Dieses Beispiel erfasst ein<p>-Element und wartet auf dasgotpointercapture Ereignis. Es ruft dannsetPointerCapture() auf dem Element bei einempointerdown Ereignis auf, wasgotpointercapture auslösen wird.

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 derongotpointercapture Ereignishandler-Eigenschaft:

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

Siehe auch

Verwandte Ereignisse

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden

Movatterモバイル変換