Ajax.PeriodicalUpdater()

La classe Ajax.PeriodicalUpdater() permet de mettre à jour régulièrement (ndr : sur la base d'une fréquence de rafraîssement) un élément DOM dont l'id est précisé dans les arguments d'appel.

Cette classe hérite de la classe Ajax.Base et utilise la classe Ajax.Updater afin de mettre à jour les éléments DOM ou d'exécuter toute autre action.
Le tableau ci après présente les arguments que peut utiliser la classe Ajax.PeriodicalUpdater() :

Propriété	Type	Détails
container	Object	Valeur qui sera passé au constructeur Ajax.Updater . Cette valeur correspond à l'id d'élément à mettre à jour ou à l'objet contenant les ids des deux éléments définis pour les retours (ndr : success pour un retour ok, failure pour un retour en erreur/exception).
url	String	Valeur qui sera passée elle aussi au constructure Ajax.Updater afin de fixer l'url du webservice à contacter afin de recevoir la chaîne de caractères pour la mise à jour de l'élément container.
frequency	Number	Intervalle entre les rafraichissements d'élément défini en secondes. L'intervalle par défaut est de 2 secondes. Cette valeur sera multipliée par la valeur 'decay' au moment de l'invocation du Ajax.Updater.
decay	Number	Permet de retenir le 'decay' lors de la rééxécution de la tâche.

Le tableau présenté ci après présente la définition du constructeur de Ajax.PeriodicalUpdater() ainsi que la méthode permettant de stopper l'éxécution de la boucle de l'éxécuteur périodique (ndr : traduction littérale fr).

Méthode	Type	Arguments	Détails
Ajax.PeriodicalUpdater(container, url, options)	Constructeur	>container : correspond à un id d'élément à mettre à jour, ou a un objet de deux id d'éléments (ndr : un pour le retour ok, un autre pour le retour erreur). url : url du webservice a contacter options : voir la page Ajax.options qui présente la liste des options applicables pour une Ajax.Request (ndr : ici via Ajax.PeriodicalUpdater)	L'utilisation de ce constructeur permet d'exécuter une requête AJAX avec les options spécifiées et les paramètres d'affichage retour définis.

Vous pouvez consulter ci après, un exemple d'utilisation de rechargement périodique via Ajax.PeriodicalUpdater() . Un rechargeur périodique est déjà en cours d'éxécution depuis la fin du chargement de cette page si vôtre navigateur comprend le Javascript.
Vous pouvez désactiver ce rechargeur périodique via le bouton destiné à cet effet ci après.
/* addresse du webservice sur le serveur */ uri = uriBase+'ajax/fr/page35.php'; new Ajax.PeriodicalUpdater({'success' : 'retourCool', failure : 'retourPasCool'},uri,{ parameters : 'mode=0' , evalScripts : true , method : 'post' , frequency : 10 , onComplete : cr } ); function cr (rr) { var ret = rr.responseText; alert(ret); }

zone de retour cool

zone de retour pas cool

Voici le code PHP utilisée pour provoquer les retours succès et erreurs dans le cadre de ce test :
$ret = rand(0,1); if ($ret == 0) { header("http/1.0 404 Not Found"); $strHtml .= "<script type='text/javascript'>alert('retour en erreur via javascript, pas de texte renvoyé');</script>"; } else if ($ret == 1) { $strHtml = "ma chaîne de toto cool"; $strHtml .= "<script type='text/javascript'>alert('toto il est cool aussi en javascript');</script>"; }

: 03/01/2007 17:55:47 | : Ajax, Ajax.PeriodicalUpdater, periodicalupdater, ajax, httprequest, HttpRequest, httpRequest, prototype.js, prototype, javascript, xhtml, xml, webservices,

Aucun commentaire enregistré