Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Element: pointerdown-Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2020⁩.

Das pointerdown-Ereignis wird ausgelöst, wenn ein Zeigegerät aktiv wird. Bei einer Maus wird es ausgelöst, wenn das Gerät von keinem gedrückten Knopf zu mindestens einem gedrückten Knopf wechselt. Bei Berührungen wird es ausgelöst, wenn physischer Kontakt mit dem Digitizer hergestellt wird. Bei einem Stift wird es ausgelöst, wenn der Stift physischen Kontakt mit dem Digitizer herstellt.

Dieses Verhalten unterscheidet sich von mousedown-Ereignissen. Bei Verwendung einer physischen Maus werden mousedown-Ereignisse ausgelöst, wann immer ein beliebiger Knopf an einer Maus gedrückt wird. pointerdown-Ereignisse werden nur bei der ersten Knopfbetätigung ausgelöst; nachfolgende Knopfbetätigungen lösen keine pointerdown-Ereignisse aus.

Hinweis: Bei Touchscreen-Browsern, die eine direkte Manipulation erlauben, löst ein pointerdown-Ereignis eine implizite Zeigererfassung aus, die bewirkt, dass das Ziel alle nachfolgenden Zeigereignisse erfasst, als ob sie über dem erfassenden Ziel stattfinden würden. Dementsprechend werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst, solange diese Erfassung gesetzt ist. Die Erfassung kann manuell durch Aufruf von element.releasePointerCapture am Ziel-Element aufgehoben werden oder wird implizit nach einem pointerup- oder pointercancel-Ereignis freigegeben.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignisbehandlungs-Eigenschaft.

js
addEventListener("pointerdown", (event) => { })

onpointerdown = (event) => { }

Ereignistyp

Ein PointerEvent. Erbt von Event.

Event UIEvent MouseEvent PointerEvent

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell

Repräsentiert den Winkel zwischen einer Transducer-Achse (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräts.

PointerEvent.azimuthAngle Schreibgeschützt Experimentell

Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Transducer-Achse (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 erzeugt.

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 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 der Zeigereingabe (auch bekannt als Laufdruck oder Zylinderstress) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Steuerung darstellt.

PointerEvent.tiltX Schreibgeschützt

Der Ebnenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stift) als auch die Y-Achse enthält.

PointerEvent.tiltY Schreibgeschützt

Der Ebnenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stift) als auch die X-Achse enthält.

PointerEvent.twist Schreibgeschützt

Die im Uhrzeigersinn Rotation des Zeigers (z.B. Stift) 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, etc.).

PointerEvent.isPrimary Schreibgeschützt

Zeigt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Beispiele

Verwendung von addEventListener():

js
const para = document.querySelector("p");

para.addEventListener("pointerdown", (event) => {
  console.log("Pointer down event");
});

Verwendung der onpointerdown-Ereignisbehandlungseigenschaft:

js
const para = document.querySelector("p");

para.onpointerdown = (event) => {
  console.log("Pointer down event");
};

Spezifikationen

Specification
Pointer Events
# the-pointerdown-event
Pointer Events
# dom-globaleventhandlers-onpointerdown

Browser-Kompatibilität

Siehe auch