Gepi

On se propose d'expliquer les principales fonctions javascript déjà développées dans Gepi.[[BR]]

[[BR]]

----

== Utiliser Prototype ==

[[BR]]

Prototype est une librairie qui simplifie beaucoup le codage javascript. Elle est utilisée, entre autre, pour les requête ajax dans certains cas.[[BR]]

[[BR]]

* '''Ajax.request(url, options)'''[[BR]][[BR]]

Cet objet gère toute la requête Ajax en s'occupant de la compatibilité avec le navigateur de l'utilisateur et de l'envoie de la requête (pas besoin de send() dans le code par exemple).[[BR]] L'objet Ajax.Request a besoin de deux arguments : l'url et un tableau associatif d'options.[[BR]]

Ces options sont multiples et ont un comportement par défaut. La première 'asynchronous' (=true par défaut) est le mode de synchronisation de la requête, donc pas la peine de préciser puisque la plupart des requêtes ajax sont asynchrones. La seconde, 'method' (=post) peut valoir 'get' alors que les troisième et quatrième options sont 'parameters' pour les requêtes en get et 'postbody' pour les requêtes en post.[[BR]]

[[BR]]

* Exemple :[[BR]]

[[BR]]

{{{

        // On précise que les options sont un tableau associatif

    options = new Object();

        // On indique le nom de l'argument à envoyer en post (ici cacher_header)  

        // ainsi que sa valeur (ici mode qui est préciser dans l'appel de la fonction)

    options = {postBody: 'cacher_header='+mode};

        // et on construit l'objet ajax.Request qui s'occupe de tout 

        // (il faudrait préciser l'url pour que cet exemple soit complet)

    var requeteAjax = new Ajax.Request(url,options);

}}}

Cette portion de code suffit à définir une requête de type ajax avec des arguments envoyés en 'post'.[[BR]]

[[BR]]

* '''Ajax.Updater'''[[BR]]

* '''Ajax.PeriodicalUpdater'''[[BR]]

----