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.
addEventListener("gotpointercapture", (event) => {});
ongotpointercapture = (event) => {};
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
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
bis1
, wobei0
und1
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
bis1
, wobei0
die neutrale Position der Kontrolle ist. PointerEvent.tiltX
Nur lesbar-
Der Ebenenwinkel (in Grad, im Bereich von
-90
bis90
) 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
bis90
) 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
bis359
. 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.
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:
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