English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
Il metodo $.ajax() esegue richieste HTTP asincrone (Ajax).
$.ajax() è il metodo di base per tutte le richieste Ajax inviate da jQuery. Di solito non è necessario chiamare direttamente questo metodo, perché è possibile$.get(),$.post()eload()e altri metodi più avanzati, più facili da usare. Ma, se si hanno bisogno di meno opzioni comuni, $.ajax() può essere utilizzato più flessibilmente.
Sintassi uno:1.5+ versione:
$.ajax(url, {name:value, name:value, ...})
Sintassi due :1.0+ versione:
$.ajax(name:value, name:value, ...)
UtilizzandoAggiungererichiesta AJAXVersioneModificare il testo dell'elemento DIV:1.5 versione:
$.ajax("ajax_intro.txt", {success: function(response){ $("div").html(response); });Prova a vedere <>/
UtilizzandoAggiungererichiesta AJAXVersioneModificare il testo dell'elemento DIV:1.0Versione:
$.ajax({ url: "ajax_intro.txt", success: function(response){ $("div").html(response); } });Prova a vedere <>/
Richiesta della pagina "ajax_get.php" e invio di altri dati:
$.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"}, success: function(response){ $("div").html(response); } });Prova a vedere <>/
Richiesta della pagina "ajax_get.php", invio di altri dati e messaggio di avviso di stato:
$.ajax({ url: "ajax_get.php", data: {fname:"Seagull", lname:"Anna"}, success: function(response, status){ $("div").html(response); alert(status); } });Prova a vedere <>/
Utilizzare il metodo HTTP POST per richiedere la pagina "ajax_post.php":
$.ajax({ url: "ajax_post.php", method: "POST", success: function(response){ $("div").html(response); } });Prova a vedere <>/
Utilizzare la impostazione asincrona per specificare la richiesta sincrona:
$.ajax({ url: "ajax_get.php", async: false, data: {fname:"Seagull", lname:"Anna"}, success: function(response){ $("div").html(response); } });Prova a vedere <>/
Utilizzare il dataType per specificare il tipo di dati della richiesta:
$.ajax({ url: "/javascript/myscript.js", dataType: "script" });Prova a vedere <>/
Se la richiesta Ajax incontra un errore, viene visualizzata una notifica:
$.ajax({ url: "wrong_file.html", success: function(response){ $("div").html(response); }, error: function(xhr){ $("div").html("Errore: " + xhr.status + " " + xhr.statusText); } });Prova a vedere <>/
Richiesta del file e notifica all'utente al completamento. Se la richiesta fallisce, viene visualizzata una notifica:
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); });Prova a vedere <>/
Specifica uno o più pair name:value per la richiesta AJAX
Possibili nomi: i valori nella tabella sottostante:
Nome | Tipo di valore | Descrizione |
---|---|---|
async | 布尔型 | Un valore booleano che indica se la richiesta deve essere elaborata asincronamente. Il valore predefinito è true |
beforeSend(xhr) | 函数 | La funzione che viene eseguita prima di inviare la richiesta |
cache | 布尔型 | Un valore booleano che indica se il browser deve cache la pagina della richiesta. Il valore predefinito è true |
complete(xhr,status) | 函数 | La funzione che viene eseguita dopo la completazione della richiesta (dopo le funzioni di successo e di errore) |
contentType | Valore booleano o stringa | Il tipo di contenuto utilizzato per inviare i dati al server. Il valore predefinito è 'application / x-www-form-urlencoded' |
context | 普通对象 | Specifica il valore di 'this' per tutte le funzioni di callback AJAX correlate |
data | PlainObject o Stringa o Array | Specifica i dati da inviare al server |
dataFilter(data,type) | 函数 | La funzione utilizzata per trattare i dati originali della risposta XMLHttpRequest |
dataType | 字符串 | Il tipo di dati atteso nella risposta del server |
error(xhr,status,error) | 函数 | La funzione che viene eseguita quando la richiesta fallisce |
global | 布尔型 | Un valore booleano che specifica se deve essere attivato l'handler globale degli eventi AJAX per la richiesta. Il valore predefinito è true |
ifModified | 布尔型 | Un valore booleano che specifica se la richiesta è riuscita solo se la risposta dall'ultima richiesta è cambiata. Il valore predefinito è false. |
jsonp | Stringa o booleana | Sovrascrive la funzione di callback nella richiesta jsonp |
jsonpCallback | 函数 | Assegna un nome alla funzione di callback per le richieste jsonp |
method | 字符串 | Specifica il metodo HTTP utilizzato per la richiesta (ottenimento o pubblicazione). Il valore predefinito è GET |
password | 字符串 | Specifica la password utilizzata per l'autenticazione HTTP nella richiesta |
processData | 布尔型 | Un valore booleano che specifica se i dati associati alla richiesta devono essere convertiti in una stringa di query. Il valore predefinito è true |
scriptCharset | 字符串 | 指定请求的字符集 |
statusCode | 普通对象 | 响应具有相应代码时将调用数字HTTP代码和函数的对象$ .ajax({ statusCode:{ 404:function(){ alert(“找不到页面”); } } )}) |
success(response,status,xhr) | 函数 | 请求成功时要运行的函数 |
timeout | 数字 | 请求的本地超时(以毫秒为单位) |
traditional | 布尔型 | 一个布尔值,指定是否使用传统的参数序列化样式 |
type | 字符串 | method的别名。如果您使用的是1.9.0之前的jQuery版本,则应使用type |
url | 字符串 | 指定将请求发送到的URL。默认为当前页面 |
username | 字符串 | 指定要在HTTP访问认证请求中使用的用户名 |
xhr | 函数 | 用于创建XMLHttpRequest对象的函数 |