Instrumenpoche

Outils du site

developpeurs:javascript

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
developpeurs:javascript [20/04/2011 13:33] – lzamodeveloppeurs:javascript [05/05/2011 16:57] (Version actuelle) – lzamo
Ligne 1: Ligne 1:
 ====== Accéder au cœur d'Instrumenpoche par javascript ====== ====== Accéder au cœur d'Instrumenpoche par javascript ======
 +
 +**Avertissement** Ce qui suit sera fonctionnel sur la prochaine version d'instrumenpoche : 2.5
 +
 Lorsqu'Instrumenpoche est inséré dans une page HTML, il est possible d'accéder aux objets qu'il contient par javascript.  Lorsqu'Instrumenpoche est inséré dans une page HTML, il est possible d'accéder aux objets qu'il contient par javascript. 
  
 Trois fonctions permettent d'accéder au contenu d'instrumenpoche : la première permet de lire une propriété d'un objet d'instrumenpoche, la deuxième permet de modifier une propriété et la troisième d'exécuter une fonction contenue dans instrumenpoche. Une quatrième fonction (''iep_loaded()'') est automatiquement appelée au chargement d'instrumenpoche. Trois fonctions permettent d'accéder au contenu d'instrumenpoche : la première permet de lire une propriété d'un objet d'instrumenpoche, la deuxième permet de modifier une propriété et la troisième d'exécuter une fonction contenue dans instrumenpoche. Une quatrième fonction (''iep_loaded()'') est automatiquement appelée au chargement d'instrumenpoche.
 +
 +Pour avoir la liste des classes d'instrumenpoche et les propriétés et méthodes qu'elles contiennent, voir [[start|la page d'accueil pour les développeurs]].
 +
 ===== Accéder à instrumenpoche ===== ===== Accéder à instrumenpoche =====
 Pour utiliser les fonctions de communication avec instrumenpoche, il est nécessaire d'y avoir accès. Pour cela, on peut définir une fonction qui renvoie une animation Flash contenue dans la page, connaissant son nom. Celle-ci peut être : Pour utiliser les fonctions de communication avec instrumenpoche, il est nécessaire d'y avoir accès. Pour cela, on peut définir une fonction qui renvoie une animation Flash contenue dans la page, connaissant son nom. Celle-ci peut être :
Ligne 37: Ligne 43:
  
 ===== Lire une propriété ===== ===== Lire une propriété =====
 +La fonction permettant de lire une propriété est :
 +<code javascript>
 +get_iep(objet,propriété)
 +</code>
 +Où ''objet'' est un texte désignant l'objet contenant le propriété, et le deuxième argument est un texte désignant la propriété voulue.
 +Par exemple, en détectant instrumenpoche comme ci-dessus, on peut afficher l'abscisse du crayon par :
 +<code javascript>
 +alert(thisMovie("iep").get_iep("CrayonIep.crayon","_x"));
 +</code>
 +
 ===== Modifier une propriété ===== ===== Modifier une propriété =====
-===== Exécuter une fonction =====+La fonction permettant de lire une propriété est : 
 +<code javascript> 
 +set_iep(objet,propriété,valeur) 
 +</code> 
 +Où ''objet'' est un texte désignant l'objet contenant le propriété, et le deuxième argument est un texte désignant la propriété voulue et le troisième la valeur qu'on veut donner à la propriété. 
 +Par exemple, en détectant instrumenpoche comme ci-dessus, on peut modifier l'abscisse du crayon par : 
 +<code javascript> 
 +thisMovie("iep").set_iep("CrayonIep.crayon","_x",500); 
 +</code>
  
 +**Attention** le troisième argument de la fonction est la valeur, et non un texte la désignant. Par exemple, dans 
 +<code javascript>
 +thisMovie("iep").set_iep("CrayonIep.crayon","_visible","true");
 +thisMovie("iep").set_iep("CrayonIep.crayon","_visible",true);
 +</code>
 +seule la deuxième ligne est correcte.
  
 +===== Exécuter une fonction =====
 +La fonction javascript permettant d'appeler une fonction d'instrumenpoche est :
 +<code javascript>
 +exec_iep(fonction,paramètres)
 +</code>
 +où ''fonction'' est un texte désignant la fonction et ''paramètres'' un tableau donnant les paramètres à passer à cette fonction. Il faut donner un tableau même si la fonction ne demande qu'un seul paramètre.
  
 +**Exemple**
 +<code javascript>
 +thisMovie("iep").exec_iep("UtilitairesIep.alerte",["ok"])
 +</code>
 +utilise la fonction d'affichage de messages interne à instrumenpoche pour afficher "ok".
 +
 +**Autre exemple**
 +<code javascript>
 +thisMovie("iep").exec_iep("ImagesIep.charger_image",
 +   ["http://upload.wikimedia.org/wikipedia/commons/thumb/8/88/Gaucho_in_action.jpg/800px-Gaucho_in_action.jpg",
 +   1])
 +</code>
 +charge une image dans instrumenpoche sans que cela modifie le script de l'animation.
  
 ===== Instrumenpoche chargé ===== ===== Instrumenpoche chargé =====
developpeurs/javascript.1303299229.txt.gz · Dernière modification : 20/04/2011 13:33 de lzamo