Element : évènement pointerdown
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2020.
L'évènement pointerdown est déclenché lorsqu'un pointeur devient actif. Pour la souris, il est déclenché lorsque le périphérique passe de aucun bouton enfoncé à au moins un bouton enfoncé. Pour le tactile, il est déclenché lorsqu'un contact physique est établi avec le numériseur. Pour le stylet, il est déclenché lorsque le stylet entre en contact physique avec le numériseur.
Ce comportement est différent de celui des évènements mousedown. Lors de l'utilisation d'une souris physique, les évènements mousedown se déclenchent chaque fois qu'un bouton de la souris est enfoncé. Les évènements pointerdown ne se déclenchent que lors du premier appui sur un bouton ; les appuis suivants ne déclenchent pas d'évènement pointerdown.
Note :
Pour les navigateurs tactiles qui permettent la manipulation directe (angl.), un évènement pointerdown déclenche une capture implicite du pointeur (angl.), ce qui fait que la cible capture tous les évènements de pointeur suivants comme s'ils se produisent sur la cible de capture. En conséquence, pointerover, pointerenter, pointerleave et pointerout ne se déclenchent pas tant que cette capture est active. La capture peut être libérée manuellement en appelant element.releasePointerCapture sur l'élément cible, ou elle est libérée implicitement après un évènement pointerup ou pointercancel.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.
addEventListener("pointerdown", (event) => { })
onpointerdown = (event) => { }
Type d'évènement
Un objet PointerEvent. Hérite de Event.
Exemples
Utilisation de addEventListener() :
const para = document.querySelector("p");
para.addEventListener("pointerdown", (event) => {
console.log("Évènement d'appui sur le pointeur");
});
Utilisation de la propriété de gestionnaire d'évènement onpointerdown :
const para = document.querySelector("p");
para.onpointerdown = (event) => {
console.log("Évènement d'appui sur le pointeur");
};
Spécifications
| Spécification |
|---|
| Pointer Events # the-pointerdown-event |
| Pointer Events # dom-globaleventhandlers-onpointerdown |