jQuery ajax()Méthode

jQuery AJAX 方法Méthodes AJAX jQuery

Exemples

Utilisez une requête AJAX pour modifier le texte d'un élément <div> :

$("button").click(function(){ $.ajax({url:"demo_test.txt",success:function(result){ $("#div1").html(result); }}); });

Essayez-le vous-même »

Définition et utilisation

La méthode ajax() est utilisée pour effectuer une requête AJAX (HTTP asynchrone).

Toutes les méthodes AJAX de jQuery utilisent la méthode ajax(). Cette méthode est généralement utilisée pour les requêtes que les autres méthodes ne peuvent pas effectuer.


Syntaxe

$.ajax({name:value, name:value, ... })

Ce paramètre spécifie une ou plusieurs paires nom/valeur pour la requête AJAX.

Le tableau suivant répertorie les paires nom/valeur possibles :

Name Valeur/Description
async Une valeur booléenne indiquant si la requête est traitée de manière asynchrone. La valeur par défaut est true.
beforeSend(xhr) Une fonction à exécuter avant l'envoi de la requête.
cache Une valeur booléenne indiquant si le navigateur met en cache la page demandée. La valeur par défaut est true.
complete(xhr,status) Une fonction à exécuter lorsque la requête se termine (appelée après les fonctions success et error, c'est-à-dire après les fonctions success et error).
contentType Le type de contenu utilisé lors de l'envoi de données au serveur. Par défaut : "application/x-www-form-urlencoded".
context Spécifie la valeur de "this" pour toutes les fonctions de rappel liées à AJAX.
data Spécifie les données à envoyer au serveur.
dataFilter(data,type) Une fonction pour traiter les données de réponse brutes de XMLHttpRequest.
dataType Le type de données attendu de la réponse du serveur.
error(xhr,status,error) Une fonction à exécuter si la requête échoue.
global Une valeur booléenne indiquant s'il faut déclencher les gestionnaires d'événements AJAX globaux pour la requête. La valeur par défaut est true.
ifModified Une valeur booléenne indiquant si la requête n'est réussie que si la réponse a changé depuis la dernière requête. La valeur par défaut est false.
jsonp Une chaîne pour remplacer la fonction de rappel dans un jsonp.
jsonpCallback Spécifie le nom de la fonction de rappel dans un jsonp.
mot de passe Spécifie le mot de passe à utiliser dans une requête d'authentification d'accès HTTP.
processData Une valeur booléenne indiquant si les données envoyées via la requête sont converties en chaîne de requête. La valeur par défaut est true.
scriptCharset Spécifie le jeu de caractères pour la requête.
success(result,status,xhr) Une fonction à exécuter lorsque la requête réussit.
timeout Définit le délai d'attente local de la requête (en millisecondes).
traditionnel Une valeur booléenne spécifiant s'il faut utiliser le style traditionnel de sérialisation des paramètres.
type Spécifie le type de requête (GET ou POST).
url Spécifie l'URL à laquelle envoyer la requête. La valeur par défaut est la page actuelle.
username Spécifie le nom d'utilisateur à utiliser dans une requête d'authentification d'accès HTTP.
xhr Une fonction pour créer l'objet XMLHttpRequest.


实例

Plus d’exemples

Créer une requête AJAX asynchrone
Comment utiliser le paramètre async pour spécifier une requête asynchrone.

Créer une requête AJAX avec un type de données spécifié
Comment utiliser le paramètre dataType pour spécifier le type de données de la requête.

Créer une requête AJAX avec des erreurs
Comment utiliser le paramètre error pour gérer les erreurs dans les requêtes AJAX.


jQuery AJAX 方法Méthodes AJAX jQuery

Autres extensions