Das Beispiel in diesem Artikel erläutert die Parameter der jQuery-Methode $.ajax() als Referenz. Der spezifische Inhalt lautet wie folgt:
$.ajax({ url:'test.do', data:{id:123,name:'xiaoming'}, type:'post', dataType:'json', success:function(data){ alert(data);//弹窗 //TODO ........ }, error:function(data){ alert(data);//弹窗 //TODO ........ } })
URL : Die Anforderung ist ein Parameter vom Typ String (Standard ist die aktuelle Seitenadresse), die Adresse zum Senden der Anforderung.
Typ: Der Parameter muss vom Typ „String“ sein. Die Anforderungsmethode (Post oder Get) ist standardmäßig „get“. Beachten Sie, dass auch andere HTTP-Anfragemethoden wie Put und Delete verwendet werden können, diese jedoch nur von einigen Browsern unterstützt werden.
<<> Async: Die Parameter vom Typ BOOLEAN sind erforderlich, die Standardeinstellung ist true und alle Anforderungen sind asynchrone Anforderungen. Wenn Sie synchrone Anfragen senden müssen, legen Sie diese Option auf „false“ fest. Beachten Sie, dass eine synchrone Anfrage den Browser sperrt und der Benutzer warten muss, bis die Anfrage abgeschlossen ist, bevor andere Vorgänge ausgeführt werden können.
<<> Cache: Die Parameter müssen vom Typ Boolean sein, der Standardwert ist „True“ (wenn der Datentyp „Skript“ ist, ist der Standardwert „False“). Bei der Einstellung „false“ werden keine Anforderungsinformationen aus dem Browser-Cache geladen.
sind wie folgt:
xml: Gibt ein XML-Dokument zurück, das mit JQuery verarbeitet werden kann.
html: Gibt reine Text-HTML-Informationen zurück; das enthaltene Skript-Tag wird ausgeführt, wenn es in das DOM eingefügt wird.
json: Gibt JSON-Daten zurück.
jsonp: JSONP-Format. Wenn Sie eine Funktion mit dem SONP-Formular aufrufen, z. B. myurl?callback=?, ersetzt JQuery automatisch das letzte „?“ durch den richtigen Funktionsnamen, um die Rückruffunktion auszuführen. text: Gibt eine einfache Textzeichenfolge zurück.
beforeSend: Der Parameter muss vom Typ „Funktion“ sein. Sie können die Funktion des XMLHttpRequest-Objekts ändern, bevor Sie die Anforderung senden, z. B. einen benutzerdefinierten HTTP-Header hinzufügen. Wenn in beforeSend false zurückgegeben wird, kann diese Ajax-Anfrage abgebrochen werden. Das XMLHttpRequest-Objekt ist der einzige Parameter.
function(XMLHttpRequest){
this; //Die beim Aufruf dieser Ajax-Anfrage übergebenen Optionsparameter
}
Parameter: XMLHttpRequest-Objekt und eine Zeichenfolge, die den erfolgreichen Anforderungstyp beschreibt.
function(XMLHttpRequest, textStatus){
this; //Der beim Aufruf dieser Ajax-Anfrage übergebene Optionsparameter
}
success:要求为Function类型的参数,请求成功后调用的回调函数,有两个参数。
(1)由服务器返回,并根据dataType参数进行处理后的数据。
(2)描述状态的字符串。
function(data, textStatus){
//data可能是xmlDoc、jsonObj、html、text等等
this; //调用本次ajax请求时传递的options参数
error:要求为Function类型的参数,请求失败时被调用的函数。该函数有3个参数,即XMLHttpRequest对象、错 误信息、捕获的错误对象(可选)。
ajax事件函数如下:
function(XMLHttpRequest, textStatus, errorThrown){ //通常情况下textStatus和errorThrown只有其中一个包含信息 this; //调用本次ajax请求时传递的options参数 }
contentType:要求为String类型的参数,当发送信息至服务器时,内容编码类型默认为"application/x-www-form-urlencoded"。该默认值适合大多数应用场合。
dataFilter:要求为Function类型的参数,给Ajax返回的原始数据进行预处理的函数。
提供data和type两个参数。data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
function(data, type){ //返回处理后的数据 return data; }
global:要求为Boolean类型的参数,默认为true。表示是否触发全局ajax事件。设置为false将不会触发全局ajax事件,ajaxStart或ajaxStop可用于控制各种ajax事件。
ifModified:要求为Boolean类型的参数,默认为false。仅在服务器数据改变时获取新数据。服务器数据改变判断的依据是Last-Modified头信息。默认值是false,即忽略头信息。
jsonp:要求为String类型的参数,在一个jsonp请求中重写回调函数的名字。该值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分,例如 {jsonp:'onJsonPLoad'}会导致将"onJsonPLoad=?"传给服务器。
username:要求为String类型的参数,用于响应HTTP访问认证请求的用户名。
password:要求为String类型的参数,用于响应HTTP访问认证请求的密码。
processData:要求为Boolean类型的参数,默认为true。默认情况下,发送的数据将被转换为对象(从技术角度来讲并非字符串)以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM树信息或者其他不希望转换的信息,请设置为false。
scriptCharset:要求为String类型的参数,只有当请求时dataType为"jsonp"或者"script",并且type是GET时才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。
案例代码:
$(function(){ $('#send').click(function(){ $.ajax({ type: "GET", url: "test.json", data: {username:$("#username").val(), content:$("#content").val()}, dataType: "json", success: function(data){ $('#resText').empty(); //清空resText里面的所有内容 var html = ''; $.each(data, function(commentIndex, comment){ html += ' ' + comment['username'] + ':