--- title: element.onclick slug: Web/API/GlobalEventHandlers/onclick translation_of: Web/API/GlobalEventHandlers/onclick ---

{{ ApiRef() }}

Résumé

La propriété onclick représente le gestionnaire d'évènement onClick de l'élément courant.

Syntaxe

element.onclick = functionRef

functionRef est une fonction ou une expression de type function. Consulter la référence des fonctions pour plus de détails.

Le paramètre fourni au gestionnaire d'évènement functionRef lors du déclenchement de l'évènement est un objet qui représente l'évènement de click, de type {{ domxref("MouseEvent") }}.

Exemple

<!doctype html>
<html>
<head>
<title>onclick event example</title>
<script type="text/javascript">
function initElement()
{
  var p = document.getElementById("foo");
  // NOTE: showAlert(); ou showAlert(param); NE fonctionne PAS ici.
  // Il faut fournir une valeur de type function (nom de fonction déclaré ailleurs ou declaration en ligne de fonction).
  p.onclick = showAlert;
};

function showAlert()
{
  alert("Evènement de click détecté");
}
</script>
<style type="text/css">
#foo {
border: solid blue 2px;
}
</style>
</head>
<body onload="initElement();">
<span id="foo">Mon Span à cliquer</span>
<p>Cliquez sur l'élément ci-dessus.</p>
</body>
</html>

Vous pouvez aussi utiliser la syntaxe des fonctions déclarées en ligne, anonymes ou non.

// affectation de fonction anonyme declarée en ligne
p.onclick = function() { alert("moot!"); };

Notes

L'évènement click est déclenché lorsque l'utilisateur clique sur un élément.

Avec cette syntaxe un seul gestionnaire d'évènement click peut être assigné à un élement . Pour gérer plusieurs fonctions gestionnaires d'évènements click sur un même élément, utilisez {{ domxref("EventTarget.addEventListener()") }} qui fait partie de la spécification DOM Events.

Spécification

Defini en HTML.

{{ languages( { "en": "en/DOM/element.onclick", "pl": "pl/DOM/element.onclick" } ) }}