XML DOM getElementsByTagNameNS() 方法

Document 對象參考手冊

定義和用法

getElementsByTagNameNS() 方法可返回帶有指定名稱和命名空間的所有元素的一個節點列表。

語法:

getElementsByTagNameNS(ns,name)
參數 描述
ns 字符串值,可規定需檢索的命名空間名稱。值 "*" 可匹配所有的標簽。
name 字符串值,可規定需檢索的標簽名。值 "*" 可匹配所有的標簽。

返回值

文檔樹中具有指定命名空間和本地名的 Element 節點的只讀數組(從技術上講,是 NodeList 對象)。

說明

該方法與 getElementsByTagName() 方法相似,只是它根據命名空間和名稱來檢索元素。只有使用命名空間的 XML 文檔才會使用它。

實例

在所有的例子中,我們將使用 XML 文件 books.xml,以及 JavaScript 函數 loadXMLDoc()

以下代碼片段可向每個 <book> 元素添加一個帶有命名空間的元素節點:

xmlDoc=loadXMLDoc("/example/xdom/books.xml");
var x=xmlDoc.getElementsByTagName('book');
var newel,newtext;
for (i=0;i<x.length;i++)
  {
  newel=xmlDoc.createElementNS('p','edition');
  newtext=xmlDoc.createTextNode('First');
  newel.appendChild(newtext);
  x[i].appendChild(newel);
  }
//輸出所有 title 和 edition
var y=xmlDoc.getElementsByTagName("title");
var z=xmlDoc.getElementsByTagNameNS("p","edition");
for (i=0;i<y.length;i++)
  {
  document.write(y[i].childNodes[0].nodeValue);
  document.write(" - ");
  document.write(z[i].childNodes[0].nodeValue);
  document.write(" edition");
  document.write("<br />");
  }

Document 對象參考手冊