Element: pointerup-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 pointerup
-Ereignis wird ausgelöst, wenn ein Zeiger nicht mehr aktiv ist. Beachten Sie, dass es möglich ist, stattdessen ein pointercancel
-Ereignis zu erhalten.
Dieses Verhalten unterscheidet sich von mouseup
-Ereignissen. Bei der Verwendung einer physischen Maus werden mouseup
-Ereignisse ausgelöst, wenn eine beliebige Taste an einer Maus losgelassen wird. pointerup
-Ereignisse werden nur beim Loslassen der letzten Taste ausgelöst; vorherige Tastenfreigaben, während andere Tasten gedrückt gehalten werden, lösen keine pointerup
-Ereignisse aus.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("pointerup", (event) => { })
onpointerup = (event) => { }
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von MouseEvent
und Event
.
PointerEvent.altitudeAngle
Schreibgeschützt Experimentell-
Stellt den Winkel zwischen einer Transducer- (Zeiger- oder Stift-) Achse und der X-Y-Ebene eines Geräts dar.
PointerEvent.azimuthAngle
Schreibgeschützt Experimentell-
Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Transducerachse (Zeiger- oder Stiftachse) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId
Schreibgeschützt Experimentell-
Eine eindeutige Kennung für das Zeigegerät, das das
PointerEvent
generiert. PointerEvent.pointerId
Schreibgeschützt-
Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width
Schreibgeschützt-
Die Breite (Größe auf der X-Achse) in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height
Schreibgeschützt-
Die Höhe (Größe auf der Y-Achse) in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.pressure
Schreibgeschützt-
Der normalisierte Druck der Zeigereingabe im Bereich
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 bekannt als Fassdruck oder Zylinderstress) im Bereich
-1
bis1
, wobei0
die neutrale Position der Steuerung ist. PointerEvent.tiltX
Schreibgeschützt-
Der Winkelschnitt (in Grad, im Bereich von
-90
bis90
) zwischen der Y–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. eines Stifts) als auch die Y-Achse enthält. PointerEvent.tiltY
Schreibgeschützt-
Der Winkelschnitt (in Grad, im Bereich von
-90
bis90
) zwischen der X–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. eines Stifts) als auch die X-Achse enthält. PointerEvent.twist
Schreibgeschützt-
Die Drehung im Uhrzeigersinn des Zeigers (z.B. eines Stifts) 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, Berührung etc.).
PointerEvent.isPrimary
Schreibgeschützt-
Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Beispiele
Verwendung von addEventListener()
:
const para = document.querySelector("p");
para.addEventListener("pointerup", (event) => {
console.log("Pointer up");
});
Verwendung der onpointerup
-Ereignis-Handler-Eigenschaft:
const para = document.querySelector("p");
para.onpointerup = (event) => {
console.log("Pointer up");
};
Spezifikationen
Specification |
---|
Pointer Events # the-pointerup-event |
Pointer Events # dom-globaleventhandlers-onpointerup |