load() 方法最常見的用法,是從伺服器端抓一份靜態資料檔回來塞進頁面,但這樣其實還沒發揮出 Ajax 真正的威力。
當你在實作專案時,需要把一些參數送到伺服器端的頁面,這時就該改用 $.get()、$.post(),或是更底層的 $.ajax() 方法。
語法結構為:$.get(url [, data] [, callback] [, type])
各參數說明如下:
url(String):要請求的 HTML 頁面位址。
data(Object,選填):送往伺服器的 key/value 資料,會以 QueryString 的形式附加在請求 URL 之後。
callback(Function,選填):載入成功後呼叫的回呼函式,只有當 Response 的狀態為 success 時才會執行,並自動把請求結果與狀態傳入。
type(String,選填):伺服器端回傳內容的格式,可為 xml、html、script、json、text 或 _default。
$.post() 的結構與用法和 $.get() 幾乎一致,但兩者仍有幾個關鍵差異:
GET 會把參數附加在 URL 後方傳送,POST 則是把資料放進 HTTP 訊息的實體內容中送出。
GET 對傳輸的資料量有大小限制(通常不超過 2KB),POST 能傳送的資料量則大得多,理論上幾乎不受限制。
GET 請求的資料會被瀏覽器快取,其他人有機會從瀏覽器歷史紀錄中讀到這些內容,例如帳號、密碼等敏感資訊;在某些情境下 GET 會帶來嚴重的安全疑慮,而 POST 相對能避開這類問題。
此外,兩者在伺服器端取得資料的方式也不相同。
jQuery 提供了这个方法,讓載入一支 js 檔變得像載入一段 HTML 片段一樣簡單,而且不需要額外處理,JavaScript 檔會自動執行。
jQuery 程式碼如下:
程式碼如下:
$(function () {
$("#send").click(function () {
$.getScript("test.js");
});
})
和其他 ajax 方法一樣,$.getScript() 也支援回呼函式,會在 JavaScript 檔載入成功後執行。
舉例來說,想載入 jQuery 官方的顏色動畫外掛(jquery.color.js),成功後再幫元素綁上顏色變化的動畫:
程式碼如下:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<script type="text/javascript" src="../../js/jquery-2.1.3.js"></script>
<style>
* { margin:0; padding:0;}
body { font-size:12px;}
.comment { margin-top:10px; padding:10px; border:1px solid #ccc;background:#DDD;}
.comment h6 { font-weight:700; font-size:14px;}
.para { margin-top:5px; text-indent:2em;background:#DDD;}
.block{width:80px;height:80px;background:#DDD;}
</style>
<title></title>
</head>
<body>
<button id="go">運行</button>
<div class="block"></div>
</body>
<script type="text/javascript">
$(function () {
$.getScript("jquery.color.js", function () {
$("#go").click(function () {
$(".block").animate({backgroundColor: 'pink'}, 1000)
.animate({backgroundColor: 'blue'}, 1000);
});
})
})
</script>
</html>
這個方法專門用來載入 JSON 檔,用法和 $.getScript() 幾乎相同。
程式碼如下:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<script src="../../js/jquery-2.1.3.js"></script>
<style>
* { margin:0; padding:0;}
body { font-size:12px;}
.comment { margin-top:10px; padding:10px; border:1px solid #ccc;background:#DDD;}
.comment h6 { font-weight:700; font-size:14px;}
.para { margin-top:5px; text-indent:2em;background:#DDD;}
</style>
<title></title>
</head>
<body>
<br/>
<p>
<input type="button" id="send" value="加載"/>
</p>
<div class="comment">已有評論:</div>
<div id="resText" >
</div>
</body>
<script type="text/javascript">
$(function () {
$('#send').click(function() {
$.getJSON('test.json', function(data) {
$('#resText').empty();
var html = '';
$.each( data , function(commentIndex, comment) {
html += '<div class="comment"><h6>' + comment['username'] + ':</h6><p class="para">' + comment['content'] + '</p></div>';
})
$('#resText').html(html);
})
})
})
</script>
</html>
test.json 檔的內容為:
程式碼如下:
[
{
"username": "張三",
"content": "沙發."
},
{
"username": "李四",
"content": "板凳."
},
{
"username": "王五",
"content": "地板."
}
]
還能搭配 JSONP 形式的回呼函式,載入其他網站的 JSON 資料,例如:
程式碼如下:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<script src="../../js/jquery-2.1.3.js"></script>
<style>
* { margin:0; padding:0;}
body { font-size:12px;}
.para {
width:100px;
height:100px;
margin:5px;
border:0;
}
</style>
<title></title>
</head>
<body>
<p>
<input type="button" id="send" value="加載"/>
</p>
<div id="resText" >
</div>
</body>
<script type="text/javascript">
$(function () {
$('#send').click(function() {
$.getJSON("https://api.flickr.com/services/feeds/photos_public.gne?tags=car&tagmode=any&format=json&jsoncallback=?",
function(data){
$.each(data.items, function( i,item ){
$("<img class='para'/> ").attr("src", item.media.m).appendTo("#resText");
if ( i == 3 ) {
return false;
}
});
}
);
})
})
/**
* JSONP(JSON with Padding)是一個非官方的協議,它允許在服務器端集成 Script tags 返回至客戶端,通過 JavaScript Callback 的形式實現跨域訪問
* 上述的 url 地址並不能請求到數據,僅用作說明。
* */
</script>
</html>
補充說明:
jQuery 會自動把 URL 裡回呼函式的佔位符,例如「url?callback=?」中的後一個「?」,替換成正確的函式名稱,以便執行回呼。
JSONP(JSON with Padding)是一個非官方協議,它允許伺服器端把 Script 標籤整合後回傳給用戶端,藉由 JavaScript Callback 的形式達成跨域存取。由於 JSON 只是一種帶有簡單括號結構的純文字,許多通道都能用來交換 JSON 訊息;而受限於同源政策,開發者無法在與外部伺服器通訊時使用 XMLHttpRequest,JSONP 正是繞過同源政策的一種做法——把 JSON 與 <script> 標記結合,讓伺服器端直接回傳可執行的 JavaScript 函式呼叫或物件。目前 JSONP 已成為各大企業 Web 應用程式跨域的首選方案。
它的結構為:$.ajax(options)。這個方法只有一個參數,但這個物件裡包含了所有請求設定與回呼函式等資訊,以 key/value 的形式呈現,且所有參數都是選填的。
常用參數如下:
url(String):發送請求的位址,預設為目前頁面位址。
type(String):請求方式,post 或 get,預設為 get。其他 HTTP 方法如 PUT、DELETE 理論上也能用,但僅部分瀏覽器支援。
timeout(Number):設定請求逾時時間(毫秒),此設定會覆蓋 $.ajaxSetup() 的全域設定。
data(Object 或 String):送往伺服器的資料,若不是字串會自動轉為字串格式;GET 請求會附加在 url 後方,可用 processData 選項防止自動轉換。物件須為 key/value 格式,例如 {foo1:"bar1", foo2:"bar2"} 會轉成 &foo1=bar1&foo2=bar2;若是陣列,jQuery 會自動為多個值對應同一個名稱,例如 {foo:["bar1", "bar2"]} 轉為 &foo=bar1&foo=bar2。
dataType(String):預期伺服器回傳的資料型別。若不指定,jQuery 會依 HTTP 包的 MIME 資訊自動回傳 responseXML 或 responseText,並作為回呼函式的參數。可用型別如下:
xml:回傳 XML 文件,可用 jQuery 處理。
html:回傳純文字 HTML 資訊;其中的 script 標籤會在插入 DOM 時執行。
script:回傳純文字 JavaScript 碼,預設不會快取結果,除非設定 cache 參數。注意在遠端請求(不同網域)時,所有 POST 請求都會被轉為 GET。
json:回傳 JSON 資料。
jsonp:JSONP 格式。使用 JSONP 呼叫函式時,例如 myurl?callback=?,jQuery 會自動把後一個「?」替換成正確的函式名稱以執行回呼。
text:回傳純文字字串。
beforeSend(Function):在發送請求前可修改 XMLHttpRequest 物件的函式,例如加入自訂的 HTTP 標頭;若在 beforeSend 中回傳 false 可取消本次 Ajax 請求。XMLHttpRequest 物件是唯一的參數。
function(XMLHttpRequest) {
this;//呼叫本次 Ajax 請求時傳遞的 options 參數
}
complete(Function):請求完成後呼叫的回呼函式(成功或失敗時都會呼叫),參數為 XMLHttpRequest 物件與一個描述請求狀態的字串。
function(XMLHttpRequest, textStatus){
this;//呼叫本次 Ajax 請求時傳遞的 options 參數
}
success(Function):請求成功後呼叫的回呼函式,有兩個參數:(1)由伺服器回傳並依 dataType 處理後的資料;(2)描述狀態的字串。
function(data, textStatus) {
//data 可能是 xmlDoc、jsonObj、html、text 等
this;//呼叫本次 Ajax 請求時傳遞的 options 參數
}
error(Function):請求失敗時呼叫的函式,有三個參數,即 XMLHttpRequest 物件、錯誤資訊、捕獲的錯誤物件(選填)。
function(XMLHttpRequest, textStatus, errorThrown) {
//通常情況下 textStatus 和 errorThrown 只有其中一個包含資訊
this;//呼叫本次 Ajax 請求時傳遞的 options 參數
}
global(Boolean):預設為 true,表示是否觸發全域 Ajax 事件。設為 false 將不觸發全域 Ajax 事件,而 AjaxStart 或 AjaxStop 可用於控制各種 Ajax 事件。