XMLDOM對像方法:對像屬性

async 屬性

 作   用

 async 屬性表示是否允許異步的下載。

 基本語法

 boolValue = XMLDocument.async;XMLDocument.async = boolValue;

說   明

 布爾值是可擦寫的(read/write),如果准許異步下載,值為True;反之則為False。

范   例

xmlDoc.async = "false";
alert(xmlDoc.async);

attribute 屬性

 作   用

 傳回目前節點的屬性列表。

 基本語法

 objAttributeList = xmlNode.attributes;

說   明

 傳回一個物件。如果此節點不能包含屬性,則傳回空值。

范   例

objAttList = xmlDoc.documentElement.attributes;
alert(objAttList);

childNodes 屬性

 作   用

 傳回一個節點清單,包含該節點所有可用的子節點。

 基本語法

 objNodeList=node.childNodes;

說   明

 傳回一個物件。假如這節點沒有子節點,傳回null。

范   例

objNodeList = xmlDoc.childNodes;
alert(objNodeList);

doctype 屬性

 作   用

 傳回文件型態節點,包含目前文件的DTD。這節點是一般的文件型態宣告,例如,節點,名為EMAIL 的節點物件會被傳回。

 基本語法

 objDocType=xmlDocument.doctype;

說   明

 傳回一個對象,這個屬性是只讀的。假如這文件不包含DTD,會傳回null。

范   例

objDocType = xmlDoc.doctype;
alert(objDocType.nodeName);

documentElement 屬性

 作   用

 確認XML 文件的根(Root)節點。

 基本語法

 objDoc=xmlDocument.documentElement;

說   明

 回一個在單一根文件元素中包含數據的對象。此屬性可讀/寫,如果文件中不包含根節點,將傳回null。

范   例

objDocRoot = xmlDoc.documentElement;
alert(objDocRoot);

firstChild 屬性

 作   用

 確認在目前節點中的第一個子元素。

 基本語法

 objFirstChild = xmlDocNode.firstChild ;

說   明

 此屬性只讀且會傳回一對象,如果節點中沒有包含第一個子元素,將傳回null。

范   例

objFirstChild = xmlDoc.documentElement.firstChild;
alert(objFirstChild);

implementation 屬性

 作   用

 DOM 應用程序能使用其它實作中的對象。implementation 屬性確認目前XML 文件的DOMimplementation 對象。

 基本語法

 objImplementation = xmlDocument.implementation;

說   明

 此屬性只讀且傳回一個對象。

范   例

objImp = xmlDoc.implementation;
alert(objImp);

lastChild 屬性

 作   用

 確認目前節點中最後的子元素。

 基本語法

 objLastChild = xmlDocNode.lastChild;

說   明

 此屬性只讀且傳回一個對象。如果節點中沒有包含最後子元素,將傳回null。

范   例

objLastChild = xmlDoc.documentElement.lastChild;
alert(objLastChild);

nextSibling 屬性

 作   用

 在目前文件節點的子節點列表中傳回下一個兄弟節點。

 基本語法

 objNextSibling = xmlDocNode.nextSibling;

說   明

 此屬性是只讀且傳回一個對象。如果節點中沒有包含其它的相關節點,會傳回null。

范   例

objSibling = xmlDoc.documentElement.childNodes.item(1) .nextSibling;
alert(objSibling);

nodeName 屬性

 作   用

 傳回代表目前節點名稱的字符串。

 基本語法

 strNodeName = xmlDocNode.nodeName ;

說   明

 傳回一個字符串。這個屬性是只讀的,傳回元素名稱、屬性或實體參照。

范   例

strNodeName = xmlDoc.documentElement.nodeName;
alert(strNodeName);

nodeType 屬性

 作   用

 辨識節點的DOM 型態。

 基本語法

 numNodeType = xmlDocNode.nodeType ;

說   明


此屬性只讀且傳回一個數值。

有效的數值符合以下的型別:
1-ELEMENT
2-ATTRIBUTE
3-TEXT
4-CDATA
5-ENTITY REFERENCE
6-ENTITY
7-PI (processing instruction)
8-COMMENT
9-DOCUMENT
10-DOCUMENT TYPE
11-DOCUMENT FRAGMENT
12-NOTATION
 

范   例

numNodeType = xmlDoc.documentElement.nodeType;
alert(numNodeType);

nodeValue 屬性

 作   用

 傳回指定節點相關的文字。這並非一個元素中數據的值,而是與一個節點相關且未解析的文字,就像一個屬性或者一個處理指令。

 基本語法

 varNodeValue = xmlDocNode.nodeValue;

說   明

 傳回的文字代表以節點的nodeType 屬性為主的型態值。(請參考附錄中的nodeType 屬性。)因為節點型態可能是幾種數據型態中的一種,傳回值也因此有差異。傳回null 的節點型態有:DOCUMENT、ELEMENT、DOCUMENT TYPE、DOCUMENT FRAGMENT、ENTITY、ENTITY REFERENCE,和NOTATION。此屬性可擦寫。

范   例

varNodeValue = xmlDoc.documentElement.nodeValue;
alert(varNodeValue);

ondataavailable 屬性

 作   用

 指定一個事件來處理ondataavailable 事件。

 基本語法

 xmlDocNode.ondataavailable = value;

說   明

 此屬性是唯寫,允許文件作者一旦數據為可用,即可盡快的使用數據來運作。

范   例

xmlDoc.ondataavailable = alert("Data is now available.");

onreadystatechange 屬性

 作   用

 指定一個事件來處理onreadystatechange 事件。這個事件能辨識readyState 屬性的改變。

 基本語法

 xmlDocNode.onreadystatechange = value;

說   明

 此屬性是唯寫的,允許文件作者指定當readyState 屬性改變時呼叫事件。

范   例

xmlDoc.onreadystatechange =
alert("The readyState property has changed.");

ownerDocument 屬性

 作   用

 傳回文件的根節點,包含目前節點。

 基本語法

 objOwnerDoc = xmlDocument.ownerDocument;

說   明

 此屬性是只讀的,傳回一個包含文件根節點的對象,包含特定的節點。

范   例

objOwnerDoc = xmlDoc.childNodes.item(2).ownerDocument;
alert(objOwnerDoc);

parentNode 屬性

 作   用

 傳回目前節點的父節點。只能應用在有父節點的節點中。

 基本語法

 objParentNode = xmlDocumentNode.parentNode;

說   明

 此屬性是只讀的,傳回包含指定節點的父節點對象。如果此節點不存在於文件樹中,將傳回null。

范   例

objParentNode = xmlDoc.childNodes.item(1).parentNode;
alert(objParentNode);

parseError 屬性

 作   用

 傳回一個DOM 解析錯誤對象,此對像描述最後解析錯誤的訊息。

 基本語法

 objParseErr = xmlDocument.parseError;

說   明

 此屬性是只讀的。如果沒有錯誤發生,將傳回0。

范   例

objParseErr = xmlDoc.parseError;
alert(objParseErr);

previousSibling 屬性

 作   用

 傳回目前節點之前的兄弟節點。

 基本語法

 objPrevSibling = xmlDocument.previousSibling;

說   明

 傳回一個對象,這個屬性是只讀的。若該節點沒有包含前面的兄弟節點,會傳回null。

范   例

objPrevSibling =
xmlDoc.documentElement.childNodes.item(3).previousSibling
alert(objPrevSibling);

readyState 屬性

 作   用

 傳回XML 文件資料的目前狀況。

 基本語法

 intState = xmlDocument.readyState;

說   明


 這個屬性是只讀的,傳回值有以下的可能:

0-UNINITIALIZED:XML 對像被產生,但沒有任何文件被加載。
1-LOADING:加載程序進行中,但文件尚未開始解析。
2-LOADED:部分的文件已經加載且進行解析,但對像模型尚未生效。
3-INTERACTIVE:僅對已加載的部分文件有效,在此情況下,對像模型是有效但只讀的。
4-COMPLETED:文件已完全加載,代表加載成功。
 

范   例

alert("The readyState property is " + xmlDoc.readyState);

url 屬性

 作   用

 傳回最近一次加載XML 文件的URL。

 基本語法

 strDocUrl = xmlDocument.url;

說   明

 這個屬性是只讀的,傳回最近一次加載成功文件的URL,若文件僅存在主存儲器中(表示該文件並非由外部檔案加載),則傳回null。

范   例

alert(xmlDoc.url);

validateOnParse 屬性

 作   用

 告訴解析器文件是否有效。

 基本語法

 boolValidate = xmlDocument.validateOnParse;
 xmlDocument.validateOnParse = boolValidate;

說   明

 此屬性是可擦寫的。如果傳回值為true,表示文件被解析時被確認是有效的。如果傳回false,表示文件是無效的,並被認為只是標準格式的(well-formed)文件。

范   例

xmlDoc.validateOnParse = true;
alert(xmlDoc.validateOnParse);

xml 屬性

 作   用

 傳回指定節點的XML 描述和所有的子節點。

 基本語法

 xmlValue = xmlDocumentNode.xml;

說   明

 此屬性是只讀的。

范   例

xmlValue = xmlDoc.documentElement.xml;
alert(xmlValue);

posted @ 2008-05-01 20:11  Athrun  阅读(322)  评论(0编辑  收藏  举报