節點型別常數
| 介面 | 常數 | 值 | 說明 |
| Element | Node.ELEMENT_NODE | 1 | 元素節點 <div> |
| Text | Node.TEXT_NODE | 3 | 文字節點 |
| Document | Node.DOCUMENT_NODE | 9 | 文件根節點 |
| Comment | Node.COMMENT_NODE | 8 | 註解 <!-- --> |
| DocumentFragment | Node.DOCUMENT_FRAGMENT_NODE | 11 | 文件片段 |
| Attr | Node.ATTRIBUTE_NODE | 2 | 屬性節點(已較少直接操作) |
建立節點
document.createElement('div') // 元素
document.createTextNode('文字內容') // 文字
document.createComment('註解') // 註解
document.createDocumentFragment() // 文件片段(批次掛載用)
document.createAttribute('data-id') // 屬性(較少用,慣用 el.setAttribute)
查詢節點
| 方法 | 回傳 | 說明 |
document.getElementById(id) | Element | null | 唯一 ID,最快 |
element.getElementsByTagName(tag) | HTMLCollection (即時) | 標籤名,含子孫 |
element.getElementsByClassName(cls) | HTMLCollection (即時) | 類別名 |
document.querySelector(sel) | Element | null | CSS 選擇器,首個匹配 |
document.querySelectorAll(sel) | NodeList (靜態) | CSS 選擇器,所有匹配 |
element.closest(sel) | Element | null | 向上尋找最近祖先(含自己) |
element.matches(sel) | boolean | 自身是否匹配選擇器 |
節點屬性速查
| 屬性 | 說明 |
nodeType | 節點型別數值(見上表) |
nodeName | 標籤名(大寫)或 '#text'、'#comment' |
nodeValue | 文字/註解節點的內容 |
textContent | 所有後代文字內容(含隱藏元素) |
innerText | 可見文字(受 CSS 影響,較慢) |
parentNode | 父節點 |
parentElement | 父元素(若父是 Document 則 null) |
childNodes | 所有子節點(含文字、註解) |
children | 僅元素子節點(HTMLCollection) |
firstChild / lastChild | 第一/最後子節點(含文字) |
firstElementChild / lastElementChild | 第一/最後元素子節點 |
nextSibling / previousSibling | 下/上一個兄弟節點(含文字) |
nextElementSibling / previousElementSibling | 下/上一個兄弟元素 |
attributes | 屬性集合(NamedNodeMap) |
修改樹狀結構
// 新增
parent.appendChild(child) // 末尾
parent.insertBefore(new, reference) // 插在 reference 前
parent.prepend(...nodes) // 開頭(現代,支援多節點/字串)
parent.append(...nodes) // 末尾(現代)
// 移除
parent.removeChild(child) // 傳統
child.remove() // 現代(ChildNode 方法)
// 取代
parent.replaceChild(new, old) // 傳統
old.replaceWith(...nodes) // 現代
// 複製
const clone = node.cloneNode(true) // true = 深層複製含子孫
DocumentFragment 批次掛載(效能關鍵)
const fragment = document.createDocumentFragment();
for (let i = 0; i < 1000; i++) {
const li = document.createElement('li');
li.textContent = `項目 ${i}`;
fragment.appendChild(li);
}
document.getElementById('list').appendChild(fragment); // 僅觸發一次重排
實用工具函式
// 判斷是否為元素節點
const isElement = node => node.nodeType === Node.ELEMENT_NODE;
// 取得元素相對文件的座標
function getOffset(el) {
const rect = el.getBoundingClientRect();
return {top: rect.top + window.scrollY, left: rect.left + window.scrollX};
}
// 事件代理輔助:判斷目標是否匹配選擇器
function delegate(parent, selector, handler) {
parent.addEventListener('click', e => {
const target = e.target.closest(selector);
if (target && parent.contains(target)) handler.call(target, e);
});
}
現代 vs 傳統 API 對照
| 傳統 | 現代(推薦) | 備註 |
getElementsByTagName | querySelectorAll | 靜態 NodeList 可安全迭代 |
childNodes | children | 通常只需元素節點 |
nodeValue | textContent | 更語意化 |
appendChild | append/prepend | 支援多參數、字串自動建文字節點 |
insertBefore | before/after | 更直觀 |
removeChild | remove() | 直接在節點上呼叫 |