萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 解析 XML 完全指南:AJAX 載入、字符串解析、節點遍歷

雖然 JSON 已成主流,但 XML 在legacy系統、RSS、配置文件等場景仍廣泛使用。jQuery 提供了便捷的 XML 解析能力,本文總結三種常見方案與核心 API 用法。

方案一:$.ajax 載入 XML 文件(推薦)

$.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 簡寫載入 XML

    $.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

    方案三:解析 XML 字符串(關鍵:需根節點包裹)

    jQuery 解析字符串要求單一根節點,否則只解析第一個頂級節點。

    // 錯誤:多頂級節點
    $("12").find("item").length; // 1
    
    // 正確:包裹根節點
    $("12").find("item").length; // 2
    

    通用解析步驟

    1. 獲取 XML Document(AJAX 返回 / 字符串解析)
    2. $(xmlDoc).find(selector) 定位目標節點集合
    3. .each() 遍歷節點
    4. 節點內部:
      • $(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);
    });
    

    進階技巧

    1. 命名空間處理

    XML 帶命名空間時,選擇器需轉義冒號:

    //  -> 選擇器
    $(xml).find("ns\\:item"); // 或
    $(xml).find("item", xml.documentElement.namespaceURI); // 配合 context
    

    2. XML 轉 JSON 工具函數

    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;
    }
    

    3. 異步加載大 XML 分塊處理

    大文件建議服務端分頁或流式傳輸,前端配合 XMLHttpRequest 進度事件處理。

    常見坑點

    問題 原因 解決
    字符串解析只獲第一節點 無單一根節點 外層包裹 <root>...</root>
    .text() 獲取空值 節點有子元素,文本在子節點 用 .find('child').text() 或 .contents().filter(...)
    屬性值獲取不到 大小寫敏感 / 命名空間 .attr('Name') 精確匹配,命名空間用 .attr('ns:attr')
    IE 下 XML 解析失敗 響應頭無 Content-Type: text/xml 服務端設置正確 MIME,或用 $.parseXML(str) 手動解析

    現代替代:DOMParser

    無依賴解析字符串:

    var parser = new DOMParser();
    var xmlDoc = parser.parseFromString(xmlString, "text/xml");
    // 然後用原生 DOM API 或 $(xmlDoc) 繼續操作
    

    結語

    jQuery 通過 dataType: 'xml' 自動處理響應解析,配合 find()、each()、attr()、text() 形成完整鏈式操作。掌握「根節點包裹」、「屬性 vs 文本」、「命名空間」三個關鍵點,即可應對 95% XML 解析場景。

    copyright © 萬盛學電腦網 all rights reserved