Element: pointerdown-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.
Das pointerdown-Ereignis wird ausgelöst, wenn ein Zeiger aktiv wird. Bei einer Maus geschieht dies, wenn von keiner gedrückten Taste zu mindestens einer gedrückten Taste gewechselt wird. Bei einer Berührung wird es ausgelöst, wenn physischer Kontakt mit dem Digitizer hergestellt wird. Bei einem Stift wird es ausgelöst, wenn die Stiftspitze physischen Kontakt mit dem Digitizer herstellt.
Dieses Verhalten unterscheidet sich von mousedown-Ereignissen. Bei einer physischen Maus werden mousedown-Ereignisse jedes Mal ausgelöst, wenn eine Maustaste gedrückt wird. pointerdown-Ereignisse werden nur beim ersten Tastendruck ausgelöst; weitere Tastendrücke lösen keine pointerdown-Ereignisse aus.
Hinweis:
In Touchscreen-Browsern, die direkte Manipulation erlauben, löst ein pointerdown-Ereignis eine implizite Zeigererfassung aus. Dadurch erfasst das Zielelement alle nachfolgenden Zeigerereignisse, als würden sie über ihm stattfinden. Solange diese Erfassung besteht, werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst. Die Erfassung kann manuell aufgehoben werden, indem Sie element.releasePointerCapture für das Zielelement aufrufen. Nach einem pointerup- oder pointercancel-Ereignis wird sie automatisch aufgehoben.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("pointerdown", (event) => { })
Alternativ können Sie ihn der Ereignishandler-Eigenschaft der Schnittstelle zuweisen:
onpointerdown = (event) => { }
Ereignistyp
Ein PointerEvent. Erbt von Event.
Beispiele
Mit addEventListener():
const para = document.querySelector("p");
para.addEventListener("pointerdown", (event) => {
console.log("Pointer down event");
});
Mit der Ereignishandler-Eigenschaft onpointerdown (beachten Sie jedoch, dass dadurch gegebenenfalls andere mit onpointerdown hinzugefügte Ereignislistener ersetzt werden):
const para = document.querySelector("p");
para.onpointerdown = (event) => {
console.log("Pointer down event");
};
Spezifikationen
| Spezifikation |
|---|
| Pointer Events # pointerdown |
| Pointer Events # dom-globaleventhandlers-onpointerdown |