Requête Ajax
jQuery.ajax(options)
Charger des données distantes via une requête HTTP. jQuery sous-jacent à l’implémentation d’AJAX. Pour des implémentations de haut niveau simples et faciles à utiliser, voir .get, .post, etc.
.ajax() renvoie l'objet XMLHttpRequest qu'il a créé. Dans la plupart des cas, vous n'aurez pas besoin de manipuler cet objet directement, mais dans des cas particuliers, il peut être utilisé pour terminer manuellement la requête. .ajax() n'a qu'un seul paramètre : paramètre clé/valeur objet, comprenant chaque configuration et fonction de rappel informations. Voir les options de paramètres détaillées ci-dessous.
Remarque : Si vous spécifiez l'option dataType, veuillez vous assurer que le serveur renvoie les informations MIME correctes (par exemple, xml renvoie "text/xml"). Des types MIME incorrects peuvent provoquer des erreurs imprévisibles.
Remarque : Si dataType est défini sur "script", alors lors des requêtes distantes (pas sous le même domaine), toutes les requêtes POST seront converties en requêtes GET. (Parce que la balise de script DOM sera utilisée pour le chargement)
Dans jQuery 1.2, vous pouvez charger des données JSON sur plusieurs domaines. Lorsque vous l'utilisez, vous devez définir le type de données sur JSONP. Lors de l'appel d'une fonction à l'aide d'un formulaire JSONP, tel que "myurl?callback=?", jQuery remplacera automatiquement ? par le nom de fonction correct pour exécuter la fonction de rappel. Lorsque le type de données est défini sur "jsonp", jQuery appellera automatiquement la fonction de rappel.
Valeur de retour XMLHttpRequest
Paramètres
options (facultatif) : paramètres de requête AJAX. Toutes les options sont facultatives.
Options
(1), async (Booléen) : (Par défaut : vrai)
Par défaut, toutes les requêtes sont des requêtes asynchrones. Si vous devez envoyer des requêtes synchrones, définissez cette option sur false. Notez qu'une requête synchrone verrouillera le navigateur et que l'utilisateur devra attendre que la requête soit terminée avant de pouvoir effectuer d'autres opérations.
(2) beforeSend (Fonction) : Une fonction qui peut modifier l'objet XMLHttpRequest avant d'envoyer la requête, comme l'ajout d'un en-tête HTTP personnalisé.
L'objet XMLHttpRequest est le seul paramètre. C'est un événement de l'Ajax. Si false est renvoyé, cette requête ajax peut être annulée.
(3), cache (booléen) : (par défaut : vrai, la valeur par défaut est fausse lorsque dataType est un script)
La nouvelle fonctionnalité de jQuery 1.2, définie sur false, ne se chargera pas à partir du cache du navigateurDemander des informations .
(4), complete (Fonction) : fonction de rappel une fois la requête terminée (appelée lorsque la requête réussit ou échoue).
Paramètres : objet XMLHttpRequest et une chaîne décrivant le type de requête réussie. Il s'agit d'un événement Ajax
(5), contentType (String) : (Par défaut : "application/x-www-form-urlencoded") Type d'encodage du contenu lors de l'envoi d'informations au serveur. La valeur par défaut convient à la plupart des applications.
(6), data (Object, String) : Données envoyées au serveur. Sera automatiquement converti au format de chaîne de demande. Ajouté à l'URL dans les requêtes GET. Consultez la description de l’option processData pour désactiver cette conversion automatique.
Doit être au format Clé/Valeur. S'il s'agit d'un tableau, jQuery attribuera automatiquement le même nom à différentes valeurs. Par exemple, {foo:["bar1", "bar2"]} est converti en '&foo=bar1&foo=bar2'.
(7), dataFilter (Fonction) : Une fonction qui prétraite les données originales renvoyées par Ajax. Fournissez deux paramètres, data et type : data sont les données d'origine renvoyées par Ajax et type est le paramètre dataType fourni lors de l'appel de jQuery.ajax. La valeur renvoyée par la fonction sera ensuite traitée par jQuery.
(8), dataType (String) : (Valeur par défaut : déterminer intelligemment XML ou HTML)
Le type de données qui devrait être renvoyé par le serveur. S'il n'est pas spécifié, jQuery renverra automatiquement ResponseXML ou ResponseText en fonction des informations MIME du package HTTP et le transmettra comme paramètre de fonction de rappel Valeurs disponibles :
"xml" : renvoie un document XML. qui peut être traité par jQuery .
"html" : renvoie les informations HTML en texte brut ; la balise de script incluse sera exécutée une fois insérée dans le dom.
"script" : renvoie le code JavaScript en texte brut. Les résultats ne sont pas automatiquement mis en cache. Sauf si le paramètre "cache" est défini. Remarque : lors de requêtes distantes (pas sous le même domaine), toutes les requêtes POST seront converties en requêtes GET. (Car la balise du script DOM sera utilisée pour le chargement)
"json" : renvoie les données JSON.
"jsonp" : format JSONP. Lors de l'appel d'une fonction à l'aide d'un formulaire JSONP, tel que "myurl?callback=?", jQuery remplacera automatiquement ? par le nom de fonction correct pour exécuter la fonction de rappel.
"text": Renvoie une chaîne de texte brut
(9), erreur (Fonction) : (Par défaut : détermine automatiquement (xml ou html)) L'heure d'appel lorsque la requête échoue. Il existe trois paramètres : l'objet XMLHttpRequest, le message d'erreur et (facultatif) l'objet d'erreur capturé. Si une erreur se produit, le message d'erreur (le deuxième paramètre) peut être "timeout", "error", "notmodified" et "parsererror" en plus de null. Événements d'Ajax.
(10), global (Boolean) : (Par défaut : true) Indique s'il faut déclencher des événements AJAX globaux. La définition sur false ne déclenchera pas d'événements AJAX globaux tels que ajaxStart ou ajaxStop qui peuvent être utilisés pour contrôler différents événements Ajax.
(11), ifModified (Boolean) : (Par défaut : false) Obtenez de nouvelles données uniquement lorsque les données du serveur changent. Utilisez les informations d’en-tête Last-Modified du paquet HTTP pour le déterminer.
(12), jsonp (String) : Réécrivez le nom de la fonction de rappel dans une requête jsonp. Cette valeur est utilisée pour remplacer la partie "callback" du paramètre URL dans une requête GET ou POST telle que "callback=?". Par exemple, {jsonp:'onJsonPLoad'} entraînera la transmission de "onJsonPLoad=?". le serveur.
(13), password (String) : Mot de passe utilisé pour répondre à la demande d'authentification d'accès HTTP
(14), processData (Boolean) : (Par défaut : true) Par défaut, envoyé Les données sera converti en objet (pas techniquement en chaîne) pour correspondre au type de contenu par défaut "application/x-www-form-urlencoded". Définissez sur false si vous souhaitez envoyer des informations sur l'arborescence DOM ou d'autres informations que vous ne souhaitez pas convertir.
(15), scriptCharset (String) : Ce n'est que lorsque le dataType est "jsonp" ou "script" lors de la requête et que le type est "GET" qu'il sera utilisé pour forcer la modification du jeu de caractères. Généralement utilisé lorsque les encodages de contenu local et distant sont différents.
(16), success (Fonction) : fonction de rappel une fois la requête réussie. Paramètres : Données renvoyées par le serveur et traitées selon le paramètre dataType ; une chaîne décrivant l'état. Événements d'Ajax.
(17), timeout (Number) : Définissez le délai d'expiration de la demande (millisecondes). Ce paramètre remplace le paramètre global.
(18), tapez (String) : (Par défaut : "GET") Méthode de requête ("POST" ou "GET"), la valeur par défaut est "GET". Remarque : D'autres méthodes de requête HTTP telles que PUT et DELETE peuvent également être utilisées, mais ne sont prises en charge que par certains navigateurs.
(19), url (String) : (Par défaut : adresse de la page actuelle) L'adresse à laquelle envoyer la demande.
(20), username (String) : Nom d'utilisateur utilisé pour répondre à la demande d'authentification d'accès HTTP
(21), xhr (Function) : Besoin de renvoyer un objet XMLHttpRequest. La valeur par défaut est ActiveXObject sous IE et XMLHttpRequest dans les autres cas. Utilisé pour remplacer ou fournir un objet XMLHttpRequest amélioré. Ce paramètre n'était pas disponible avant jQuery 1.3.
Utilisez la méthode jQuery.ajax() pour obtenir des données, le code est le suivant :
$.ajax({ url: "http://www.php.cn", //请求的url地址 dataType: "json", //返回格式为json async: true, //请求是否异步,默认为异步,这也是ajax重要特性 data: { "id": "value" }, //参数值 type: "GET", //请求方式 beforeSend: function() { //请求前的处理 }, success: function(req) { //请求成功时处理 }, complete: function() { //请求完成的处理 }, error: function() { //请求出错处理 } });
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!