Manual:Ajax/fr

Ajax est le terme employé pour JavaScript quand il sert à charger des parties de page à la demande. Pour utiliser Ajax dans MediaWiki, il est préférable que le code JavaScript utilise, ou le module JavaScript mediawiki.api. Vous ferez ainsi une requête à l'API MediaWiki sur AJAX.

Avant MW 1.38, MediaWiki offrait une interface Ajax obsolète à l'usage des extensions. Voir. Néanmoins depuis MediaWiki 1.16 l'utilisation de Sajax n'est pas recommandée; c'est la première version de MédiaWiki contenant.

Détails


Demandes asynchrones
Une requête dite asynchrone envoie ses données vers le serveur, puis continue son exécution. Quelques temps après, le serveur peut renvoyer une réponse (selon le type de la requête qu'il a reçue), auquel cas celle-ci sera transmise à une fonction JavaScript pour être traitée. Une autre fonction peut être fournie pour gérer les cas où la requête échoue pour une raison quelconque. Vous trouverez ci-dessous un exemple d'appel à l'API de connexion avec l'envoi du nom d'utilisateur et du mot de passe.

Alternativement vous pouvez utiliser les fonctions jQuery directement :

La fonction « mw.util.wikiScript » n'est disponible que depuis la version 1.18.



Requêtes synchronisées
L'autre type de requête (les requêtes synchrones) consiste à envoyer des données au serveur et à attendre la réponse. Cela signifie que JavaScript restera bloqué le temps que le serveur renvoie des données, ou que la requête échoue pour quelque raison. L'exemple suivant récupère la liste des modèles de « Pages liées » :

( est une fonction standard JavaScript qui renvoie un objet à partir de sa représentation sous forme de chaîne en format JSON).

Limitations
A cause de la règle sur la même origine, il est difficile pour un script qui se trouve sur un site extérieur, de récupérer les données d'un wiki qui n'est pas hébergé sur le même domaine &mdash; par exemple, on ne peut pas directement récupérer les données de  pour. Les navigateurs les plus récents prennent en charge une instruction explicite pour permettre cet accès via le partage des ressources entre différentes origines mais ceci ne fonctionnera qu'avec des serveurs configurés pour générer les entêtes appropriés, que le navigateur récent de l'utilisateur devra reconnaître. Les développeurs qui ont des problèmes avec les anciens navigateurs ne peuvent pas encore utiliser CORS.

Il est possible de contourner la règle de la même origine en utilisant JSONP au lieu du JSON brut qui fonctionnera sur les navigateurs plus anciens (y compris Internet Explorer 6).



Fonctionnalités associées obsolètes
Sajax est une ancienne bibliothèque Ajax qui (depuis septembre 2012) fait encore partie du code du noyau et qui est utilisée par quelques extensions. Ne l'utilisez pas, remplacez la par. Certaines extensions au lieu d'utiliser Sajax ou pas, font des appels Ajax via le AjaxDispatcher qui est obsolète (voir ) en invoquant. Elles doivent les remplacer par des requêtes à l' MediaWiki pour les modules correspondants de l'API.



Voir aussi

 * - Extensions utilisant l'interface Ajax de MediaWiki.



Liens externes

 * (module JavaScript)
 * jQuery.ajax (méthode jQuery)

Informations générales à propos de XMLHttpRequest :
 * Spécifications de XMLHttpRequest sur W3.org
 * XMLHttpRequest sur Wikipedia
 * XMLHttpRequest sur MDN