雖然 JSON 已成主流,但 XML 在legacy系統、RSS、配置文件等場景仍廣泛使用。jQuery 提供了便捷的 XML 解析能力,本文總結三種常見方案與核心 API 用法。
$.ajax({
url: 'https://www.test.net/cgi/test.xml',
dataType: 'xml', // 關鍵:指定返回類型為 XML Document
success: function(xmlDoc) {
// xmlDoc 為 Document 對象,可直接用 jQuery 遍歷
$(xmlDoc).find("channel > item").each(function(index, item) {
var title = $(item).find("title").text();
var link = $(item).find("link").text();
$("#noticecon ol").append('' + title + ' ');
});
}
});
HTML 容器:
<div id="noticecon"><ol></ol></div>
$.get("https://www.test.net/cgi/test.xml", function(xmlDoc) {
$(xmlDoc).find('channel > item').each(function(index, item) {
var title = $(item).find('title').text();
var link = $(item).find('link').text();
$("#noticecon ol").append('' + title + ' ');
});
}, 'xml'); // 指定 dataType
jQuery 解析字符串要求單一根節點,否則只解析第一個頂級節點。
// 錯誤:多頂級節點
$("- 1
- 2
").find("item").length; // 1
// 正確:包裹根節點
$("- 1
- 2
").find("item").length; // 2
$(xmlDoc).find(selector) 定位目標節點集合.each() 遍歷節點$(this).attr("attrName") 獲取屬性$(this).find("childTag").text() 獲取子節點文本$(this).text() 獲取當前節點及所有後代文本XML 結構:
<?xml version="1.0" encoding="utf-8"?>
<fields>
<field Name="Name1">
<fieldname>dsname</fieldname>
<datatype>字符</datatype>
</field>
<field Name="Name2">
<fieldname>dstype</fieldname>
<datatype>字符</datatype>
</field>
</fields>
解析代碼:
$(xmlDoc).find("field").each(function() {
var $field = $(this);
var fName = $field.attr("Name"); // 讀取屬性
var fieldName = $field.find("fieldname").text(); // 子節點文本
var dataType = $field.find("datatype").text();
console.log(fName, fieldName, dataType);
});
XML 帶命名空間時,選擇器需轉義冒號:
// -> 選擇器
$(xml).find("ns\\:item"); // 或
$(xml).find("item", xml.documentElement.namespaceURI); // 配合 context
function xmlToJson(xmlDoc) {
var obj = {};
$(xmlDoc).children().each(function() {
var $this = $(this);
var key = $this[0].nodeName;
var val = $this.children().length ? xmlToJson(this) : $this.text();
if (obj[key]) {
if (!Array.isArray(obj[key])) obj[key] = [obj[key]];
obj[key].push(val);
} else {
obj[key] = val;
}
// 屬性合併
$.each(this.attributes, function() {
obj['@' + this.name] = this.value;
});
});
return obj;
}
大文件建議服務端分頁或流式傳輸,前端配合 XMLHttpRequest 進度事件處理。
| 問題 | 原因 | 解決 |
|---|---|---|
| 字符串解析只獲第一節點 | 無單一根節點 | 外層包裹 <root>...</root> |
| .text() 獲取空值 | 節點有子元素,文本在子節點 | 用 .find('child').text() 或 .contents().filter(...) |
| 屬性值獲取不到 | 大小寫敏感 / 命名空間 | .attr('Name') 精確匹配,命名空間用 .attr('ns:attr') |
| IE 下 XML 解析失敗 | 響應頭無 Content-Type: text/xml |
服務端設置正確 MIME,或用 $.parseXML(str) 手動解析 |
無依賴解析字符串:
var parser = new DOMParser();
var xmlDoc = parser.parseFromString(xmlString, "text/xml");
// 然後用原生 DOM API 或 $(xmlDoc) 繼續操作
jQuery 通過 dataType: 'xml' 自動處理響應解析,配合 find()、each()、attr()、text() 形成完整鏈式操作。掌握「根節點包裹」、「屬性 vs 文本」、「命名空間」三個關鍵點,即可應對 95% XML 解析場景。