============================
PimenTech-scripts : Ajax2.js
============================
:Author: Guillaume Savary
:Contact: guillaume@_nospam_pimentech.net
:Revision: $Revision: 1.19 $
:Date: $Date: 2007/04/26 10:58:46 $
:Copyright: 2006 PimenTech SARL
:Tags: ajax javascript api pimentech
Cette bibliothèque fournit notamment l'objet loadHTML, basé sur la libYahoo Ajax.
Téléchargement : http://ftp.pimentech.net/src/pimentech-scripts/
--------
loadHTML
--------
loadHTML est un objet qui lie un conteneur du DOM à une URL. Il peut charger l'URL en GET ou en POST avec les données d'un formulaire et l'upload d'images.
Initialisation
==============
Il faut d'abord charger les fichiers javascritps suivant :
- yahoo/js/yahoo-min.js
- yahoo/js/connection-min.js
- yahoo/js/event-min.js
- pimentech/js/PIMENTECH.js
- pimentech/js/ajax2.js
Une fois la page HTML chargée, vous pouvez créer les objets qui chargeront vos blocs ajax. Le meilleur moyen est de les initialiser dans une fonction onload de .
::
...
function onLoadFunction () {
my_object = new PIMENTECH.util.LoadHTML('my_object', 'container', 'myurl');
}
- 'my_object' : reprend le nom de mon objet pour la mécanique interne.
- 'container' : id d'un conteneur dans le DOM, celui-ci contiendra les données XHTML de la réponse
- 'myurl' : url appelée par défaut, absolue ou relative, elle peut être vide ou contenir des variables get : 'http://myurl.com?var=hello&var2=world'. Cette url doit renvoyer XHTML STRICT !
Appel GET
=========
Nous voulons qu'un lien ou un bouton charge un bloc HTML dans un Id du Dom :
::
lien
Ceci va appeller la méthode load() de notre objet 'my_object' qui se contente de charger le résultat de notre url par défaut dans notre conteneur. On peut aussi charger une autre url :
::
lien
Appel POST
==========
Si vous voulez poster un formulaire en ajax, il faut utiliser la méthode post() de notre objet. De la même façon, le conteneur affichera la réponse de l'url appelée pour le post.
::