萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript DOM 節點獲取方式完整指南

操作 DOM 首先要獲取節點。現代 JavaScript 提供多種選擇器 API,各有適用場景。本文系統整理獲取方式、回傳類型、效能差異與最佳實務。

核心獲取方法比較

方法選擇器類型回傳類型即時性效能適用場景
getElementByIdID 字串Element / null即時最快單一唯一元素
getElementsByClassName類名字串HTMLCollection即時快同類元素群組
getElementsByTagName標籤名HTMLCollection即時快特定標籤元素
getElementsByNamename 屬性NodeList即時中表單元素群組
querySelectorCSS 選擇器Element / null靜態較慢複雜選擇、單一元素
querySelectorAllCSS 選擇器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()
copyright © 萬盛學電腦網 all rights reserved