element.onclick

« Référence du DOM

Résumé

La propriété onclick représente le gestionaire 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 fournit au gestionnaire d'évènement functionRef lors du déclenchement de l'évènement est objet qui représente l'évènement de click, de type 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é à une élement . Pour gérer plusieurs fonctions gestionnaires d'évènements click sur un même élément, utilisez element.addEventListener() qui fait partie de la spécification DOM Events.

Spécification

Defini en HTML.

Étiquettes et contributeurs liés au document

Étiquettes :
Contributeurs ayant participé à cette page : BenoitL, Priam, Mgjbot
Dernière mise à jour par : Priam,