8.2.5.        Communication de GeoGebraApplet à JavaScript

Avec ces méthodes vous pouvez implémenter une communication de l’appliquette au JavaScript. Quand vous utilisez une des méthodes suivantes, vous devez vous assurer que vous avez inséré l’option MAYSCRIPT à la fin de la ligne d’appel de l’appliquette. Par exemple: <applet Nom="ggbApplet" code="geogebra.GeoGebraApplet" codebase="." archive="http://www.geogebra.org/webstart/geogebra.jar" width="500" height="250" MAYSCRIPT>.

Méthode

Description

registerAddListener(fonctionJS)

Déclare une fonction JavaScript en tant que mouchard des ajouts dans l’appliquette de construction.

Dès qu’un nouvel objet est créé, la fonction JS est appelée avec comme argument le nouvel objet. 
Exemple: Déclarez d’abord, une fonction JS d’écoute:

ggbApplet.registerAddListener("suiviAjout");

[ex : function suiviAjout(nom) {    

     alert('Nouvel objet '+nom);}]

Dès qu’un objet "A" est créé, l’appliquette GeoGebra appelle la fonction suiviAjout("A");

unregisterAddListener( nom)

Retire un mouchard d’ajouts déclaré auparavant.

registerRemoveListener(fonctionJS)

Déclare une fonction JavaScript en tant que mouchard des retraits dans l’appliquette de construction.

Dès qu’un objet est supprimé, la fonction JS est appelée avec comme argument le nom de l’objet effacé.

Note: Quand une construction est mise à zéro, le mouchard n’est pas appelé pour chacun des objets élémentaires, voir registerClearListener().
Exemple: Déclarez d’abord, une fonction JS d’écoute :

ggbApplet.registerRemoveListener("suiviRetrait");

Dès qu’un objet "A" est effacé, l’appliquette GeoGebra appelle la fonction suiviRetrait("A");

unregisterRemoveListener(nom)

Retire un mouchard de retraits déclaré auparavant.

registerUpdateListener(fonctionJS)

Déclare une fonction JavaScript en tant que mouchard des modifications dans l’appliquette de construction. Dès qu’un objet quelconque est modifié, la fonction JS est appelée avec comme arg. le nom de l’obj. modifié.

Note: si vous voulez suivre les modifications d’un seul objet utilisez plutôt registerObjectUpdateListener().
Exemple: Déclarez d’abord, une fonction JS d’écoute :

ggbApplet.registerUpdateListener("suiModifs");

Dès que l’objet "A" est modifié, l’appliquette GeoGebra appelle la fonction suiModifs("A");

unregisterUpdateListener(nom)

Retire un mouchard de modifications déclaré auparavant.

registerObjectUpdateListener(nom, fonctionJS)

Déclare une fonction JavaScript en tant que mouchard des modifications pour un simple objet dans l’appliquette de construction. Dès que l’objet suivi est modifié, la fonction JS est appelée avec comme argument le nom de l’objet modifié. Si l’objet avait auparavant une valeur par la fonction JavaScript, l’ancienne valeur est actualisée.

Note: toutes les écoutes de modifications d’objets sont effacées quand l’objet associés sont supprimés ou que la construction est remise à zéro, voir registerRemoveListener() et registerClearListener().
Exemple: Déclarez d’abord, une fonction JS d’écoute :

ggbApplet.registerObjectUpdateListener("A","monsuiviA");

Dès que l’objet A est modifié, l’appliquette GeoGebra appelle la fonction monsuiviA("A");

Note: un mouchard de modifications d’un objet continue à fonctionner après que cet objet ait été renommé.

unregisterObjectUpdateListener(nom)

Retire le mouchard de modifications de l’objet cité, déclaré auparavant.

registerReNameListener(fonctionJS)

Déclare une fonction JavaScript en tant que mouchard des changements de nom dans l’appliquette de construction. Dès qu’un objet quelconque est renommé, la fonction JS est appelée avec comme argument l’ancien nom de l’objet et le nouveau.
Exemple: Déclarez d’abord, une fonction JS d’écoute :

ggbApplet.registerReNameListener("monsuiviRenommer");

Dès qu’un objet "A" est renommé en "B", l’appliquette GeoGebra Applet appelle la fonction

monsuiviRenommer("A", "B");

unregisterReNameListener(nom)

Retire le mouchard de changements de nom.

registerClearListener(fonctionJS)

Déclare une fonction JavaScript en tant que mouchard des remises à zéro dans l’appliquette de construction. Dès que la construction est remise à zéro (i.e. tous les objets sont supprimés), la fonction JS est appelée sans argument.

Note: tous les mouchards de modifications ne sont plus déclarés quand une construction est remise à zéro.
Exemple: Déclarez d’abord, une fonction JS d’écoute :

ggbApplet.registerClearListener("suiRAZ");

Quand la construction est remise à zéro l’appliquette GeoGebra Applet appelle la fonction suiRAZ();

unregisterClearListener(fonctionJS)

Retire le mouchard de remises à zéro.

Articles associés

8.2. Méthodes utilisables


www.geogebra.org