萬盛學電腦網

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

jQuery $.each() 完全指南:遍歷數組、對象、DOM、JSON 的最佳實踐

兩個 each 的區別

方法用途回調參數返回值
$.each(collection, callback)遍歷任意集合(數組/對象/類數組)(index, value),this === value原集合(鏈式調用無意義)
$(selector).each(callback)遍歷 jQuery 對象(DOM 元素集合)(index, element),this === elementjQuery 對象(可鏈式)

遍歷一維數組

var arr = ['aaa', 'bbb', 'ccc'];
$.each(arr, function(i, val) {
  console.log(i, val); // 0 aaa, 1 bbb, 2 ccc
  // this === val (基本類型會被包裝為對象)
});

遍歷二維/多維數組

var matrix = [['a','aa','aaa'], ['b','bb','bbb'], ['c','cc','ccc']];

// 只遍歷第一層
$.each(matrix, function(i, row) {
  console.log(i, row); // 0 ['a','aa','aaa'] ...
});

// 遞歸遍歷所有層
function deepEach(arr, fn, depth) {
  depth = depth || 0;
  $.each(arr, function(i, val) {
    if ($.isArray(val)) deepEach(val, fn, depth+1);
    else fn.call(val, i, val, depth);
  });
}
deepEach(matrix, function(i, val, d) {
  console.log('  '.repeat(d) + i + ': ' + val);
});

遍歷 JSON 對象

var obj = { one: 1, two: 2, three: 3 };
$.each(obj, function(key, val) {
  console.log(key, val); // one 1, two 2, three 3
  // this === val
  // key 是字符串屬性名,非數字索引
});

對象屬性無序(ES2015+ 保持插入序),故無數字索引。

遍歷 DOM 元素

<input type="hidden" name="a" value="1">
<input type="hidden" name="b" value="2">

$.each($('input:hidden'), function(i, el) {
  console.log(i, el.name, el.value); // 0 a 1, 1 b 2
  // el 是原生 DOM,this === el
  // $(this).val() 等同 el.value
});

// 等價寫法(返回 jQuery 對象可鏈式)
$('input:hidden').each(function(i, el) { /* ... */ });

源碼級解析:$.each 內部實現精簡版

function each(obj, callback, args) {
  var isArray = obj.length !== undefined; // 類數組判斷
  var i = 0, len = obj.length;

  if (args) { // 內部用,傳額外參數給 callback
    if (isArray) { for (; i < len; i++) if (callback.apply(obj[i], args) === false) break; }
    else { for (var k in obj) if (callback.apply(obj[k], args) === false) break; }
  } else {
    if (isArray) {
      for (var val = obj[0]; i < len && callback.call(val, i, val) !== false; val = obj[++i]) {}
    } else {
      for (var k in obj) if (callback.call(obj[k], k, obj[k]) === false) break;
    }
  }
  return obj;
}

關鍵點:

  • callback.call(val, i, val) 綁定 this 為當前值
  • 返回 false 可中斷循環(類似 break)
  • 返回 true 可跳過本次(類似 continue)

常見陷阱與最佳實踐

  1. 不要在循環中修改原數組長度:如需刪除,倒序遍歷或收集索引後統一處理。
  2. 對象遍歷順序不穩定:ES2015+ 保持插入序,但建議不依賴順序。
  3. 性能敏感場景:原生 for/for...of/Array.prototype.forEach 更快,$.each 有函數調用開銷。
  4. 中斷循環:return false(break),return true(continue)。

ES6+ 現代替代方案

// 數組
arr.forEach((val, i) => { /* ... */ });
for (const [i, val] of arr.entries()) { /* ... */ }

// 對象
Object.entries(obj).forEach(([key, val]) => { /* ... */ });
for (const [key, val] of Object.entries(obj)) { /* ... */ }

// DOM NodeList
document.querySelectorAll('input').forEach((el, i) => { /* ... */ });
// 或 Array.from(nodes).forEach(...)

現代項目優先用原生方法,$.each 僅在需兼容舊環境或配合 jQuery 鏈式調用時使用。

copyright © 萬盛學電腦網 all rights reserved