在早期的 Web 開發場景裡,XML 曾是伺服器與瀏覽器之間最常見的資料交換格式。即使今天 JSON 已經成為主流,許多老系統、開放資料平台與企業內部服務仍然只提供 XML 回應。因此,「如何用 jQuery 發送請求並解析 XML」依然是前端工程師值得掌握的基本功。
本文以一個可運行的完整範例,示範如何透過 $.ajax() 抓取同目錄下的 AJax.XML,取出其中的 row 節點與屬性,再動態組合成表格列輸出到頁面上。
<script type="text/javascript">
$(function () {
// one() 代表這段點擊事件只會觸發一次
$("#AJax").one('click', function () {
$.ajax({
url: 'AJax.XML',
// data: { id: 1, name: 0 },
dataType: 'XML',
error: function () {
alert('載入出錯');
},
success: function (xml) {
$(xml).find("row").each(function (i) {
var id = $.trim($(this).children("id").text()); // 子節點內容
var v1 = $(this).attr('v1'); // 屬性值
var v2 = $(this).attr('v2');
var v3 = $(this).attr('v3');
var v4 = $(this).attr('v4');
var v5 = $(this).attr('v5');
$('<tr></tr>')
.html(
'<td>id:' + id + '</td>' +
'<td>v1:' + v1 + '</td>' +
'<td>v2:' + v2 + '</td>' +
'<td>v3:' + v3 + '</td>' +
'<td>v4:' + v4 + '</td>' +
'<td>v5:' + v5 + '</td>'
)
.appendTo("#list");
});
}
});
});
// 第二次以後的點擊改為收合/展開
$("#AJax").click(function () { $(this).nextAll().toggle(); });
$("#T1").click(function () { $(this).next().toggle(); });
});
</script>
把 dataType 設為 'XML',jQuery 會自動把 responseText 交給瀏覽器的 XML 解析器,變成一份文件物件模型。這樣一來,你就能直接用 find()、children()、attr() 這些熟悉的 jQuery 方法操作它,而不必自己寫字串切割。
範例中的 v1~v5 是節點的屬性,必須用 attr() 讀取;而 id 是子節點的內容,要用 children("id").text()。這是初學者最常混淆的地方——如果誤把屬性當子節點讀,只會拿到空字串。
XML 檔案裡為了排版而產生的縮排與換行,都會被 text() 一起取出來,造成畫面上出現莫名的空白。$.trim() 能把頭尾的空白字元清乾淨。
檔案路徑寫錯、MIME 型別不符、伺服器回傳 404,都會讓請求失敗。少了 error 回呼,使用者只會看到一片空白,完全不知道發生了什麼事。
第一,若使用較新版本的 jQuery,動態建立元素時建議改用 $('<tr>') 搭配 .html(),並留意舊版的 .live() 已被移除,事件委派請改用 .on()。
第二,在迴圈中反覆呼叫 appendTo() 會觸發多次 DOM 重排。當資料量大的時候,比較好的做法是把 HTML 先組進一個字串或 DocumentFragment,迴圈結束後再一次插入,效能差距相當明顯。
掌握以上幾點,你就能把任何 XML 介面平滑地接進 jQuery 的頁面裡;若後端也支援 JSON,則可把 dataType 改為 'json',其餘邏輯幾乎不必更動。