操作 DOM 首先要獲取節點。現代 JavaScript 提供多種選擇器 API,各有適用場景。本文系統整理獲取方式、回傳類型、效能差異與最佳實務。
核心獲取方法比較
| 方法 | 選擇器類型 | 回傳類型 | 即時性 | 效能 | 適用場景 |
getElementById | ID 字串 | Element / null | 即時 | 最快 | 單一唯一元素 |
getElementsByClassName | 類名字串 | HTMLCollection | 即時 | 快 | 同類元素群組 |
getElementsByTagName | 標籤名 | HTMLCollection | 即時 | 快 | 特定標籤元素 |
getElementsByName | name 屬性 | NodeList | 即時 | 中 | 表單元素群組 |
querySelector | CSS 選擇器 | Element / null | 靜態 | 較慢 | 複雜選擇、單一元素 |
querySelectorAll | CSS 選擇器 | NodeList | 靜態 | 較慢 | 複雜選擇、多元素 |
即時 vs 靜態集合
<div id="container">
<span class="item">1</span>
<span class="item">2</span>
</div>
<script>
// HTMLCollection - 即時
const live = document.getElementsByClassName('item');
console.log(live.length); // 2
// 動態新增
const newSpan = document.createElement('span');
newSpan.className = 'item';
document.getElementById('container').appendChild(newSpan);
console.log(live.length); // 3 自動更新!
// NodeList - 靜態
const static = document.querySelectorAll('.item');
console.log(static.length); // 3 (查詢時刻的快照)
// 新增後 static.length 仍為 3
完整實作範例
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>DOM 節點獲取示範</title>
<style>
table, td { border: 1px solid #333; border-collapse: collapse; padding: 8px; }
.highlight { background: #ffff99; }
</style>
</head>
<body>
<h3>1. getElementById</h3>
<table id="dataTable">
<tr><td>Java</td><td>PHP</td></tr>
<tr><td>.NET</td><td>iOS</td></tr>
</table>
<h3>2. getElementsByName</h3>
<input type="text" name="username" value="user1">
<input type="text" name="username" value="user2">
<h3>3. getElementsByTagName</h3>
<div class="content">這是 div 內容</div>
<span>這是 span 區域</span>
<a href="#">這是超連結</a>
<button onclick="demoById()">ID 獲取並高亮表格</button>
<button onclick="demoByName()">Name 獲取並顯示值</button>
<button onclick="demoByTag()">Tag 獲取並列出內容</button>
<button onclick="demoQuery()">querySelectorAll 示範</button>
<script>
// 1. ID 獲取
function demoById() {
const table = document.getElementById('dataTable');
table.classList.toggle('highlight');
}
// 2. Name 獲取
function demoByName() {
const inputs = document.getElementsByName('username');
console.log(`找到 ${inputs.length} 個 name="username" 元素`);
Array.from(inputs).forEach((input, i) => {
console.log(`[${i}] value: "${input.value}"`);
});
}
// 3. TagName 獲取
function demoByTag() {
const elements = document.getElementsByTagName('*'); // 所有元素
console.log(`頁面共有 ${elements.length} 個元素`);
// 只列出 body 直系子元素
const bodyChildren = document.body.children;
Array.from(bodyChildren).forEach((el, i) => {
console.log(`[${i}] <${el.tagName.toLowerCase()}> ${el.textContent?.slice(0,30)}`);
});
}
// 4. querySelector 系列
function demoQuery() {
// 複雜選擇器
const firstInput = document.querySelector('input[name="username"]');
console.log('第一個 username:', firstInput?.value);
// 所有輸入框
const allInputs = document.querySelectorAll('input[type="text"]');
console.log(`文字輸入框共 ${allInputs.length} 個`);
// 後代選擇器
const tableCells = document.querySelectorAll('#dataTable td');
console.log(`表格儲存格: ${tableCells.length} 個`);
}
</script>
</body>
</html>
現代最佳實務
1. 優先使用 querySelector / querySelectorAll
- 語法統一(CSS 選擇器)
- 支援複雜選擇:
'.class[data-attr] > :nth-child(odd)'
- 回傳靜態 NodeList,可安全迭代、使用
forEach
2. 效能關鍵路徑用 getElementById
// 高頻呼叫、單一元素
const cache = {};
function getElement(id) {
return cache[id] || (cache[id] = document.getElementById(id));
}
3. 陣列化 NodeList / HTMLCollection
// ES6 展開運算子
const arr = [...document.querySelectorAll('.item')];
// Array.from
const arr2 = Array.from(document.getElementsByClassName('item'));
// 老舊環境
const arr3 = Array.prototype.slice.call(document.getElementsByTagName('div'));
4. 最近祖先/後代查找
// 從特定元素向下查找
const container = document.getElementById('container');
const items = container.querySelectorAll('.item'); // 僅在 container 內
// 最近祖先(ES2015+)
const closestForm = inputElement.closest('form');
常見錯誤
| 錯誤代碼 | 問題 | 修正 |
document.getElementByClassName | 方法名錯誤(複數 Elements) | getElementsByClassName |
document.querySelectorAll('.class')[0].forEach | 單一 Element 無 forEach | 用 querySelector 或 [...nodes].forEach |
for (let i=0; i | 即時集合長度變化導致跳過元素 | 用 while(live[0]) live[0].remove() 或先陣列化 |
document.getElementsByName('x')[0].value | 無同名元素報錯 | 先檢查 length > 0 |
總結
- 單一 ID:
getElementById(最快)
- 複雜選擇/多元素:
querySelectorAll(語意清晰、靜態安全)
- 表單元素群組:
getElementsByName
- 需即時反映 DOM 變動:
getElementsBy* 系列
- 迭代前先陣列化:
[...nodes] 或 Array.from()