PointerEvent
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 PointerEvent
-Interface repräsentiert den Zustand eines DOM-Ereignisses, das durch einen Zeiger erzeugt wurde, wie die Geometrie des Kontaktpunkts, den Gerätetyp, der das Ereignis erzeugt hat, den Druck, der auf die Kontaktfläche ausgeübt wurde, usw.
Ein Zeiger ist eine hardwareunabhängige Darstellung von Eingabegeräten (wie einer Maus, einem Stift oder einem Kontaktpunkt auf einer berührungsempfindlichen Oberfläche). Der Zeiger kann auf eine bestimmte Koordinate (oder Koordinatensatz) auf der Kontaktfläche wie einem Bildschirm zielen.
Ein Zeiger-Treffertest ist der Prozess, den ein Browser verwendet, um das Ziel-Element für ein Zeigerereignis zu bestimmen. Typischerweise wird dies durch Berücksichtigung des Standorts des Zeigers und auch des visuellen Layouts der Elemente in einem Dokument auf Bildschirmmedien bestimmt.
Konstruktoren
PointerEvent()
-
Erstellt ein synthetisches und nicht vertrauenswürdiges
PointerEvent
.
Instanz-Eigenschaften
Diese Schnittstelle erbt Eigenschaften von MouseEvent
und Event
.
PointerEvent.altitudeAngle
Nur lesbar-
Repräsentiert den Winkel zwischen der Achse eines Wandlers (eines Zeigers oder Stiftes) und der X-Y-Ebene eines Gerätebildschirms.
PointerEvent.azimuthAngle
Nur lesbar-
Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Wandlers (eines Zeigers oder Stiftes) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId
Nur lesbar Experimentell-
Eine eindeutige Kennung für das Eingabegerä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 der Zeigereingabe 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 der Zeigereingabe (auch bekannt als Fassdruck oder Zylinderbelastung) im Bereich
-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 Achse des Zeigers (z.B. Stift) 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. Stift) als auch die X-Achse enthält. PointerEvent.twist
Nur lesbar-
Die im Uhrzeigersinn gerichtete Drehung des Zeigers (z.B. Stift) 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, Touch usw.).
PointerEvent.isPrimary
Nur lesbar-
Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Instanz-Methoden
PointerEvent.getCoalescedEvents()
Secure context-
Gibt eine Sequenz aller
PointerEvent
-Instanzen zurück, die zu dem ausgelöstenpointermove
-Ereignis zusammengefasst wurden. PointerEvent.getPredictedEvents()
-
Gibt eine Sequenz von
PointerEvent
-Instanzen zurück, die der Browser vorausgesagt hat, nachdem die zu dem ausgelöstenpointermove
-Ereignis zusammengefassten Ereignisse folgen werden.
Zeiger-Ereignistypen
Das PointerEvent
-Interface hat mehrere Ereignistypen. Um zu bestimmen, welches Ereignis ausgelöst wurde, sehen Sie sich die type
-Eigenschaft des Ereignisses an.
Hinweis: Es ist wichtig zu beachten, dass in vielen Fällen sowohl Zeiger- als auch Mauserereignisse gesendet werden (um nicht zeigerspezifischem Code zu ermöglichen, weiterhin mit dem Benutzer zu interagieren). Wenn Sie Zeigerereignisse verwenden, sollten Sie preventDefault()
aufrufen, um zu verhindern, dass das Mauserereignis ebenfalls gesendet wird.
pointerover
-
Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät in die Treffertest-Grenzen eines Elements bewegt wird.
pointerenter
-
Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät in die Treffertest-Grenzen eines Elements oder eines seiner Nachkommen bewegt wird, einschließlich als Ergebnis eines
pointerdown
-Ereignisses eines Geräts, das Hover nicht unterstützt (siehepointerdown
). Dieser Ereignistyp ähneltpointerover
, unterscheidet sich jedoch dadurch, dass er nicht aufsteigt. pointerdown
-
Das Ereignis wird ausgelöst, wenn ein Zeiger aktiv wird. Für die Maus wird es ausgelöst, wenn das Gerät vom Drücken keiner Tasten zum Drücken von mindestens einer Taste übergeht. Für Touch wird es ausgelöst, wenn physischer Kontakt mit dem Digitalisierer hergestellt wird. Für Stift wird es ausgelöst, wenn der Stift physischen Kontakt mit dem Digitalisierer herstellt.
Hinweis: Für Touchscreen-Browser, die direkte Manipulation erlauben, löst ein
pointerdown
-Ereignis eine implizite Zeigererfassung aus, wodurch das Ziel alle nachfolgenden Zeigereignisse erfasst, als ob sie über dem erfassenden Ziel auftreten würden. Dementsprechend werdenpointerover
,pointerenter
,pointerleave
undpointerout
nicht ausgelöst, solange diese Erfassung gesetzt ist. Die Erfassung kann manuell durch Aufruf vonelement.releasePointerCapture
auf dem Zielelement freigegeben werden oder wird nach einempointerup
- oderpointercancel
-Ereignis automatisch freigegeben. pointermove
-
Dieses Ereignis wird ausgelöst, wenn ein Zeiger Koordinaten ändert.
pointerrawupdate
Experimentell-
Dieses Ereignis wird ausgelöst, wenn sich eine der Eigenschaften eines Zeigers ändert.
pointerup
-
Dieses Ereignis wird ausgelöst, wenn ein Zeiger nicht mehr aktiv ist.
pointercancel
-
Ein Browser löst dieses Ereignis aus, wenn er feststellt, dass der Zeiger keine Ereignisse mehr generieren kann (z.B. wenn das zugehörige Gerät deaktiviert ist).
pointerout
-
Dieses Ereignis wird aus mehreren Gründen ausgelöst: wenn das Zeigegerät aus den Treffertest-Grenzen eines Elements bewegt wird; wenn das
pointerup
-Ereignis für ein Gerät, das Hover nicht unterstützt, ausgelöst wird (siehepointerup
); nach dem Auslösen despointercancel
-Ereignisses (siehepointercancel
); wenn ein Stift die Hover-Reichweite verlässt, die der Digitalisierer erkennen kann. pointerleave
-
Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät aus den Treffertest-Grenzen eines Elements bewegt wird. Für Stiftgeräte wird dieses Ereignis ausgelöst, wenn der Stift die Hover-Reichweite verlässt, die der Digitalisierer erkennen kann.
gotpointercapture
-
Dieses Ereignis wird ausgelöst, wenn ein Element die Zeigererfassung erhält.
lostpointercapture
-
Dieses Ereignis wird ausgelöst, nachdem die Zeigererfassung für einen Zeiger freigegeben wurde.
Beispiel
Beispiele für jede Eigenschaft, jeden Ereignistyp und jeden globalen Ereignishandler sind in den jeweiligen Referenzseiten enthalten.
Spezifikationen
Specification |
---|
Pointer Events # pointerevent-interface |
Browser-Kompatibilität
BCD tables only load in the browser