jQuery 雖然不再是新專案首選,但大量存量專案仍在使用。本文總結實戰中高頻踩坑點與最佳實踐,助你寫出更健壯、可維護的 jQuery 代碼。
data 參數:物件字面量優於字串// ❌ 易出錯:值含 & 會被誤判為參數分隔
$.ajax({ data: 'name=John&Doe&location=Taipei' });
// ✅ 推薦:物件格式,jQuery 自動編碼,無特殊字元困擾
$.ajax({ data: { name: 'John&Doe', location: 'Taipei' } });
async: false 慎用(同步阻塞)false。true(預設),否則頁面會「假死」,用戶無法操作。async/await + fetch 或 axios。dataType 必須顯式聲明$.ajax({
dataType: 'json', // 強制解析為 JSON,否則可能當作 text/html 處理
success: function(res) { /* res 直接是物件 */ }
});
曾因漏寫導致返回整個 HTML 頁面,res.code 為 undefined,排查耗時良久。
$.ajaxSetup({
error: function(xhr, status, err) {
console.error('AJAX 錯誤:', status, err);
// 統一提示、上報、跳轉登入等
}
});
$('#not-exist').css('color', 'red'); // 不報錯,但無效果
// 判斷是否存在
if ($('#btn').length) { /* 存在 */ }
// 購物車列表:每行有相同 name="qty" 的輸入框
$('.cart-item .btn-update').click(function() {
var $row = $(this).closest('tr');
var qty = $row.find('input[name="qty"]').val();
var id = $row.data('id');
updateCart(id, qty);
});
$('#list li').each(function() {
var text = $(this).text();
if (mySet.has(text)) $(this).addClass('highlight');
});
// ❌ 綁定 100 個按鈕
$('.btn').click(handler);
// ✅ 委派給父容器
$('#container').on('click', '.btn', handler);
// ❌ 反覆查找
for (var i=0; i<100; i++) { $('.item').eq(i).hide(); }
// ✅ 緩存
var $items = $('.item');
for (var i=0; i<100; i++) { $items.eq(i).hide(); }
detach / DocumentFragmentvar $ul = $('#list').detach(); // 脫離文檔流
for (var i=0; i<1000; i++) { $ul.append(''+i+' '); }
$('#container').append($ul); // 一次重掛
// ❌ 每次迴圈都訪問 .length (DOM 屬性訪問較慢)
for (var i=0; i<$items.length; i++) { ... }
// ✅ 緩存長度
var len = $items.length;
for (var i=0; i
$.proxy / 箭頭函數固定 thisvar obj = { name: 'A', show: function() { console.log(this.name); } };
$('#btn').click($.proxy(obj.show, obj)); // 或用箭頭函數
$.extend 深拷貝合併配置var defaults = { a: 1, b: { x: 10 } };
var options = { b: { y: 20 } };
var settings = $.extend(true, {}, defaults, options); // true = deep
// { a:1, b:{ x:10, y:20 } }
.data() 存取數據而非屬性$('#el').data('user', { id: 1, role: 'admin' }); // 物件存儲,不序列化
var user = $('#el').data('user');
.end() 回溯$('#ul')
.find('li.active')
.addClass('highlight')
.end() // 回到 #ul
.find('li:first')
.addClass('first');
jQuery 的精髓在於「寫得少,做得多」,但濫用會導致性能與維護問題。牢記:緩存選擇器、事件委派、顯式 dataType、慎用同步 AJAX、善用工具方法,即可駕輕就熟。