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.
Das gotpointercapture
Ereignis wird ausgelöst, wenn ein Element einen Zeiger mit setPointerCapture()
erfasst.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("gotpointercapture", (event) => { })
ongotpointercapture = (event) => { }
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von MouseEvent
und Event
.
PointerEvent.altitudeAngle
Schreibgeschützt Experimentell-
Repräsentiert den Winkel zwischen der Achse des Wandlers (eines Zeigers oder Stylus) und der X-Y-Ebene eines Gerätes.
PointerEvent.azimuthAngle
Schreibgeschützt Experimentell-
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.persistentDeviceId
Schreibgeschützt Experimentell-
Eine eindeutige Kennung für das Zeigegerät, das das
PointerEvent
erzeugt. PointerEvent.pointerId
Schreibgeschützt-
Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width
Schreibgeschützt-
Die Breite (Ausdehnung auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.height
Schreibgeschützt-
Die Höhe (Ausdehnung auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.pressure
Schreibgeschützt-
Der normalisierte Druck der Zeigereingabe im Bereich von
0
bis1
, wobei0
und1
den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann. PointerEvent.tangentialPressure
Schreibgeschützt-
Der normalisierte tangentiale Druck der Zeigereingabe (auch als Fassdruck oder Zylinderbelastung bekannt) im Bereich von
-1
bis1
, wobei0
die neutrale Position der Steuerung ist. PointerEvent.tiltX
Schreibgeschü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.tiltY
Schreibgeschü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.twist
Schreibgeschützt-
Die Drehung im Uhrzeigersinn des Zeigers (z. B. Stiftstylus) um seine Hauptachse in Grad, mit einem Wert im Bereich von
0
bis359
. PointerEvent.pointerType
Schreibgeschützt-
Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Touch usw.).
PointerEvent.isPrimary
Schreibgeschützt-
Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Beispiele
Dieses Beispiel erfasst ein <p>
-Element und wartet 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
Loading…