5.7.1 Fonctionnement des événements

Les écouteurs sont appliqués sur une instance du widget document. Ils restent donc valables durant toute la vie de cette instance de widget et sont déclenchés quel que soit le document représenté par cette instance.

Les écouteurs enregistrés possèdent tous un nom logique qui permet de les identifier.

Ce nom logique est unique. Si deux écouteurs sont enregistrés avec le même nom, le plus récent écrase le plus ancien.

Ce nom logique peut être composé avec un namespace. Celui-ci est séparé du nom logique par un .. Tous les écouteurs ayant le même namespace peuvent être désinscrits via un appel à la méthode de désinscription avec ce namespace. Soit par exemple, validate.animal, change.animal peuvent être supprimés en appelant removeEvent avec .animal.

5.7.1.1 Cycle de vie des événements

Une écouteur possède une pré-condition :

documentCheck

cette pré-condition est exécutée à chaque rechargement du document. Si elle retourne true, l'écouteur est exécuté par le document en cours, sinon il est mis en attente.

Les pré-conditions permettent de n'appliquer les écouteurs que dans leur cas d'utilisation et de réduire la charge d'exécution sur le client.