JavaScript : les évènements

Notion de programmation événementielle

JS est un langage événementiel : il détecte un évènement et qui survient dans la page et lance un traitement.
A la lecture des pages précédentes de ce tutoriel vous pouvez penser à juste titre qu'il n'y a qu'un évènement : clic (click en anglais).
Et bien non il y a d'autres évènements. Citons focus, blur, change, load, mouseover, unload, submit, etc.
Pour la détection des évènements on peut utiliser le HTML ou le JavaScript.

Détection des évènements par le HTML

C'est la solution historique mais dépassée car elle présente des inconvénients.

Thématique : suite à un clic sur un bouton de commande le visiteur peut saisir son nom et en retour il y a affichage d'un message de bienvenue.

Première solution

Le script est intégré dans le code HTML et appelé via un attribut évènementiel de l'élément HTML concerné. ... <body> <button onclick ="var nom =prompt('saisir votre nom'); var message = 'Bonjour mon cher ' + nom ;document.write(message);" >Cliquez ici !</button> </body> ...

Donc l'évènement est détecté par le code HTML grâce à l'ajout d'un attribut événementiel.

onclick : se déclenche lorsque l’utilisateur clique sur un élément ;
onmouseover : se déclenche lorsque l’utilisateur passe le curseur sur un élément ;
onmouseout : se déclenche lorsque l’utilisateur quitte l'élément avec son curseur ;

Le rendu de ce code :

Notez que tous les évènements commencent par le préfixe "on" et que ces attributs, conformément à la syntaxe HTML, doivent être écrits en minuscules.
La valeur de l'attribut événementiel doit être entre guillemets double. Il faut donc utiliser des guillemets simples pour délimiter les chaines. En effet en HTML le caractère d'échappement (antislash) n'est pas autorisé.

Deuxième solution

Il est plus simple de déporter le code JS dans une fonction comme je fais ci-dessous. ... <body> <button onclick ="bonjour()" >Cliquez ici !</button> <script> function bonjour() { var nom =prompt("saisir votre nom"); var message = "bonjour mon cher " + nom ; document.write(message); } </script></body> ...

Le rendu du code amélioré :

Le rendu est strictement identique mais la maintenance du code sera plus facile.

Détection des évènements par JS

L'utilisation des attributs événementiels de HTML présente un gros inconvénient : le code JS est mélangé avec le code HTML. Le code JS est dispersé dans toute la page.
Avec l'utilisation du gestionnaire d'évènements de JavaScript, le code JS est centralisé. La séparation entre le code HTML et le code JS est totale.

solution "onEvent" ; la plus ancienne
solution récente : utiliser la méthode addEventListener (écoute d'évènement) la syntaxe devient alors : élément.addEventListener("évènement", fonction)

Solution "onevent"

La syntaxe est : élément.onevent = fonction ... <button>Cliquez sur le bouton !</button> <script> document.querySelector('button').onclick = function() { var nom = prompt('tapez votre nom') ; alert("bonjour " + nom );} </script> ...

Notez l'emploi ici d'une fonction anonyme.
Tous les événements sont préfixés par "on" et sont écrits en minuscules : onclick, onmouseover, onsubmit, onload, etc.
Pour cibler l'élément de la page privilégiez les méthodes document.querySelectorAll() & ou document.querySelector() qui sont argumentées avec un sélecteur CSS.

Le rendu de ce code :

L'emploi du gestionnaire d'évènements JS offre un autre avantage : possibilité d'utiliser l'objet event que nous évoquerons bientôt.

Deuxième solution : méthode addEventListener()

La syntaxe est alors : élément.addEventListener('évènement',fonction) ... <body> <button>Cliquez ici !</button> <script> document.querySelector('button').addEventListener('click',bonjour); function bonjour(event) { var nom = prompt('tapez votre nom') ; document.write("bonjour " + nom ); console.log(event.type); console.log(event.currentTarget); } </script> ...

Le rendu de ce code :

La console précise le type d'évènement et l'élément de la page concerné.

La méthode addEventListener ajoute au gestionnaire d'évènement l'écoute de l'évènement d'où de terme "listener".

le nom de l'évènement. Par exemple "click" et non pas "onclick"
nom de la fonction appelée

Un objet de type "Event" peut être passé en argument de la fonction.

Méthode addEventListener - autre exemple

L'emploi de la méthode addEventListener donne une syntaxe un peu plus lourde mais offre un gros avantage : possibilité d'associer sur un même élément et pour le même évènement, plusieurs fonctions. ... <button>Cliquez ici !</button> <script> var nom, prenom; var bouton = document.querySelector('button'); bouton.addEventListener('click',function() {nom = prompt('tapez votre nom') ;prenom = prompt('tapez votre prénom') }); bouton.addEventListener('click',function() {document.write("bonjour " + nom + " prénomé " + prenom )}); </script> ...

On associe au bouton de commande deux fonctions : une pour la saisie de variables et une autre pour l'affichage des variables.
Ces deux fonctions sont liées au même élément sur le même évènement.

Le rendu de ce code :

Les évènements focus et blur

Ce sont des évènements très utilisés dans les formulaires avec les champs de saisie.

Exemple

...
<body>
<form>
	<label>Note ? </label><input type = 'text'>
	<label>Libellé</label><input type = 'text'>
</form>
<script>
document.querySelector('input').onfocus = 
		function() {this.value ='le séparateur décimal est le point !' ; }
document.querySelector('input').onblur = 
		function() {if(isNaN(this.value)) alert('erreur de saisie') ; 
	else alert('saisie correcte');   }
</script>
...

Grâce à ce script il y a un contrôle de saisie sur le premier input du formulaire.

Nous voyons une bonne illustration de deux évènements liés aux champs de formulaire : focus et blur.
Ici un message ('le séparateur décimal ...) s'affiche dès que le curseur pointe le premier input (onfocus). Dès que cette zone de saisie n'est plus pointée (onblur) un test est effectué pour afficher un second message "erreur de saisie" ou "saisie correcte".
Notez l'emploi du mot this qui est très pratique et qui fait référence à l'objet en cours d'utilisation ; ici le premier input.
Donc le mot this remplace ici : document.querySelector('input').

Le rendu

L'objet "Event"

Un objet "event" peut être passé à la fonction de traitement liée à la détection d'un évènement.

type : click ou mouseover (survol par la souris) ou keydown (appui sur une touche) etc.
keyCode : code ASCII de la touche du clavier enfoncée
target : cible de l'évènement c'est à dire l'objet concerné par l'évènement

Exemple

Le code HTML

...
<h2>L'objet Event et ses propriétés</h2>
<ul>Liste des tâches à effectuer : 
	<li>appuyez sur une touche du clavier (touches de direction)
	<li>cliquez sur le bouton de commande
	<li>survolez l'image 
	<li>cliquez sur l'image
</ul>
<button>Cliquez ici ! </button>
<img src ="../images/toucan.jpg" class ="centre" id ="toucan">

Le code HTML est débarassé des attributs événementiels.

Le code JS

Le code JS est centralisé en un seul script. ... document.onkeydown = function(event) { // si appui sur une touche du clavier console.log("code ASCII de la touche : " + event.keyCode) ; console.log("type évènement : " + event.type) ; console.log("cible évènement : " + event.target) ; } document.querySelector('button').onclick = function(evt) {console.log("type évènement : " + evt.type) ; console.log("cible évènement : "+ evt.target); } document.querySelector('img').onmouseover = function(e) {console.log("type évènement : " + e.type) ; console.log("cible évènement : " + e.target); console.log("ID : " + e.target.id); } document.querySelector('img').onclick = function(evenement) { evenement.target.style.border ="5px solid gold"; evenement.target.style.boxShadow ="10px 10px 5px gray"; } ...

Dans la première fonction j'ai nommé l' objet event "event", "e" dans la deuxième fonction, "evt" dans la troisième fonction et "evenement" dans la quatrième.
La quatrième fonction permet de modifier l'aspect de l'image.

Le rendu

Le rendu dans un nouvel onglet

Si je clique sur l'image, je modifie son aspect : bordure et ombrage !
Remarquez que les touches de direction du clavier ont un code ASCII compris entre 37 et 40 inclus.

Programmation du clavier

A l'occasion de l'exemple précédent, vous avez pu noté que le code ASCII des touches directionnelles est compris entre 37 et 40.

Théme : grâce aux touches directionnelles, vous devez déplacer la boule du billard.

Exemple

La feuille de style

#billard {position : relative ; width : 80% ; height :200px ; 
		margin : 10px auto ; background : lime ;  }
#boule {width : 20px ; height : 20px ; border-radius : 10px ; 
		box-shadow : 5px 5px 5px gray ; 
		position : absolute ; top : 90px ; left : 50% ; background : red ; }

Le code HTML

Il est d'une simplificité déroutante ... <div id = "billard"> <div id ="boule"></div> </div>

Une boîte identifiée billard contient une boule. C'est cet élément qu'il faut déplacer avec le clavier.

Pour dessiner un rond il faut appliquer la propriété de style border-radius à une boîte carrée !

Le script (extraits)

Deux fonctions affichées sur quatre. var billard = document.querySelector('#billard'); // variables objet var boule = document.querySelector('#boule'); var x; var y ; // programmation des touches de direction document.onkeydown = function(event) { if (event.keyCode == 37) gauche(); if (event.keyCode == 39) droite() ; if (event.keyCode == 38) haut(); if (event.keyCode == 40) bas() ; } // fin fonction // quatre fonctions de déplacement function gauche() { x = getComputedStyle(boule).left; x = parseInt(x); x= x-20; x = x + "px"; boule.style.left = x ; } ... function haut() {y = getComputedStyle(boule).top; y = parseInt(y); y= y-20; y = y+"px"; boule.style.top = y ; } ...

Les quatre touches du pavé directionnel sont programmées. Si appui sur l'une de ces touches appel d'un des quatre fonctions.
Deux fonctions pour changer la valeur de la propriété left de l'objet boule et deux fonctions pour augmenter ou diminuer la valeur de la propriété top.
La méthode getComputedStyle avec la propriété top/left retourne une chaîne telle "90px". Il faut donc convertir en entier puis incrémenter (ou décrémenter) puis rajouter "px". Bref c'est un peu lourd.

Le rendu

Le rendu dans un nouvel onglet

La boule peut sortir du billard. Mais ça ne serait pas très compliqué d'éviter cela. Il suffirait d'un test.

Traduction

Tutoriel JavaScript & jQuery - sommaire

JavaScript natif

JavaScript-jQuery

Tutoriel JavaScript & jQuery - recherche

L'auteur : Patrick Darcheville

JavaScript : les évènements

Notion de programmation événementielle

Détection des évènements par le HTML

Première solution

Deuxième solution

Détection des évènements par JS

Solution "onevent"

Deuxième solution : méthode addEventListener()

Méthode addEventListener - autre exemple

Les évènements focus et blur

Exemple

Le rendu

L'objet "Event"

Exemple

Le code HTML

Le code JS

Le rendu

Programmation du clavier

Exemple

La feuille de style

Le code HTML

Le script (extraits)

Le rendu