JQuery

Charge une page externe en utilisant une requete HTTP. Cette méthode fait partie de l'implémentation de bas niveau de jQuery. Pour une niveau d'abstraction plus grand et plus facile a comprendre et à utiliser, consultez les fonctions $.get ou $.post etc... A noter cependant que ces dernières fonction ne proposent pas autant de fonctionnalité que c$.ajax() (comme les retours d'erreurs).

$.ajax() retourne l'objet XMLHttpRequest qu'il crée. Dnas la plupart des cas, vous n'aurez pas besoin de manipuler cet objet directement, mais vous pouvez l'utilisez si vous souhaitez annuler une requête manuellement;

Note: Si vous spécifiiez l'option dataType décrite plus bas, soyez sûrs que le serveur envoie le type MIME correct pour la réponse (exemple: wml as "text/xml"). Envoyer le mauvais type MIME peut causer des problèmes inattendus dans votre script (voir l'option dataType pour le listing des types de données disponibles). .

Options

async (booléen): par défault, toutes les requêtes sont asynchrones (ce paramètres vaut true par défaut). Si vous avez besoin de requêtes synchrones, passez cette fonction à false. A nter que les requêtes synchrones bloque temporairement le naviguateur de l'utilisateur tant que la requête n'est pas terminée.
beforeSend (fonction): un pre-callback permettant de modifier l'objet XMLHttpRequest avant qu'il soit envoyé. A utiliser pour envoyer des entêtes personnalisés par exemple etc. Seul l'objet XMLHttpRequest est passé en argument de cette fonction.
complete (fonction): fonction à appeler lorsque la requête se termine (après que les callbakcs de succès et d'erreurs soient éxécutés). La fonction dispose de deux arguments: l'objet XMLHttpRequest et une chaine de caractère décrivant le type de succès de la requête.
contentType (String): Quand vous envoyez des données au serveur, utilisez ce paramètre. Par défaut, il vaut "application/x-www-form-urlencoded", ce qui correspond dans la plupart des cas.
data (objet|string): Donnée à envoyer au serveur. Elle est converti en String, si elle ne l'est pas déja. Consultez l'option processData pour empêcher teh processus automatique. L'objet doit être formée de paires de la forme clé/valeur. Si la valeur est un tableau, jQuery serialise les dofférentes données du tableau avec la même clé. Par exemple: {foo:["bar1", "bar2"]} devient '&foo=bar1&foo=bar2'. Ce paramètre n'est pas nécéssaire pour les requêtes utilisant le paramètre GET.
dataType (string): format des données qui seront renvoyées du serveur. Si aucune type n'est spécifié, jQuery utilisera le type MIME pour déterminer le format adéquat: responseXMl ou ResponseText. Voici la liste des types disponibles:
"xml": retourne un document XML qui pourra être traité par jQuery.
"html": retourne du code HTML au format texte, inclus l'évaluation des script tags.
"script": évalue la réponse en Javascript et retourne cette dernière au format texte.
"json": évalue la réponse en JSON et retourne un objet Javascript.
error (fonction): Fonction à appeler si la requête échoue. La fonction dispose de trois arguments: l'objet XMLHttpRequest, une chaine de caractère décrivant le type d'erreur rencontré, et un objet d'exception, dans la cas ou ce dernier a été généré.
global (booléen): permet le déclenchement du gestionnaire d'évènement global de AJAX. Par défaut, il vaut true. Passez false à cette option si vous voulez empêcher les déclenchementd d'évènements de type ajaxStart ou ajaxStop.
ifModified (booléen): la requête se termine avec succès seulement si les données retournées sont différentes de la dernière requête. Les entêtes sont utilisés pour cette opération. Par défaut, cette option vaut "false".
processData (booléen): permet de ne pas passer en chaine de caractère les données passée à l'option "data". Si vous souhaitez envoyer des documents DOM, ou d'autres données non traitables, passez cette option à false.
success (fonction): Fonction à appeler si la requête s'éxécute avec succès. Un seul argument est passé en paramètre: les données retournées par le serveur, format suivant le format défini par l'option "dataType".
timeout (entier): spécifie un timeout local en millisecondes pour la requête. Ce timeout prendra le pas sur le timeout global (défini par la fonction $.ajaxTimeout()) pour la requête.
type (string): type de la requête (GET ou POST), par défaut, vaut GET. D'autres méthodes d'envoi HTTP peuvent être utilisées, comme PUT ou DELETE, mais celles-ci ne sont pas supportées par tous les naviguateurs.

Envoie les paramètres globaux pour les requêtes AJAX. Consultez la fonction $.ajax pour avoir une description complète de toutes les options disponibles.

Spécifié un timeout pour toutes les requêtes AJAX qui suivront cette spécification.
Envoyez null ou 0 pour annuler l'effet des timeout (valeur par defaut).
Vous pouvez également annuler manuellement les requêtes avec la méthode abort() de l'objet XMLHttpRequest (retourné par toutes les fonctions Ajax).

La page sera chargée en utilisant la méthode GET, sans avoir besoin d'utilier la fonction plus complexe $.ajax. Cette fonction permet de d'associer une méthode qui sera éxécutée lorsque la requête sera effectuée. SI vous avez besoin de définir des callback d'érreurs et de succès, utilisez la fonction $.ajax.

Charge une page en utilisant la méthode GET, seulement si le résultat de la requête n'a pas été modifié depuis son dernier appel.

Charge données JSON à partir d'une page appelée avec la méthode GET.

Charge et éxécute un fichier Javascript utilisant la méthode GET.

Appelle la page à charger en utilisant la mtéhode POST.

Permet d'associer une fonction qui sera éxécutée dès que la requête AJAX sera terminée.

Associe une fonction qui sera éxécutée si la requête AJAX échoue.

Assigne une fonction qui sera éxécutée avant l'envoi de la requête AJAX.

Assigne une fonction à éxécuter lorsque la requête AJAX commencera, et si aucune n'est déja active.

Assigne une fonction qui sera éxécutée à chaque fois qu'une requête se terminera.

Assign une fonction qu isera éxécutée à chaque fois qu'une requête AJAX se sera terminée avec succès.

Charge le code HTML à partir d'un fichier appelé et l'injecte dans la DOM.

Charge du code HTML à partir d'un fichier appelé et l'injecte dans la DOM, mais seulement s'il a été modifié par le serveur.

Sérialise un conteneur d'élements de type input en une chaine de caractères. Cette fonction sérialisera tous les élements qui lui seront présentés.