English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
$ .ajax() pour exécuter des demandes HTTP (Ajax) asynchrones.
$ .ajax() est la méthode de base pour toutes les demandes Ajax envoyées par jQuery. Il n'est généralement pas nécessaire de appeler cette méthode directement, car il est possible d'utiliser$ .get(),$ .post()etload()et plusieurs méthodes plus avancées, qui sont plus faciles à utiliser. Cependant, si moins d'options courantes sont nécessaires, $ .ajax() peut être utilisé de manière plus flexible.
Syntaxe une:1.5+Version:
$.ajax(url, {name:value, name:value, ...})
Syntaxe deux :1.0+Version :
$.ajax(name:value, name:value, ...)
UtiliserAjouterde la demande AJAXVersionModifier le texte de l'élément DIV:1.5Version:
$.ajax("ajax_intro.txt", {success: function(response){ $("div").html(response); });Vérifiez et voyez‹/›
UtiliserAjouterde la demande AJAXVersionModifier le texte de l'élément DIV:1.0Version :
$.ajax({ url: "ajax_intro.txt", success: function(response){ $("div").html(response); } });Vérifiez et voyez‹/›
Demander la page ajax_get.php et envoyer d'autres données :
$.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"}, success: function(response){ $("div").html(response); } });Vérifiez et voyez‹/›
Demander la page ajax_get.php, envoyer d'autres données et afficher un message d'alerte d'état :
$.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"}, success: function(response, status){ $("div").html(response); alert(status); } });Vérifiez et voyez‹/›
Utiliser la méthode HTTP POST pour demander la page ajax_post.php :
$.ajax({ url: "ajax_post.php", method: "POST", success: function(response){ $("div").html(response); } });Vérifiez et voyez‹/›
Utiliser un réglage asynchrone pour spécifier une demande synchrone :
$.ajax({ url: "ajax_get.php", async: false, data: {fname:"Seagull", lname:"Anna"}, success: function(response){ $("div").html(response); } });Vérifiez et voyez‹/›
Utiliser dataType pour spécifier le type de données de la demande :
$.ajax({ url: ""/javascript/myscript.js", dataType: "script" });Vérifiez et voyez‹/›
Si la demande Ajax rencontre une erreur, afficher une notification :
$.ajax({ url: "wrong_file.html", success: function(response){ $("div").html(response); }, error: function(xhr){ $("div").html("Erreur : " + xhr.status + " " + xhr.statusText); } });Vérifiez et voyez‹/›
Demander un fichier et informer l'utilisateur à la fin de la tâche. Si la demande échoue, afficher un message de notification :
let request = $.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"} }); request.done(function(msg){ $("div").html(msg); }); request.fail(function(xhr, textStatus){ $("div").html("Request failed: ") + textStatus); });Vérifiez et voyez‹/›
Définissez un ou plusieurs paires name:value pour la requête AJAX.
Noms possibles : les valeurs du tableau suivant :
Nom | Type de valeur | Description |
---|---|---|
async | Boolean | Une valeur booléenne indiquant si la requête doit être traitée de manière asynchrone. La valeur par défaut est true |
beforeSend(xhr) | Fonction | La fonction à exécuter avant l'envoi de la requête |
cache | Boolean | Une valeur booléenne indiquant si le navigateur doit ou non mettre en cache la page de la requête. La valeur par défaut est true |
complete(xhr,status) | Fonction | La fonction à exécuter après la fin de la requête (après les fonctions de succès et d'erreur) |
contentType | Booléen ou chaîne | Le type de contenu utilisé pour envoyer les données au serveur. La valeur par défaut est : application / x-www-form-urlencoded |
context | Objet commun | Spécifiez la valeur de 'this' pour toutes les fonctions de rappel AJAX liées |
data | PlainObject ou String ou Array | Spécifiez les données à envoyer au serveur |
dataFilter(data,type) | Fonction | La fonction à utiliser pour traiter les données originales de la réponse XMLHttpRequest |
dataType | Chaîne | Le type de données attendu dans la réponse du serveur |
error(xhr,status,error) | Fonction | La fonction à exécuter lorsque la requête échoue |
global | Boolean | Une valeur booléenne indiquant si le gestionnaire d'événements AJAX global doit être déclenché. La valeur par défaut est true |
ifModified | Boolean | Une valeur booléenne indiquant si la requête est réussie uniquement si la réponse depuis la dernière requête a changé. La valeur par défaut est : false. |
jsonp | Chaîne ou booléen | Remplacez la fonction de rappel jsonp dans la requête |
jsonpCallback | Fonction | Spécifiez le nom de la fonction de rappel pour la requête jsonp |
method | Chaîne | Spécifiez la méthode HTTP à utiliser pour la requête (obtenir ou publier). La valeur par défaut est GET |
password | Chaîne | Spécifiez le mot de passe utilisé pour l'authentification HTTP de la requête |
processData | Boolean | Une valeur booléenne indiquant si les données associées à la requête doivent être converties en chaîne de recherche. La valeur par défaut est true |
scriptCharset | Chaîne | Spécifiez le jeu de caractères pour la requête |
statusCode | Objet commun | Objet appelé lorsque la réponse a un code HTTP correspondant au nombre et à la fonction$.ajax({ statusCode:{ 404:function() alert('Page introuvable'); } } ) |
success(response,status,xhr) | Fonction | Fonction à exécuter lors d'une réponse réussie |
timeout | Numérique | Délai d'attente local de la requête (en millisecondes) |
traditional | Boolean | Un booléen spécifiant si l'encodage des paramètres traditionnel doit être utilisé |
type | Chaîne | methodAlias.1.9Pour les versions de jQuery avant .0, utilisez type |
url | Chaîne | Spécifiez l'URL vers laquelle la requête doit être envoyée. Par défaut, c'est la page actuelle |
username | Chaîne | Spécifiez le nom d'utilisateur à utiliser dans les demandes d'authentification HTTP |
xhr | Fonction | Fonction utilisée pour créer des objets XMLHttpRequest |