XPath 的定位方式與我們在檔案系統中查找檔案的邏輯頗為相似。掌握幾個關鍵符號與函式,就能在 XML 文件裡精準地鎖定想要的節點。以下透過十一個由淺入深的實例,帶你快速上手。
當路徑以單斜線 / 起始時,代表從根節點開始的絕對路徑。
/AAA 選取根元素 AAA;/AAA/CCC 選取 AAA 底下所有的 CCC 子元素;/AAA/DDD/BBB 則選取 AAA 的子元素 DDD 底下的所有 BBB 子元素。
若路徑以雙斜線 // 開頭,代表不論階層深淺,選取文件中所有符合規則的元素。//BBB 會選出文件中所有的 BBB 元素;//DDD/BBB 則只選取父元素為 DDD 的 BBB 元素。
星號 * 用來選取「星號之前那段路徑」所定位到的所有元素。
/AAA/CCC/DDD/* 選取所有掛在 /AAA/CCC/DDD 底下的元素;/*/*/*/BBB 選取所有擁有三個祖先行為的 BBB 元素;//* 則選取文件中的所有元素。
方括號中的運算式可以進一步篩選元素,數字代表元素在選取集中的位置,而 last() 則代表選取集中的最後一項。
/AAA/BBB[1] 選取 AAA 的第一個 BBB 子元素;/AAA/BBB[last()] 選取 AAA 的最後一個 BBB 子元素。
//@id 選取所有的 id 屬性;//BBB[@id] 選取帶有 id 屬性的 BBB 元素;//BBB[@name] 選取帶有 name 屬性的 BBB 元素。
//BBB[@*] 選取帶有任意屬性的 BBB 元素;//BBB[not(@*)] 則選取完全沒有屬性的 BBB 元素。
屬性的值同樣可以用來當作篩選條件。內建的 normalize-space 函式會移除字串前後的空白,並把連續空白轉為單一空白。
//BBB[@id='b1'] 選取 id 屬性值為 b1 的 BBB 元素;//BBB[@name='bbb'] 選取 name 屬性值為 bbb 的 BBB 元素;//BBB[normalize-space(@name)='bbb'] 則會先正規化 name 值再比對,因此即使值為 " bbb " 也能匹配。
count() 可計算所選元素的數量。
//*[count(BBB)=2] 選取含有兩個 BBB 子元素的元素;//*[count(*)=2] 選取含有兩個子元素的元素;//*[count(*)=3] 選取含有三個子元素的元素。
name() 回傳元素名稱;starts-with() 在第一個參數字串以第二個參數開頭時回傳 true;contains() 則在第一個字串包含第二個字串時回傳 true。
//*[name()='BBB'] 選取所有名稱為 BBB 的元素(等同於 //BBB);//*[starts-with(name(),'B')] 選取所有名稱以 B 開頭的元素;//*[contains(name(),'C')] 選取所有名稱中含有 C 的元素。
多條路徑可用分隔符 | 串接起來。//CCC | //BBB 同時選取所有的 CCC 與 BBB 元素;/AAA/EEE | //BBB 選取所有 BBB 元素以及身為 AAA 子元素的 EEE 元素。可合併的路徑數量並沒有限制,例如 /AAA/EEE | //DDD/CCC | /AAA | //BBB。
child 軸包含上下文節點的子元素,是預設的軸,因此可省略不寫。/AAA 等同於 /child::AAA;/AAA/BBB 等同於 /child::AAA/child::BBB。兩種寫法也可以混用,例如 /child::AAA/BBB。
descendant 軸包含上下文節點的所有後代,也就是子節點、子節點的子節點等等,因此不會包含屬性與命名空間節點。
/descendant::* 選取根元素底下的所有後代(即全部元素);/AAA/BBB/descendant::* 選取 /AAA/BBB 的所有後代元素;//CCC/descendant::* 選取所有祖先元素中含有 CCC 的元素。
熟練以上這些語法與函式,你就能應付絕大多數 XML 節點定位的情境了。