Script souris.js
Le script souris.js permet de capturer et de gèrer les événements souris.
Il fournit plusieurs fonctions pour connaître la position du pointeur de souris sur la page Web ou
à l'écran, et pour déterminer quel bouton a été utilisé lors d'un clic.
Le code de capture des événements doit être inséré dans la page par l'utilisateur.
Plusieurs événements souris sont gèrés par les navigateurs Web, en fonction des objets
auxquels ils sont appliqués :
- mousemove - déplacement du pointeur ;
- mouseover - entrée du pointeur dans la zone de l'objet courant ;
- mouseout - sortie du pointeur de la zone de l'objet courant;
- mousedown - bouton de souris enfoncé ;
- mouseup - bouton de souris relaché ;
- click - clic de souris (bouton enfoncé puis relaché) ;
- dblclick - double-clic de souris (bouton enfoncé puis relaché deux fois de suite) ;
- Depuis :
- JsLib 1.0
- Voir aussi :
- clavier.js
Résumé des fonctions |
booléen |
boutonDroit(événement e)
Retourne vrai si le dernier clic de souris concerne le bouton droit. |
booléen |
boutonGauche(événement e)
Retourne vrai si le dernier clic de souris concerne le bouton gauche. |
booléen |
boutonMilieu(événement e)
Retourne vrai si le dernier clic de souris concerne le bouton du milieu. |
entier |
pointeurEcranX(événement e)
Retourne la position horizontale à l'écran du pointeur de la souris. |
entier |
pointeurEcranY(événement e)
Retourne la position verticale à l'écran du pointeur de la souris. |
entier |
pointeurX(événement e)
Retourne la position horizontale sur la page du pointeur de la souris. |
entier |
pointeurY(événement e)
Retourne la position verticale sur la page du pointeur de la souris. |
boutonDroit
booléen boutonDroit(événement e)
-
Retourne vrai si le dernier clic de souris concerne le bouton droit.
Cela permet de détecter un clic du bouton droit et éventuellement d'empêcher l'apparition
du menu contextuel habituellement affiché.
- Retourne :
- true si le dernier événement souris est un clic du bouton droit,
false sinon.
boutonGauche
booléen boutonGauche(événement e)
-
Retourne vrai si le dernier clic de souris concerne le bouton gauche.
- Retourne :
- true si le dernier événement souris est un clic du bouton gauche,
false sinon.
boutonMilieu
booléen boutonMilieu(événement e)
-
Retourne vrai si le dernier clic de souris concerne le bouton du milieu.
Cette fonction est utile pour les systèmes munis d'une souris à trois boutons, ou à deux boutons
et une molette. En effet, la molette est considérée par certains navigateurs comme
le bouton du milieu.
- Retourne :
- true si le dernier événement souris est un clic du bouton du milieu,
false sinon.
pointeurEcranX
entier pointeurEcranX(événement e)
-
Retourne la position horizontale à l'écran du pointeur de la souris. L'entier retourné correspond
à l'abscisse du pointeur de la souris à l'écran (en pixels). L'angle supérieur gauche de l'écran
est pris comme origine.
- Retourne :
- un nombre entier égal à la coordonnée horizontale sur l'écran du pointeur de la souris.
pointeurEcranY
entier pointeurEcranY(événement e)
-
Retourne la position verticale à l'écran du pointeur de la souris. L'entier retourné correspond
à l'ordonnée du pointeur de la souris à l'écran (en pixels). L'angle supérieur gauche de l'écran
est pris comme origine.
- Retourne :
- un nombre entier égal à la coordonnée verticale sur l'écran du pointeur de la souris.
pointeurX
entier pointeurX(événement e)
-
Retourne la position horizontale sur la page du pointeur de la souris. L'entier retourné correspond
à l'abscisse du pointeur de la souris sur la page Web (en pixels). L'angle supérieur gauche de la page
est pris comme origine.
- Retourne :
- un nombre entier égal à la coordonnée horizontale sur la page du pointeur de la souris.
pointeurY
entier pointeurY(événement e)
-
Retourne la position verticale sur la page du pointeur de la souris. L'entier retourné correspond
à l'ordonnée du pointeur de la souris sur la page Web (en pixels). L'angle supérieur gauche de la page
est pris comme origine.
- Retourne :
- un nombre entier égal à la coordonnée verticale sur la page du pointeur de la souris.
Erreurs, critiques, améliorations, questions :
écrivez à l'auteur.
JsLib version 1.4 - bibliothèque JavaScript distribuée sous licence GNU LGPL
Auteur : Etienne CHEVILLARD
Mise à jour : 12/12/2007