Element: pointerover-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 pointerover
-Ereignis wird ausgelöst, wenn ein Zeigegerät in die Treffertest-Grenzen eines Elements bewegt wird.
pointerover
-Ereignisse haben die gleichen Probleme wie mouseover
. Wenn das Ziel-Element Kind-Elemente enthält, werden pointerout
- und pointerover
-Ereignisse auch ausgelöst, während der Zeiger über die Grenzen dieser Elemente bewegt wird, nicht nur über das Ziel-Element selbst. In der Regel ist das Verhalten von pointerenter
- und pointerleave
-Ereignissen sinnvoller, da sie nicht durch das Übergehen in Kind-Elemente beeinflusst werden.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("pointerover", (event) => {});
onpointerover = (event) => {};
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
Eigenschaften des Ereignisses
Diese Schnittstelle erbt Eigenschaften von MouseEvent
und Event
.
PointerEvent.altitudeAngle
Schreibgeschützt Experimentell-
Repräsentiert den Winkel zwischen der Achse eines Transducers (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräteschirms.
PointerEvent.azimuthAngle
Schreibgeschützt Experimentell-
Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Transducers (einem Zeiger oder Stift) 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 (Magnitude auf der X-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.
PointerEvent.height
Schreibgeschützt-
Die Höhe (Magnitude auf der Y-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.
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 bekannt als Barrel Pressure oder Zylinderstress) 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. Stift) 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. Stift) als auch die X-Achse enthält. PointerEvent.twist
Schreibgeschützt-
Die Drehung des Zeigers (z. B. Stift) im Uhrzeigersinn um seine Hauptachse in Grad, mit einem Wert im Bereich von
0
bis359
. PointerEvent.pointerType
Schreibgeschützt-
Zeigt den Gerätetyp an, der das Ereignis verursacht hat (z. B. Maus, Stift, Berührung).
PointerEvent.isPrimary
Schreibgeschützt-
Zeigt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Beispiele
Verwendung von addEventListener()
:
const para = document.querySelector("p");
para.addEventListener("pointerover", (event) => {
console.log("Pointer moved in");
});
Verwendung der onpointerover
-Ereignis-Handler-Eigenschaft:
const para = document.querySelector("p");
para.onpointerover = (event) => {
console.log("Pointer moved in");
};
Spezifikationen
Specification |
---|
Pointer Events # the-pointerover-event |
Pointer Events # dom-globaleventhandlers-onpointerover |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
pointerover event |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Requires a vendor prefix or different name for use.
- Has more compatibility info.