Voir la source de Référence:JavaScript

Cette page vous explique comment vous pouvez interagir avec l'appliquette GeoGebra en utilisant JavaScript. 

L'appliquette GeoGebra est considérée comme un objet JavaScript, dans cette page, nous supposons que l'objet est enregistré dans la variable nommée ''ggbApplet''.

Ce qui est le cas si vous utilisez JavaScript depuis GeoGebra ou dans une page web  contenant une seule appliquette GeoGebra  exportée
* soit directement depuis GeoGebra  ({{KeyCode|Ctrl + Maj+M}})
* soit en utilisant le lien dans le dossier complet (hors ligne) fourni  par GeoGebra.

Les scripts '''ne sont pas'''  activables pour les appliquettes exportées depuis GeoGebra via la fonctionnalité ''Insérer''.

Dans le cas où sont intégrées plusieurs appliquettes, consultez la section [[#Obtenir_Objet_Appliquette|Obtenir Objet Appliquette]] .


= Exemples =

{{Exemple| 1 =  le fragment de code HTML suivant ajoute un bouton "Réinitialiser" dans une page HTML, ce qui permet à l’utilisateur de ramener la  construction affichée par GeoGebra dans son état initial :<br/>

<code> <form><br/><input type="button" value="Réinitialiser" onclick="ggbApplet.reset();"><br/></form></code>}}

{{Exemple| 1 = celui-ci ajoute deux boutons "Cacher A" et " Afficher A" pour changer l’état d’affichage de l’objet nommé “A" dans la construction<br/>
<code> <form><br/><input type="button" value="Cacher A" onclick="ggbApplet.setVisible('A', false);"><br/><input type="button" value="Afficher A" onclick="ggbApplet.setVisible('A', true);"><br/></form></code>}}

{{Exemple| 1 =Une fonction JavaScript "maConstruction()" est utilisée pour appeler plusieurs méthodes de l’appliquette GeoGebra.
{{ Note| La langue est fixée à Français ("fr") avec le paramètre "language" dans la balise de l’appliquette afin de faire en sorte que la commande française "Droite" fonctionne.}}
<code><nowiki> <script type="text/javascript" language="javascript" src="http://www.geogebra.org/web/4.4/web/web.nocache.js"></script><article class="geogebraweb" data-param-width="500" data-param-height="500" data-param-ggbbase64="UEsDBBQACAgIAM1CWUMAAAAAAAAAAAAAAAAWAAAAZ2VvZ2VicmFfamF2YXNjcmlwdC5qc0srzUsuyczPU0hPT/LP88zLLNHQVKiuBQBQSwcI1je9uRkAAAAXAAAAUEsDBBQACAgIAM1CWUMAAAAAAAAAAAAAAAAMAAAAZ2VvZ2VicmEueG1svVZtb9s2EP6c/oqDPicxSVGyHMgp1gIFCmTdgHTDsG+URMtcZFEQKb8M/fE7kpIjpy/o0GFB7CN5D++5O96Rzl8fdw3sZW+UbtcRvSURyLbUlWrrdTTYzU0Wvb5/lddS17LoBWx0vxN2HXGHVNU62iSblBPGbgou0hu+yuKbjONXucrKpCJVma14BHA06q7VH8ROmk6U8rHcyp140KWwnnhrbXe3WBwOh9uJ6lb39aKui9ujqSJAN1uzjsbBHZq72HSIPZwRQhd//PwQzN+o1ljRljICF8Kg7l9d5QfVVvoAB1XZ7TrKCIaxlareYkypmywcqMOEdLK0ai8Nbp1Nfcx210UeJlqnvwojaM7hRFCpvapkv47ILUsi0L2SrR21dGRZTPvzvZKHYMiNPAcmzWrdFMLZgE+fgBFG4NoJGgRDkaZBRcIaiYNgQfAgkoDhYTsPUB4wPGB4HMFeGVU0Eo9UNAZzptpNj+d1nht7aqT3Z1x4jpdeY0xG/Y3g2CUxJBnXCbl2H8zsNZ+yOwuSzlhtP/xL0olymbHvp2Q/FGg8cbIvhcmSr4SZfoM0xP09cdJkxolU/t9/PmOMvxXmS8Yw/zHClP8vIeaLqVXysTvAbB12rB4rd8b1S7yCZOXKnkKCvZEuscoToCsUSwbYDUAT4AlOaQapk0uIl6jgEEMGDkdj8M2RZPjFl95YCgkac6tL7EmgSMQhiYH6nuKAnQS+L7FHWYyIJIEENzl6ypyJOAWe4izOgKOPriWXFIExbsQ50jOIKcRuM10CSyF19ih3rZ5mznU0ySAlkFJnELsaOzp0M+IziF006Zgu1XaDvUhRuaumodXd+SwQjffR8z0X7qeLa/Aqb0QhG3wZHt1JAuxF4zrCE210a2E6RBbW6l50W1WaR2kt7jLwl9iLB2Hl8R2izcTtsaVuza+9tm91M+xaA1Dqhpx91g2djdnZa5zEMwWfK5KZIp2Nl1/k1aiBwUjk172Z4KKq3jvE89WAmfylbU5veimeOq0uw8gX/pHJ5VA2qlKi/R2L1bG4vMD05vjranpzOKOTI7qvHk8GKxiOf8pe4x1Dk1sy/8Pb5xRU8UsVHrgphWu+hFxqsLdOX1PxwC335yMSR3mOvu5VNR+/N290U51z4cN/Kzo79P7XAnrXu6B+autG+hLxjY1PcflU6ONjqI042Pp46nBGAn9R+7QDXg0swdeyHmURpMc4x84o4jHEI8hUbKo66+mKeYSXRZAehdUbXBsDpVOUlEw0yvgLjUQXbeNL3z3sQ6vswzSxqnx6jtThPwy7Qp4L6NIk/Y9M5osXBZY/yb6VzVjPeJCDHkxoz1mpV7JUO5wGxZgQ4Q7rN3QgrFay7uXkd+N/h4V0eS2Zl+pny97Uu17v3rf7j1gJLxzIF5OXuSl71bl6gwLfgCf5XFOVMgKfkGq+zzUghl66pwLTY11qsDUHu9W9/6mFNwpKxzCH+nYcf0ve/wNQSwcI2ajKq1gEAADoCgAAUEsBAhQAFAAICAgAzUJZQ9Y3vbkZAAAAFwAAABYAAAAAAAAAAAAAAAAAAAAAAGdlb2dlYnJhX2phdmFzY3JpcHQuanNQSwECFAAUAAgICADNQllD2ajKq1gEAADoCgAADAAAAAAAAAAAAAAAAABdAAAAZ2VvZ2VicmEueG1sUEsFBgAAAAACAAIAfgAAAO8EAAAAAA=="></article></nowiki><br/><script type="text/javascript"><br/>function maConstruction()<nowiki>{</nowiki> <br/>var applet = document.ggbApplet;<br/>applet.evalCommand("A = (1,1)");<br/>applet.evalCommand("B = (3,2)");<br/>applet.evalCommand("s = Droite[A, B]");<br/><nowiki>}</nowiki><br/></script><br/><form><br/><input type="button" value="Faire la construction" onclick="maConstruction();"><br/></form></code>}}

{{Exemple| 1 = Explorez le code source de l'exemple suivant qui utilise JavaScript.<br>
 http://www.geogebra.org/source/program/applet/geogebra_applet_javascript_test.htm
}}

{{Exemple | 1 = Ceci est un exemple de fichier qui utilise un  ''add listener'' pour savoir si une construction particulière a été complétée (et alors envoie le message  "Well done").<br>
 http://www.geogebra.org/en/examples/javascriptAutomaticCheckingExercise.html
}}

{{Exemple | 1 = Ceci est un exemple montrant comment coupler JavaScript avec GeoGebraWeb.<br/>
 http://www.geogebra.org/web/milestones/SlopeTestWeb.html
}}

= Méthodes utilisables =

<table style="width: 100%;" class="pretty">
    <tr>
      <th>Méthode</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>evalCommand(commande)</td>
      <td>Évalue la chaîne comme si vous l’aviez entrée dans le champ de saisie  [ex : evalCommand('s = Droite[A, B]')].  <br> Vous pouvez utiliser plusieurs commandes en les séparant par "\n"{{Note | Utilisez le  [[Référence:Paramètres_Appliquette|paramètre “language” ]] pour vous assurer que la commande dans votre langue est reconnue.}}
{{Note | Mais vous devriez utiliser les noms anglais des commandes pour vous assurer que la commande fonctionne dans toutes les versions de GeoGebra.}}
      </td>
    </tr>
    <tr>
      <td>setUndoPoint()</td>
      <td>Définit un point de restauration. Utile si vous désirez que l'utilisateur puisse annuler l'action d'un ''evalCommand'', par exemple si vous avez créé un bouton dans l'HTML pour agir comme un outil personnalisé.<br>
      </td>
    </tr>
</table>

= Définir l’état d’un objet =

==Méthodes générales==
<table style="width: 100%;" class="pretty">
<tr>
      <th>Méthode</th>
      <th>Description</th>
</tr>
    <tr>
      <td> deleteObject(nom)</td>
      <td>Efface l’objet cité.{{Exemple|1= deleteObject('A')}}</td>
    </tr>
    <tr>
      <td>setValue(nom, valeur)</td>
      <td>Affecte la valeur à l’objet cité {{Exemple|1=setValue('n',36)}}
{{Note |Si cet objet n’est pas un nombre, rien ne se passe. <br/>Si l’objet est un booléen, utiliser la valeur 1 pour le mettre à ‘Vrai’, n’importe quelle valeur pour le mettre à ‘Faux’.}}</td>
    </tr>
 <tr> 
     <td>setTextValue(nom, texte)</td>
       <td>Affecte le texte à l'objet texte cité. Rien ne se passe pour tout autre type d'objet.</td>
    </tr>
    <tr> 
     <td>setListValue(nom, position, valeur)</td>
       <td>Affecte la valeur à l'élément à la position donnée dans la liste</td>
    </tr>
    <tr>
      <td>setCoords(nom, x, y)</td>
      <td>Affecte les coordonnées à l’objet{{Exemple|1= setCoords('A',-1,3)}} 
{{Note| Si cet objet n’est ni point ni vecteur, rien ne se passe.}}</td>
    </tr>
    <tr>
      <td>setColor(nom, rouge, vert, bleu)</td>
      <td>Affecte la couleur RVB à l’objet  {{Exemple|1=setColor('A',200,100,100)}}</td>
    </tr>
    <tr>
      <td>setVisible(nom, booléen) </td>
      <td>Affiche (true) ou Cache (false) l’objet cité dans la vue Graphique {{Exemple|1=setVisible('A',true)}}</td>
    </tr>
    <tr>
      <td>setLabelVisible(nom, booléen) </td>
      <td>Affiche (true) ou Cache (false) l’étiquette de l’objet cité dans la vue Graphique {{Exemple|1=setLabelVisible('A',false)}}</td>
    </tr>
    <tr>
      <td>setLabelStyle(nom, entier)</td>
      <td>Définit le style de l’étiquette de l’objet cité dans  Graphique. Nom = 0, Nom & Valeur = 1, Valeur = 2 et  Légende=3. {{Exemple|1=setLabelStyle('A',1)}} 
</td>
    </tr>
    <tr>
      <td>setFixed(nom, booléen)</td>
      <td>Définit la liberté de l’objet cité {{Exemple|1=setFixed('A',true)}}
{{Note | Les objets fixes ne peuvent être modifiés.}}
</td>
    </tr>
    <tr>
      <td>setTrace(nom, booléen)</td>
      <td>Active ou non la trace de l’objet cité {{Exemple|1=setTrace('A',false)}}</td>
    </tr>
    <tr>
      <td>renameObject(ancien nom, nouveau nom)</td>
      <td>Renomme l’objet ancien nom en l’objet nouveau nom</td>
    </tr>
    <tr>
      <td>setLayer(nom,entier)</td>
      <td>Définit le calque de l’objet cité.</td>
    </tr>
    <tr>
      <td>setLayerVisible(n°, booléen)</td>
      <td>Affiche ou cache tous les objets du calque n°</td>
    </tr>
    <tr>
      <td>setLineStyle(nom,entier)</td>
      <td>Définit le style du trait (de 0 à 4)</td>
    </tr>
    <tr>
      <td>setLineThickness(nom,entier)</td>
      <td>Définit l’épaisseur de l’objet (de 1 à 13) (1 par défaut)</td>
    </tr>
    <tr>
      <td>setPointStyle(nom,entier)</td>
      <td>Définit le style du point (-1 par défaut, 0 disque, 1 cercle, 2 croix,3 plus, 4 diamant plein, 5 diamant vide, 6 triangle (nord), 7 triangle (sud), 8 triangle (est), 9 triangle (ouest))<br/> Voir [[Commande_SoitStylePoint]]</td>
    </tr>
    <tr>
      <td>setPointSize(nom,entier)</td>
      <td>Définit la taille du point (de 1 à 9)</td>
    </tr>
    <tr>
      <td>setFilling(nom,nombre)</td>
      <td>Définit le remplissage de l’objet (de 0 à 1)</td>
    </tr>
     <tr>
      <td>getPNGBase64(échelle, booléen transparent,  DPI)</td>
      <td>Retourne Graphique1 sous forme d'une chaîne encodée en base64.{{Exemple|1= var str = ggbApplet.getPNGBase64(1, true, 72);}}      </td>
    </tr>
    <tr>
      <td>writePNGtoFile(Nomfichier, échelle, booléen transparent, DPI)
</td>
      <td>Exporte Graphique1 dans un fichier PNG. '''(ne fonctionne que pour les appliquettes signées)''' <br>
{{Exemple|1= var success = ggbApplet.writePNGtoFile("c:\\test.png", 1, false, 300);  }}    </td>
    </tr>
    <tr>
      <td>isIndependent(nom)
</td>
      <td> teste si ''nom'' est indépendant      </td>
    </tr>
  <tr>
      <td>isMoveable(nom)
</td>
      <td> teste si ''nom'' est déplaçable</td>
    </tr>
  <tr>
      <td>getBase64()
</td>
      <td> Enregistre la construction courante dans un fichier .ggb encodé en  base64</td>
    </tr>
   <tr>
      <td>String getBase64(callback function)</br>4.4(HTML5 only)
</td>
      <td> Gets the current construction as a base64-encoded .ggb file asynchronously, passes as parameter to the callback function when ready. The callback function should take one parameter (the base64 string).</td>
    </tr>
  <tr>
      <td>setBase64(chaîne)
</td>
      <td> Définit la construction courante à partir d'un fichier .ggb encodé en  base64</td>
     </tr>
</table>

==Animation automatique==
<table style="width: 100%;" class="pretty">
    <tr>
      <th>Méthode </th>
      <th>Description</th>
    </tr>
    <tr>
      <td>setAnimating(nom, booléen)</td>
      <td>Définit si l’objet cité peut être animé. Cela ne lance pas l'animation, utilisez startAnimation() pour le faire.</td>
    </tr>
       <tr>
      <td>setAnimationSpeed(nom, nombre)</td>
      <td>Définit la vitesse d’animation de l’objet cité.</td>
    </tr>
  <tr>
      <td>startAnimation()</td>
      <td>Lance l’animation pour les objets pouvant être animés.</td>
    </tr>
    <tr>
      <td>stopAnimation()</td>
      <td>Arrête l’animation en cours.</td>
    </tr>	
   <tr>
      <td>isAnimationRunning()</td>
      <td>Retourne un booléen précisant si une animation est en cours ou non.</td>
    </tr>	
</table>

= Connaître l’état d’un objet =

<table style="width: 100%;" class="pretty">
    <tr>
      <th>Méthode</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>getXcoord(nom)</td>
      <td>Retourne l’abscisse de l’objet cité.{{Exemple|1= getXcoord('A')}}
 {{Note | Retourne 0 si l’objet n’est ni un point ni un vecteur.}}</td>
    </tr>
    <tr>
      <td>getYcoord(nom)</td>
      <td>Retourne l’ordonnée de l’objet cité. {{Exemple|1= getYcoord('u')]}}
{{Note | Retourne 0 si l’objet n’est ni un point ni un vecteur.}}</td>
    </tr>
    <tr>
      <td>getValue(nom)</td>
      <td>Retourne la valeur de l’objet cité ( longueur pour un segment, aire pour un polygone, etc.). {{Exemple|1=  getValue('poly1')]}} 
{{Note |Retourne 0 s’il l’objet n’a pas de valeur associée.<br/> Si l’objet est un booléen, retourne 1 pour ‘Vrai’, 0 pour ‘Faux’. }}     </td>
    </tr>
<tr>
      <td>getListValue(nom, indice)</td>
      <td>Retourne la valeur de l’objet de la liste dans la position précisée. {{Note | Si l’objet est un booléen, retourne 1 pour ‘Vrai’, 0 pour ‘Faux’. }} </td>
    </tr>
    <tr>
      <td>getColor(nom)</td>
      <td>Retourne la couleur de l’objet cité sous forme d’une chaîne hexadécimale.{{Exemple|1= getColor('A') retourne "#FF0000" si A est rouge.}} {{Note | la chaîne hexadécimale commence toujours par # et ne contient pas de lettres minuscules.}}</td>
    </tr>
    <tr>
      <td>getVisible(nom,1|2)</td>
      <td>Retourne ‘true’ ou ‘false’ suivant que l’objet cité est affiché ou non dans la vue Graphique 1 ou 2. Retourne  ‘false’  si l'objet n'existe pas.</td>
    </tr>
    <tr>
      <td> getValueString(nom)</td>
      <td>Retourne la valeur de l’objet cité sous forme de chaîne.</td>
    </tr>
    <tr>
      <td>getDefinitionString(nom) </td>
      <td>Retourne la définition (l’info bulle) de l’objet cité.</td>
    </tr>
    <tr>
      <td>getCommandString(nom)</td>
      <td>Retourne la commande à saisir pour créer l’objet cité.</td>
    </tr>
    <tr>
      <td>getObjectType(nom)</td>
      <td>Retourne le type de l’objet cité sous forme de chaîne (comme "point", "line", "circle", etc. en Anglais !).</td>
    </tr>
    <tr>
      <td>exists(nom)</td>
      <td>Retourne un booléen attestant l’existence ou non de l’objet cité dans la construction.</td>
    </tr>
    <tr>
      <td>isDefined(nom)</td>
      <td>Retourne un booléen attestant la validité actuelle ou non de l’objet .</td>
    </tr>
    <tr>
      <td>getObjectNumber()</td>
      <td>Retourne le nombre d’objets dans la construction.</td>
    </tr>
<tr>
      <td>getCASObjectNumber()</td>
      <td>Retourne le nombre d’objets (lignes non vides) du CAS.</td>
  <tr>
      <td>getObjectName(n)</td>
      <td>Retourne le nom du n-ème objet de la construction (attention,  le compteur commence à 0).</td>
    </tr>
  <tr>
      <td>getLayer(nom)</td>
      <td>Retourne le numéro du calque de l’objet cité.</td>
    </tr>
    <tr>
      <td>getLineStyle(nom)</td>
      <td>Retourne le style du trait (de 0 à 4)</td>
    </tr>
    <tr>
      <td>getLineThickness(nom)</td>
      <td>Retourne l’épaisseur de l’objet (de 1 à 13) (1 par défaut)</td>
    </tr>
    <tr>
      <td>getPointStyle(nom)</td>
      <td>Retourne le style du point (-1 par défaut, 0 disque, 1 cercle, 2 croix,3 plus, 4 diamant plein, 5 diamant vide, 6 triangle (nord), 7 triangle (sud), 8 triangle (est), 9 triangle (ouest))</td>
    </tr>
    <tr>
      <td>getPointSize(nom)</td>
      <td>Retourne la taille du point (de 1 à 9)</td>
    </tr>
    <tr>
      <td>getFilling(nom)</td>
      <td>Retourne le remplissage de l’objet (de 0 à 1)</td>
    </tr>
</table>

= Construction / Interface Utilisateur  =

<table style="width: 100%;" class="pretty">
   <tr>
      <th>Méthode</th>
      <th style="font-weight: bold;">Description</th>
    </tr>
    <tr>
      <td>setMode(code du mode)</td>
      <td>Définit le mode au code fourni
{{Exemple|1=setMode(0)  pour mode Déplacer.}}

(voir [[Référence:BarreOutils|Codes]] et [[Référence:Paramètres_Appliquette|paramètre “showToolBar”]]  et &nbsp;[[Référence:Paramètres_Appliquette|paramètre "customToolBar"]]  )</td>
    </tr>
    <tr>
      <td>openFile(URL)</td>
      <td>Ouvre le  fichier dont l’URL est donnée sous forme absolue ou relative)[ex : openFile('fichier.ggb')].</td>
    </tr>
    <tr>
      <td>reset()</td>
      <td>Réinitialise la construction.<br>
      </td>
   </tr>
   <tr>
      <td>refreshViews()</td>
      <td>Rafraîchit l’affichage. {{Note| Cela efface toutes les traces dans la vue Graphique.}}</td>
    </tr>
    <tr>
      <td>setOnTheFlyPointCreationActive(booléen)<br>
      </td>
      <td>Autorise (true)  ou non (false) la création de points "à la volée". {{Note | À utiliser si vous ne désirez pas que les outils créent des points.}}</td>
    </tr>
    <tr>
      <td>hideCursorWhenDragging(booléen)<br>
      </td>
      <td>Affiche(true) ou non (false) le curseur de la souris quand on déplace un object. </td>
    </tr>
    <tr>
      <td>setRepaintingActive(booléen)<br>
      </td>
      <td>Active (true) ou non (false) le recalcul de la figure. 
{{Note | Cette méthode est surtout à utiliser quand vous utilisez plusieurs méthodes.}}</td>
    </tr>
    <tr>
      <td>setErrorDialogsActive(boolean flag)</td>
      <td>Bascule pour l’affichage ou non du dialogue d’erreur. {{Note | C'est très utile avec l'utilisation de evalCommand().}}</td>
    </tr>
    <tr>
      <td>setCoordSystem(xmin, xmax,ymin,ymax)</td>

      <td>Définit la fenêtre graphique.
{{Exemple|1=setCoordSystem(-5,10,-1,20)}}
</td>
    </tr>
    <tr>
      <td>setAxesVisible(booléen, booléen)</td>
      <td>Affiche (true) ou Cache (true) indépendamment chacun des axes. {{Exemple|1=setAxesVisible(true, false)}}</td>
    </tr>
    <tr>
      <td>setGridVisible(booléen) </td>

      <td>Affiche (true) ou Cache (true) la grille.</td>
    </tr>
</table>

=Communication de GeoGebraApplet à JavaScript=

Avec ces méthodes vous pouvez implémenter une communication de l’appliquette au JavaScript. Par exemple, ces méthodes peuvent être utilisées pour :

* noter les actions de l'utilisateur (voir l'exemple [http://www.geogebra.org/source/program/applet/geogebra_applet_java2javascript.htm java2javascript])
* communiquer entre deux appliquettes GeoGebra (voir l'exemple [http://www.geogebra.org/source/program/applet/geogebra_applet_java2java.htm java2java])

<table style="width: 100%;" class="pretty">
 <tr>
 <th>Méthode</th>
 <th style="font-weight: bold;">Description</th>
 </tr>
 <tr>
 <td>registerAddListener(String JSFunctionName)</td>
 <td>Déclare une fonction JavaScript en tant que mouchard des <span style="font-weight: bold;"> ajouts </span>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|1= Déclarez d’abord, une fonction JS d’écoute : <br/>
''ggbApplet.registerAddListener''("'''suiviAjout'''");
Dès qu’un objet "A" est créé, l’appliquette GeoGebra appelle la fonction '''suiviAjout'''("A")}}</td>
 </tr>
 <tr>
 <td>unregisterAddListener(nom)</td>
 <td>Retire un mouchard d’ajouts déclaré auparavant, voir <span style="font-style: italic;">registerAddListener()</span></td>
 </tr>
 <tr>
 <td>registerRemoveListener(fonctionJS)</td>
 <td>Déclare une fonction JavaScript en tant que mouchard des <span style="font-weight: bold;">retraits</span> dans l’appliquette de construction.
Dès qu’un objet est supprimé, la fonction  <span style="font-style: italic;">fonctionJS</span> 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|1= Déclarez d’abord, une fonction JS d’écoute :<br/>
''ggbApplet.registerRemoveListener''("'''suiviRetrait'''");
Dès qu’un objet "A" est effacé, l’appliquette GeoGebra appelle la fonction '''suiviRetrait'''("A")}} </td>
 </tr>
 <tr>
 <td>unregisterRemoveListener(nom)</td>
 <td>Retire un mouchard de retraits déclaré auparavant, voir <span style="font-style: italic;">registerRemoveListener()</span></td>
 </tr>
 <tr>
 <td>registerUpdateListener(fonctionJS)</td>
 <td>Déclare une fonction JavaScript en tant que mouchard des <span style="font-weight: bold;">modifications</span> dans l’appliquette de construction. Dès qu’un objet quelconque est modifié, la fonction <span style="font-style: italic;">fonctionJS</span>est appelée avec comme argument le nom de l’objet modifié. 
{{Note | si vous voulez suivre les modifications d’un seul objet utilisez plutôt registerObjectUpdateListener().}}

{{Exemple|1= Déclarez d’abord, une fonction JS d’écoute : <br/>
''ggbApplet.registerUpdateListener''("'''suiviModifs'''");
Dès que l’objet "A" est modifié, l’appliquette GeoGebra appelle la fonction '''suiviModifs'''("A")}}</td>
 </tr>
 <tr>
 <td>unregisterUpdateListener(nom)</td>
 <td>Retire un mouchard de modifications déclaré auparavant, voir <span style="font-style: italic;">registerUpdateListener()</span></td>
 </tr>
 <tr>
 <td>registerObjectUpdateListener(nom, fonctionJS)</td>
 <td>Déclare une fonction JavaScript en tant que mouchard des  <span style="font-weight: bold;">modifications </span> pour un simple objet dans l’appliquette de construction. Dès que l’objet suivi est modifié, la fonction <span style="font-style: italic;">fonctionJS</span> est appelée avec comme argument le nom de l’objet modifié. Si l’objet avait auparavant une valeur par la fonction JS, l’ancienne valeur est actualisée. {{Note| toutes les écoutes de modifications d’objets sont effacées quand l’objet associé est supprimé ou que la construction est remise à zéro, voir registerRemoveListener() et registerClearListener().}}
{{Exemple|1= Déclarez d’abord, une fonction JS d’écoute : <br/>
''ggbApplet.registerObjectUpdateListener''("A", "'''monsuiviA'''");
Dès que A est modifié, l’appliquette  appelle la fonction '''monsuiviA'''("A") }}
{{Note | un mouchard de modifications d’un objet continue à fonctionner après que cet objet ait été renommé.}}
</td>
</tr>
<tr>
 <td>unregisterObjectUpdateListener(nom)</td>
 <td>Retire le mouchard de modifications de l’objet cité, voir <span style="font-style: italic;">registerObjectUpdateListener()</span></td>
 </tr>
 <tr>
 <td>registerRenameListener(fonctionJS)</td>
 <td>Déclare une fonction JavaScript en tant que mouchard des  <span style="font-weight: bold;">changements de nom </span> dans l’appliquette de construction. Dès qu’un objet est renommé, la fonction <span style="font-style: italic;">fonctionJS</span> est appelée avec comme argument l’ancien nom de l’objet et le nouveau.  
{{Exemple|1=Déclarez d’abord, une fonction JS d'écoute :<br/>
''ggbApplet.registerRenameListener''("'''monsuiviRenommer'''");
Dès qu’un objet "A" est renommé en "B", l’appliquette appelle la fonction''' monsuiviRenommer'''("A", "B")}} </td>
 </tr>
 <tr>
 <td>unregisterRenameListener(nom)</td>
 <td>Retire le mouchard de changements de nom déclaré auparavant, voir <span style="font-style: italic;">registerRenameListener()</span></td>
 </tr>
 <tr>
 <td>registerClearListener(fonctionJS)</td>
 <td>Déclare une fonction JavaScript en tant que mouchard des  <span style="font-weight: bold;">remises à zéro </span> dans l’appliquette de construction. Dès que la construction est remise à zéro (i.e. tous les objets sont supprimés), la fonction <span style="font-style: italic;">fonctionJS</span> est appelée sans argument. {{Note| tous les mouchards de modifications ne sont plus déclarés quand une construction est remise à zéro. Voir registerUpdateListener() et registerRemoveListener().}}
{{Exemple|1=Déclarez d’abord, une fonction JS d'écoute :<br/>
''ggbApplet.registerClearListener''("'''suiviRAZ'''");
Quand la construction est remise à zéro , l’appliquette appelle la fonction '''suiviRAZ'''()}}</td>
 </tr>
 <tr>
 <td>unregisterClearListener(fonctionJS)</td>
 <td>Retire le mouchard de remises à zéro déclaré auparavant, voir <span style="font-style: italic;">registerClearListener()</span></td>
 </tr>
</table>

= Format XML de GeoGebra =

Avec ces méthodes vous pouvez définir tout objet dans une construction. (voir [[Référence:XML|Références XML ]] ).
<table style="width: 100%;" class="pretty">
    <tr>
      <th>Méthode</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>evalXML(chaînexml) </td>
      <td>Évalue la chaîne fournie et modifie la construction actuelle. {{Note| la construction n’est pas effacée avant l’évaluation de la chaîne XML.}}
      </td>
    </tr>
    <tr>
      <td>setXML(chaînexml) </td>
      <td>Évalue la chaîne fournie et modifie la construction actuelle. {{Note| la construction est effacée avant l’évaluation de la chaîne XML. Cette méthode peut être utilisée pour charger des constructions.}}
      </td>
    </tr>
    <tr>
      <td>getXML()<br>
      </td>
      <td>Retourne l’actuelle construction sous forme d’une chaîne dans le format XML de GeoGebra. Cette méthode peut être utilisée pour sauvegarder des constructions.

<span style="font-style: italic;">Exemple</span> : 
 <form name="nonof"><input type="button" value="get" 
 onclick="document.nonof.nonot.value=document.ggbApplet.getXML()";">
 <textarea name="nonot" rows=8 cols=60> </textarea>
 </form>
<br>
      </td>
    </tr>
  <tr>
      <td>getXML(nom)<br>
      </td>
      <td>Retourne uniquement la chaîne de construction XML de l’objet cité., i.e. seulement le paragraphe  &lt;element&gt;.
      </td>
    </tr>
<tr>
      <td>getAlgorithmXML(nom)<br>
      </td>
      <td>
Retourne une chaîne vide pour un objet libre.
Retourne la chaîne de construction XML de l’ascendant (et de tous ses descendants) de l’objet cité pour un objet dépendant 

      </td>
    </tr>
</table>

= Divers =

<table style="width: 100%;" class="pretty">
    <tr>
      <th>Méthode</th>
      <th>Description</th>
    </tr>
    
    <tr>
      <td>debug(chaîne) </td>
      <td>Écrit la chaîne dans la  Console Java 
      </td>
    </tr>

</table>

==Évaluation automatique d'exercice ==

<table style="width: 100%;" class="pretty">
    <tr>
      <th>Méthode</th>
      <th>Description</th>
    </tr>
    <tr>
      <td>JSONObject getExerciseResult()</td>
      <td>S'il y a des Macros ou un Exercice présents dans le fichier courant, cette méthode peut être utilisée pour évaluer si des parties de la construction sont équivalentes aux Macros de ce fichier.<br>Si vous ne voulez pas qu'un Exercice Standard (utilisant toutes les Macros dans la Construction et les fractionnant chacune jusqu'à 100) soit créé, tester d'abord si c'est un Exercice avec isExercise() . <br>Aide restera vide, sauf indication contraire dans le constructeur d'exercice.<br>Les fractions seront de 0 or 1 sauf indication contraire dans le constructeur d'exercice.<br>Le résultat sera dans Résultat,i.e:<br>CORRECTE, L'affectation est CORRECTE <br>WRONG, if the assignment is WRONG and we can't tell why <br>NOT_ENOUGH_INPUTS if there are not enough input geos, so we cannot check <br>WRONG_INPUT_TYPES, if there are enough input geos, but one or more are of the wrong type <br>WRONG_OUTPUT_TYPE, if there is no output geo matching our macro <br>WRONG_AFTER_RANDOMIZE, if the assignment was correct in the first place but wrong after randomization <br>UNKNOWN, if the assignment could not be checked
</td>
    </tr>
	<tr>
      <td>getExerciseFraction()</td>
      <td>If there are Macros or an Exercise present in the current file this can be used to check if parts of the construction are equivalent to the Macros in the file. <br>It will return the overall Fraction of the Exercise.<br>This is the sum of all the Fractions in the Assignment or 1 if one of the Assignments has a fraction of 100 and no negative fractions are present. Use getExerciseResult() to get the fractions of each Assignment. If you don't want that a standard exercise (using all the Macros in the Construction and setting each fraction to 100) will be created, check if this is a Exercise with isExercise() first. </td>
    </tr>
       
  <tr>
      <td>isExercise()</td>
      <td>Check whether this applet is an Exercise<br>Returns:true if the Exercise has assignments, this will happen when either getExerciseResult() or getExerciseFraction() are called with user defined Tools present in the applet or if the ExerciseBuilderDialog was used to create the Exercise.</td>
    </tr>
</table>
Un exemple utilisant ces fonctionnalités :    http://archive.geogebra.org/source/program/applet/exerciseExample.html

== Obtenir Objet Appliquette ==
 	
Dans les situations basiques l'appliquette est dans la  variable globale ''ggbApplet'' . Les exceptions sont :
 	
*plusieurs appliquettes dans une page, par défaut, une seule est accessible pour JavaScript. Pour accéder à  plusieurs appliquettes, vous devez définir le paramètre "id" pour chaque appliquette, il deviendra le nom de la variable globale  représentant l'appliquette ;
 
*export depuis GeoGebra 4.0 et antérieurs : l'appliquette est accessible en tant que document.applets[0], les autres appliquettes de la même page le sont  par document.applets[1], ...


__NoTOC__
[[en:Reference:JavaScript]]
[[es:Referencia:JavaScript]]
[[it:Riferimenti:JavaScript]]
[[Catégorie:Référence|JavaScript]]