萬盛學電腦網

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

JavaScript 遍歷同名表單元素並驗證非空的標準寫法

場景

動態生成的表單中存在多個同名 ``,需提交前驗證每項是否為空。

原生 JS 標準寫法

function validateSpecNames() {
  var items = document.getElementsByName('spec_spec_1[]');
  // getElementsByName 返回即時 HTMLCollection,轉數組避免動態修改時索引錯亂
  var arr = Array.prototype.slice.call(items);

  for (var i = 0; i < arr.length; i++) {
    var input = arr[i];
    // trim 去除首尾空白
    if (input.value.trim() === '') {
      alert('第 ' + (i + 1) + ' 項規格名稱不能為空');
      input.focus(); // 聚焦首個錯誤項
      return false;
    }
  }
  return true;
}

// 表單提交攔截
document.getElementById('myForm').addEventListener('submit', function (e) {
  if (!validateSpecNames()) {
    e.preventDefault();
  }
});

jQuery 簡潔寫法

function validateSpecNames() {
  var valid = true;
  $('input[name="spec_spec_1[]"]').each(function (i, el) {
    if ($.trim(el.value) === '') {
      alert('第 ' + (i + 1) + ' 項規格名稱不能為空');
      $(el).focus();
      valid = false;
      return false; // 跳出 each 循環
    }
  });
  return valid;
}

現代 ES6+ 寫法(推薦)

const validateSpecNames = () => {
  const inputs = [...document.getElementsByName('spec_spec_1[]')];
  const emptyIndex = inputs.findIndex(input => input.value.trim() === '');
  
  if (emptyIndex !== -1) {
    alert(`第 ${emptyIndex + 1} 項規格名稱不能為空`);
    inputs[emptyIndex].focus();
    return false;
  }
  return true;
};

進階:收集所有錯誤一次性提示

function collectErrors() {
  var items = document.getElementsByName('spec_spec_1[]');
  var errors = [];
  
  for (var i = 0; i < items.length; i++) {
    if (items[i].value.trim() === '') {
      errors.push('第 ' + (i + 1) + ' 項為空');
    }
  }
  
  if (errors.length) {
    alert('發現 ' + errors.length + ' 個錯誤:\n' + errors.join('\n'));
    // 可選:高亮所有錯誤項
    for (var i = 0; i < items.length; i++) {
      if (items[i].value.trim() === '') {
        items[i].classList.add('error');
      }
    }
    return false;
  }
  return true;
}

關鍵知識點

  1. getElementsByName 返回即時集合:動態增減 input 時集合自動更新,循環中修改 DOM 需轉數組或逆序遍歷
  2. .trim() 必不可少:用戶輸入空格視為空,需去除首尾空白
  3. 聚焦首個錯誤:提升 UX,讓用戶直接修正
  4. 名稱帶 [] 的表單字段:PHP/Java 後端自動解析為數組,前端 name 屬性保持一致

擴展:通用表單驗證工具函數

var FormValidator = {
  // 驗證同名字段非空
  requiredEach: function (name, msgPrefix) {
    var items = document.getElementsByName(name);
    var errors = [];
    for (var i = 0; i < items.length; i++) {
      if (items[i].value.trim() === '') {
        errors.push((msgPrefix || '項') + (i + 1) + ' 不能為空');
        if (errors.length === 1) items[i].focus();
      }
    }
    return {
      valid: errors.length === 0,
      errors: errors,
      firstErrorEl: errors.length ? items[errors[0].match(/\d+/)[0] - 1] : null
    };
  },
  
  // 驗證正則
  patternEach: function (name, regex, msg) {
    var items = document.getElementsByName(name);
    for (var i = 0; i < items.length; i++) {
      if (!regex.test(items[i].value.trim())) {
        return { valid: false, message: msg, element: items[i] };
      }
    }
    return { valid: true };
  }
};

// 使用
var result = FormValidator.requiredEach('spec_spec_1[]', '規格');
if (!result.valid) {
  alert(result.errors.join('\n'));
}

總結

遍歷同名表單元素的核心是 document.getElementsByName(name) 獲取集合,配合循環驗證。現代代碼推薦展開運算符轉數組 [...collection] 配合 findIndex/every/some,語義清晰且避免即時集合陷阱。驗證邏輯應封裝為可復用工具,支持單錯誤阻斷與全量錯誤收集兩種模式,配合焦點管理提升用戶體驗。

copyright © 萬盛學電腦網 all rights reserved