萬盛學電腦網

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

JavaScript 遍歷表單控件完整指南:原生 DOM API、jQuery、現代 ES6+ 寫法

遍歷目標與場景

  • 表單驗證:檢查所有必填欄位
  • 資料收集:序列化表單為 JSON/查詢字串
  • 狀態重置:清空、禁用/啟用、還原預設值
  • 動態操作:根據條件顯示/隱藏欄位

原生 DOM API 方案 (零依賴、效能最佳)

1. 遍歷特定表單所有控制項元素

var form = document.forms['myForm']; // 或 document.getElementById('formId')
// form.elements 包含所有表單相關元素 (input, select, textarea, button, fieldset...)
for (var i = 0; i < form.elements.length; i++) {
    var el = form.elements[i];
    console.log(el.name, el.type, el.value, el.tagName);
}

// ES6 簡潔寫法
[...form.elements].forEach(function(el) {
    // 處理邏輯
});

2. 依類型過濾處理

// 停用所有按鈕、設定檔案輸入為唯讀
[...form.elements].forEach(function(el) {
    switch (el.type.toLowerCase()) {
        case 'button':
        case 'submit':
        case 'reset':
            el.disabled = true;
            break;
        case 'file':
            el.readOnly = true; // 注意:file input 唯讀行為瀏覽器差異大
            break;
    }
});

3. 取得所有文字類輸入框的值

var textInputs = document.querySelectorAll('input[type="text"], input[type="password"], input[type="email"], input[type="search"], input[type="url"], input[type="tel"], textarea');
var values = [];
textInputs.forEach(function(input) {
    values.push({ name: input.name, value: input.value, id: input.id });
});
console.log(values);

4. 遞迴遍歷任意容器下所有元素 (通用)

/**
 * 遞迴遍歷節點樹
 * @param {Node} node - 起始節點
 * @param {Function} callback - 處理函數 callback(node, depth)
 */
function traverseDOM(node, callback, depth) {
    depth = depth || 0;
    callback(node, depth);
    node = node.firstChild;
    while (node) {
        traverseDOM(node, callback, depth + 1);
        node = node.nextSibling;
    }
}

// 使用:列印所有元素標籤名
traverseDOM(document.body, function(node, depth) {
    if (node.nodeType === Node.ELEMENT_NODE) {
        console.log(new Array(depth + 1).join('  ') + '<' + node.tagName.toLowerCase() + '>');
    }
});

jQuery 方案 (舊專案維護)

// 1. 表單元素遍歷
$('#myForm :input').each(function() {
    var $this = $(this);
    console.log($this.attr('name'), $this.attr('type'), $this.val());
});

// 2. 特定類型
$('#myForm input[type="text"]').each(function() { ... });

// 3. 序列化表單 (最常用)
var formData = $('#myForm').serialize();        // 查詢字串: name=value&age=20
var formArray = $('#myForm').serializeArray();  // 陣列: [{name:'name', value:'value'}, ...]
var formObject = $('#myForm').serializeObject(); // 需插件或自寫轉物件

// 4. 取值/設值
var val = $('input[name="username"]').val();
$('input[name="username"]').val('new value');

現代 ES6+ 最佳實踐

FormData API (標準、支援檔案、直接可送 fetch)

var form = document.getElementById('myForm');
var formData = new FormData(form); // 自動收集所有 name 屬性的元素

// 轉物件
var data = {};
for (var pair of formData.entries()) {
    // 處理同名多值 (如 checkbox 群組)
    if (data[pair[0]]) {
        if (!Array.isArray(data[pair[0]])) data[pair[0]] = [data[pair[0]]];
        data[pair[0]].push(pair[1]);
    } else {
        data[pair[0]] = pair[1];
    }
}

// 直接送出
fetch('/api/submit', { method: 'POST', body: formData });

表單元素陣列化 + reduce 收集

const form = document.getElementById('myForm');
const data = [...form.elements]
    .filter(el => el.name && !el.disabled && ['submit','reset','button','image'].indexOf(el.type) === -1)
    .reduce((acc, el) => {
        // checkbox/radio 未勾選不收集
        if (['checkbox','radio'].includes(el.type) && !el.checked) return acc;
        // select multiple
        if (el.tagName === 'SELECT' && el.multiple) {
            acc[el.name] = [...el.selectedOptions].map(o => o.value);
        } else {
            acc[el.name] = el.value;
        }
        return acc;
    }, {});

動態表單驗證範例

function validateForm(form) {
    const errors = [];
    [...form.elements].forEach(el => {
        if (!el.name || el.disabled) return;
        
        // required
        if (el.required && !el.value.trim()) {
            errors.push({ field: el.name, message: '必填' });
        }
        // pattern
        if (el.pattern && el.value) {
            const regex = new RegExp(el.pattern);
            if (!regex.test(el.value)) {
                errors.push({ field: el.name, message: '格式錯誤' });
            }
        }
        // type=email/number/url 瀏覽器原生驗證
        if (el.validity && !el.validity.valid) {
            errors.push({ field: el.name, message: el.validationMessage });
        }
    });
    return errors;
}

// 使用
form.addEventListener('submit', e => {
    const errors = validateForm(form);
    if (errors.length) {
        e.preventDefault();
        showErrors(errors);
    }
});

效能與記憶體注意事項

方法回傳類型即時性效能適用場景
form.elementsHTMLFormControlsCollection (即時)即時反映 DOM 變化極快 (原生)表單專用遍歷首選
querySelectorAllNodeList (靜態快照)不反映後續 DOM 變化快複雜選擇器、非表單元素
getElementsByTagName('*')HTMLCollection (即時)即時較慢 (全樹掃描)極舊瀏覽器降級
jQuery $(selector)jQuery Object (靜態)不即時較慢 (封裝層)舊專案、鏈式操作

總結

  • 表單專用:首選 form.elements + ES6 陣列方法 (forEach, filter, reduce)。
  • 資料收集:直接用 new FormData(form),標準、支援檔案、可直接 fetch。
  • 驗證:善用 HTML5 原生驗證屬性 (required, pattern, type) + validity API,減少手寫邏輯。
  • 通用遍歷:querySelectorAll 或 TreeWalker (大量節點時效能更佳)。
  • 避免:document.all、for...in 遍歷陣列、同步遍歷大量節點阻塞主執行緒。
copyright © 萬盛學電腦網 all rights reserved