Element: lostpointercapture 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 lostpointercapture
Ereignis wird ausgelöst, wenn ein erfasster Zeiger freigegeben wird.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
, oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("lostpointercapture", (event) => {});
onlostpointercapture = (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 einer Transduktorachse (einem Zeiger oder Stylus) und der X-Y-Ebene eines Geräteschirms dar.
PointerEvent.azimuthAngle
Nur lesbar Experimentell-
Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Transduktorachse (einen 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 (Größe entlang der X-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.
PointerEvent.height
Nur lesbar-
Die Höhe (Größe entlang der Y-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.
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 erkennen kann. PointerEvent.tangentialPressure
Nur lesbar-
Der normalisierte tangentiale Druck des Zeigereingangs (auch bekannt als Barrel-Druck oder Zylinderbelastung) im Bereich von
-1
bis1
, wobei0
die neutrale Position der Steuerung 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 Zeigerachse (z. B. Pen Stylus) 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 Zeigerachse (z. B. Pen Stylus) als auch die X-Achse enthält. PointerEvent.twist
Nur lesbar-
Die Rechtsdrehung des Zeigers (z. B. Pen Stylus) um seine Hauptachse 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 usw.).
PointerEvent.isPrimary
Nur lesbar-
Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Beispiele
Dieses Beispiel hört auf das lostpointercapture
Ereignis für ein Element und erfasst den Zeiger für das Element bei pointerdown
. Wenn der Benutzer anschließend den Zeiger loslässt, wird das lostpointercapture
Ereignis ausgelöst.
const para = document.querySelector("p");
para.addEventListener("lostpointercapture", () => {
console.log("I've been released!");
});
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});
Das gleiche Beispiel, aber unter Verwendung der onlostpointercapture
Ereignishandler-Eigenschaft:
const para = document.querySelector("p");
para.onlostpointercapture = () => {
console.log("I've been released!");
};
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});
Spezifikationen
Specification |
---|
Pointer Events # the-lostpointercapture-event |
Pointer Events # dom-globaleventhandlers-onlostpointercapture |
Browser-Kompatibilität
BCD tables only load in the browser