|
$.ajax( options )
ritorno: XMLHttpRequest
options: coppie chiave/valore di opzioni per configurare la chiamata AJAX.utilizzo: $.ajax({
nome_opzione1: valore1,
nome_opzione2: valore2
});
In questo articolo esporremo la funzione jQuery.ajax(options) o meglio ancora $.ajax(options).
Questa funzione è un'implementazione di basso livello di AJAX che jQuery mette a disposizione dell' utente.
Il ritorno di questa funzione è XMLHttpRequest.
Essa offre molte funzionalità tramite le options che si possono settare: è grazie alla modifica di queste che tale funzione offre all'utente la massima personalizzazione della chiamata.
Molte opzioni permettono inoltre di definire nuove operazioni da svolgere quando la chiamata si comporta in un determinato modo, ad esempio quando ha successo o quando avviene qualche errore.
Insomma le opzioni che fornisce jQuery sono veramente tante e tutte molto utili.
Vediamone ora alcune che accompagnare da una breve descrizione: Nome Opzione
| Tipo
| Default | Descrizione
| | async | Boolean | true | Imposta se la chiamata deve essere asincrona (default) o sincrona. | beforSend
| Function | | Modificare XMLHttpRequest, passato come argomento, prima che sia inviato.
Es: function (XMLHttpRequest){....} | | cache | Boolean
| true (false per dataType "script" e "jsonp")
| Se settato su false forza la pagina a non utilizzare la cache del browser
| complete
| Function
| | Funzione da eseguire dopo che la richiesta è finita. Tale funzione è eseguita dopo che le funzioni di successo e errore sono eseguite.
Es: function (XMLHttpRequest, textStatus){.....}
| contentType
| String
| "application/x-www-form-urlencoded"
| Imposta il conten-type dei dati inviati al server. Il valore di default va bene quasi in ogni caso. | data
| Object, String
| | Dati inviati al server. L'oggetto deve essere una coppia chiave/valore. Essi sono convertiti in stringhe se non lo sono già. I dati sono inseriti nell'URL e possono essere prelevati tramite il metodo GET. Si possono passare anche array. | | dataType | String
| xml o html
| Tipo di dato che ci si aspetti ritorni il server. Se non è specificato si basa sul MIME type della risposta.
Tipi ammessi: "xml", "html", "script", "json", "jsonp" e "text". | | error | Function | | La funzione da eseguire nel caso la richiesta fallisse. La funzione ha 3 argomenti: l'oggetto XMLHttpRequest, una stringa che descrive l'errore e un'exception object.
Es: function (XMLHttpRequest, textStatus, errorThrown){.....} | | ifModified | Boolean
| false
| La richiesta ha successo solo se la risposta è cambiata dall'ultima richiesta, controllando tale informazione nell'header. Normalmente questo non è così, perciò di default il valore è false e si ignora l'header. | password
| String
| | Password da usare in risposta ad una richiesta di autenticazione HTTP.
| success
| Function
| | La funzione da eseguire quando la chiamata ha successo. La funzione ha due argomenti: i dati ritornati dal server formattati in accordo con il dataType; e una stringa che descrive lo stato.
Es: function (data, textStatus) {....}
| timeout
| Number
| | Timeout locale in millisecondi per la richiesta. Questo sovrascrive il valore globale settato tramite $.ajaxSetup(). Questa funzione è molto utile per differenziare i timeout delle varie richieste | | type | String
| "GET"
| Il tipo di richiesta ("POST" o "GET"). Anche altri metodi HTTP sono utilizzabili (PUT, DELETE, ...) ma non tutti i browser li supportano. | url
| String
| pagina corrente | L'URL da chiedere. Esso deve essere una stringa e NON un Location Objec.
SI: document.location.href
NO: document.location | | username | String
| | Username da usere in risposta ad una richiesta di autenticazione HTTP. |
Ricordiamo che tutte le opzioni vanno scritte come coppia chiave valore e che le opzioni tra loro vanno separate da virgola (",") a parte l'ultima che invece si conclude senza niente. Per una più completa documentazione rimandiamo a leggere la guida ufficiale riguardante l'utilizzo di questa funzione.
|
