Script chrono.js

Le script chrono.js permet de simuler un chronomètre et d'afficher le temps écoulé de manière statique ou dynamique.

Le temps écoulé depuis le démarrage du chronomètre est mesuré en faisant la différence entre l'heure courante et l'heure de démarrage du chronomètre. On utilise pour cela des objets Date.

Trois fonctions permettent de démarrer le chronomètre, de l'arrêter et de le remettre à zéro. Deux autres fonctions permettent de savoir si le chronomètre est démarré ou non et d'obtenir le temps mesuré (au format HH:MM:SS:CC).

Enfin, deux fonctions permettent d'activer et de désactiver la mise à jour dynamique du temps mesuré dans le champ d'un formulaire.

Le chronomètre est précis au centième de seconde près.

Depuis :

JsLib 1.0

Voir aussi :

heure.js

actifChrono

booléen actifChrono()

Indique si le chronomètre est démarré ou non..

Retourne :

true si le chronomètre est démarré, false sinon.

arreterChrono

arreterChrono()

Arrête le chronomètre si celui-ci est démarré. Dans le cas où le chronomètre est déjà arrêté, la fonction ne fait rien.

chargerChronoDyna

chargerChronoDyna(objet champ)

Active la mise à jour dynamique du temps mesuré pour le champ spécifié. Une fois la fonction appelée, le champ de formulaire passé en paramètre sera mis à jour tous les centièmes de seconde avec la valeur de retour de la fonction tempsChrono(). Cette fonction est généralement appelée lorsque l'utilisateur charge la page (événement window.onLoad. Elle permet d'insérer un chronomètre dans une page Web.

Paramètres :

champ - une référence sur le champ de formulaire à mettre à jour dynamiquement.

dechargerChronoDyna

dechargerChronoDyna()

Désactive la mise à jour dynamique du temps mesuré précedemment activée. Lorsqu'un champ est mis à jour dynamiquement avec le temps mesuré suite à l'appel de la fonction chargerChronoDyna(chaîne champ), le timer associé au champ est arrêté et le champ n'est plus mis à jour. Cette fonction est généralement appelée lorsque l'utilisateur quitte la page (événement window.onUnload).

demarrerChrono

demarrerChrono()

Démarre le chronomètre si celui-ci est arrêté. Dans le cas où le chronomètre est déjà démarré, la fonction ne fait rien. Si le chronomètre n'a pas été remis à zéro depuis la dernière utilisation, la mesure du temps écoulé vient s'ajouter au temps mesuré lors de la dernière utilisation.

RAZChrono

RAZChrono()

Remet à zéro le chronomètre si celui-ci est arrêté. Dans le cas où le chronomètre est démarré, la fonction ne fait rien. Attention : la remise à zéro du chronomètre entraîne la perte du temps mesuré auparavant.

tempsChrono

chaîne tempsChrono()

Retourne le temps mesuré par le chronomètre au format HH:MM:SS:CC. Exemple : la valeur 01:17:46:08 signifie qu'il s'est écoulé 1 heure, 17 minutes, 46 secondes et 8 centièmes de seconde depuis le démarrage du chronomètre - dans le cas d'une première utilisation.

Retourne :

une chaîne contenant le temps mesuré par le chronomètre.