--- title: 'Element : évènement click' slug: Web/API/Element/click_event tags: - API - DOM - Element - Reference - click translation_of: Web/API/Element/click_event ---
L'évènement click
est déclenché à partir d'un élément lorsqu'un bouton d'un dispositif de pointage (comme celui d'une souris par exemple) est pressé puis relaché lorsque le pointeur est sur l'élément.
Se propage/remonte dans le DOM | Oui |
---|---|
Annulable | Oui |
Interface | {{domxref("MouseEvent")}} |
Propriété pour la gestion d'évènement | {{domxref("GlobalEventHandlers.onclick", "onclick")}} |
Si le bouton est pressé sur un élément et que le pointeur est déplacé sur un autre élément, l'évènement sera déclenché sur l'ancêtre le plus près qui contient les deux éléments.
click
est déclenché après que les évènements {{event("mousedown")}} et {{event("mouseup")}} aient été déclenchés.
L'objet {{domxref("MouseEvent")}}, passé au gestionnaire d'évènement (lorsque l'évènement est click
) possède une propriété {{domxref("Event.detail", "detail")}} qui indique le nombre de fois où la cible ({{domxref("Event.target", "target")}}) a été cliquée. Autrement dit, detail
vaudra 2 pour un double-clic, 3 pour un triple-clic et ainsi de suite. Le compteur est remis à zéro après un court intervalle (dont la durée spécifique peut varier entre les navigateurs, les plateformes et les préférences de l'utilisateur dont notamment les options d'accessibilité).
Internet Explorer 8 & 9 souffrent d'un bug où les élméents avec une {{cssxref("background-color")}} calculée qui vaut transparent
qui recouvrent d'autres éléments ne recevront pas d'évènements click
. Les évènements click
toucheront les éléments en dessous à la place.
Quelques méthodes de contournement pour ce bug :
: rgba(0,0,0,0)
: 0
et une valeur explicite pour {{cssxref("background-color")}} qui ne soit pas transparent
filter: alpha(opacity=0);
et une valeur explicite pour {{cssxref("background-color")}} qui ne soit pas transparent
Safari Mobile 7.0+ (et antérieures) souffre d'un bug indiquant que les évènements click
ne sont pas déclenchés sur les éléments qui ne sont généralement pas interactifs (ex. {{HTMLElement("div")}}) et qui n'ont pas de gestionnaire d'évènement directement attaché (on utilise la délégation d'évènement). Voir la documentation de Safari sur le fait de rendre les éléments cliquables et la définition d'un élément cliquable.
Méthodes de contournement connues :
: pointer;
sur l'élément ou l'un des ancêtres.onclick="void(0)"
à l'élément ou à l'un des ancêtres (tant que ce n'est pas {{HTMLElement("body")}}).click
.Safari Mobile considère que les éléments suivants sont interactifs (et ne souffrent donc pas de ce bug) :
href
)href
)Dans cet exemple, on affiche le nombre de clics consécutifs sur un bouton HTML ({{HTMLElement("button")}}).
<button>Cliquer ici</button>
const button = document.querySelector('button'); button.addEventListener('click', event => { button.innerHTML = `Nombre de clics : ${event.detail}`; });
Essayez de cliquer rapidement sur le bouton pour augmenter le nombre de clic. Après une pause, le compteur sera remis à zéro.
{{EmbedLiveSample("Exemples")}}
Spécification | État |
---|---|
{{SpecName('UI Events', '#event-type-click')}} | {{Spec2('UI Events')}} |
{{SpecName('DOM3 Events', '#event-type-click', 'click')}} | {{Spec2('DOM3 Events')}} |
{{SpecName('DOM2 Events', '#Events-eventgroupings-mouseevents-h3', 'click')}} | {{Spec2('DOM2 Events')}} |
{{Compat("api.Element.click_event")}}