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.

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

onlostpointercapture = (event) => {};

Ereignistyp

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell

Stellt den Winkel zwischen einer Transduktorachse (einem Zeiger oder Stylus) und der X-Y-Ebene eines Geräteschirms dar.

PointerEvent.azimuthAngle Schreibgeschützt 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 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 (Größe entlang der X-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.

PointerEvent.height Schreibgeschützt

Die Höhe (Größe entlang der Y-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.

PointerEvent.pressure Schreibgeschützt

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

PointerEvent.tangentialPressure Schreibgeschützt

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

PointerEvent.tiltX Schreibgeschützt

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) 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 Schreibgeschützt

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) 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 Schreibgeschützt

Die Rechtsdrehung des Zeigers (z. B. Pen Stylus) um seine Hauptachse in Grad, mit einem Wert im Bereich von 0 bis 359.

PointerEvent.pointerType Schreibgeschützt

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

PointerEvent.isPrimary Schreibgeschützt

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.

js
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:

js
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

Siehe auch