Dojo學習筆記(7. dojo.dom)
模塊：dojo.dom
dojo.dom.isNode
測試指定對象是否為節點
Usage Example:
dojo.dom.isNode(dojo.byId('edtTitle'));
dojo.dom.getUniqueId
取得唯一id
Usage Example:
dojo.dom.getUniqueId(); //will return dj_unique_#
dojo.dom.firstElement = dojo.dom.getFirstChildElement
取得指定節點下的第一個滿足指定Tag條件的子節點
Usage Example:
dojo.dom.firstElement(parentNode, 'SPAN');
dojo.dom.lastElement = dojo.dom.getLastChildElement
取得指定節點下的最后一個滿足指定Tag條件的子節點
Usage Example:
dojo.dom.lastElement(parentNode, 'SPAN');
dojo.dom.nextElement = dojo.dom.getNextSiblingElement
取得指定節點的下一個滿足指定Tag條件的子節點
Usage Example:
dojo.dom.nextElement(node, 'SPAN');
dojo.dom.prevElement = dojo.dom.getPreviousSiblingElement
取得指定節點的前一個滿足指定Tag條件的子節點
Usage Example:
dojo.dom.prevElement(node, 'SPAN');
dojo.dom.moveChildren
把指定節點下的所有子節點移動到目標節點下，并返回移動的節點數
Usage Example:
dojo.dom.moveChildren(srcNode, destNode, true); //僅移動子節點，srcNode中的文字將被丟棄
dojo.dom.moveChildren(srcNode, destNode, false);//包括文字和子節點都將被移動到目標節點下
dojo.dom.copyChildren
把指定節點下的所有子節點復制到目標節點下，并返回復制的節點數
Usage Example:
dojo.dom.moveChildren(srcNode, destNode, true); //僅復制子節點，srcNode中的文字將被忽略
dojo.dom.moveChildren(srcNode, destNode, false);//包括文字和子節點都將被復制到目標節點下
dojo.dom.removeChildren
刪除指定節點下的所有子節點，并返回刪除的節點數
Usage Example:
dojo.dom.moveChildren(node);
dojo.dom.replaceChildren
用指定的新節點替換父節點下的所有子節點
Usage Example:
dojo.dom.replaceChildren(node, newChild); //目前還不支持newChild為數組形式
dojo.dom.removeNode
刪除指定的節點
Usage Example:
dojo.dom.removeNode(node);
dojo.dom.getAncestors
返回指定節點的父節點集合
Usage Example:
dojo.dom.getAncestors(node, null, false); //返回所有的父節點集合（包括指定的節點node）
dojo.dom.getAncestors(node, null, true); //返回最近的一個父節點
dojo.dom.getAncestors(node, function(el){/* 此處增加過濾條件 */return true}, false); //返回所有滿足條件的父節點集合
dojo.dom.getAncestorsByTag
返回所有符合指定Tag的指定節點的父節點集合
Usage Example:
dojo.dom.getAncestorsByTag(node, 'span', false); //返回所有的類型為SPAN的父節點集合
dojo.dom.getAncestorsByTag(node, 'span', true); //返回最近的一個類型為SPAN的父節點
dojo.dom.getFirstAncestorByTag
返回最近的一個符合指定Tag的指定節點的父節點
Usage Example:
dojo.dom.getFirstAncestorByTag(node, 'span'); //返回最近的一個類型為SPAN的父節點
dojo.dom.isDescendantOf
判斷指定的節點是否為另一個節點的子孫
Usage Example:
dojo.dom.isDescendantOf(node, ancestor, true); //判斷node是否為ancestor的子孫
dojo.dom.isDescendantOf(node, node, false); //will return true
dojo.dom.isDescendantOf(node, node, true); //will return false
dojo.dom.innerXML
返回指定節點的XML
Usage Example:
dojo.dom.innerXML(node);
dojo.dom.createDocument
創建一個空的文檔對象
Usage Example:
dojo.dom.createDocument();
dojo.dom.createDocumentFromText
根據文字創建一個文檔對象
Usage Example:
dojo.dom.createDocumentFromText('<?xml version="1.0" encoding="gb2312" ?><a>1</a>','text/xml');
dojo.dom.prependChild
將指定的節點插入到父節點的最前面
Usage Example:
dojo.dom.prependChild(node, parent);
dojo.dom.insertBefore
將指定的節點插入到參考節點的前面
Usage Example:
dojo.dom.insertBefore(node, ref, false); //如果滿足要求的話就直接退出
dojo.dom.insertBefore(node, ref, true);
dojo.dom.insertAfter
將指定的節點插入到參考節點的后面
Usage Example:
dojo.dom.insertAfter(node, ref, false); //如果滿足要求的話就直接退出
dojo.dom.insertAfter(node, ref, true);
dojo.dom.insertAtPosition
將指定的節點插入到參考節點的指定位置
Usage Example:
dojo.dom.insertAtPosition(node, ref, "before");//參考節點之前
dojo.dom.insertAtPosition(node, ref, "after"); //參考節點之后
dojo.dom.insertAtPosition(node, ref, "first"); //參考節點的第一個子節點
dojo.dom.insertAtPosition(node, ref, "last"); //參考節點的最后一個子節點
dojo.dom.insertAtPosition(node, ref); //默認位置為"last"
dojo.dom.insertAtIndex
將指定的節點插入到參考節點的子節點中的指定索引的位置
Usage Example:
dojo.dom.insertAtIndex(node, containingNode, 3); //把node插入到containingNode的子節點中，使其成為第3個子節點
dojo.dom.textContent
設置或獲取指定節點的文本
Usage Example:
dojo.dom.textContent(node, 'text'); //設置node的文本為'text'
dojo.dom.textContent(node); //返回node的文本
dojo.dom.hasParent
判斷指定節點是否有父節點
Usage Example:
dojo.dom.hasParent(node);
dojo.dom.isTag
判斷節點是否具有指定的tag
Usage Example:
var el = document.createElement("SPAN");
dojo.dom.isTag(el, "SPAN"); //will return "SPAN"
dojo.dom.isTag(el, "span"); //will return ""
dojo.dom.isTag(el, "INPUT", "SPAN", "IMG"); //will return "SPAN"