萬盛學電腦網

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

jQuery 開發必知的 15 個實戰技巧與避坑指南

前言

jQuery 雖然不再是新專案首選,但大量存量專案仍在使用。本文總結實戰中高頻踩坑點與最佳實踐,助你寫出更健壯、可維護的 jQuery 代碼。

一、AJAX 篇

1. data 參數:物件字面量優於字串

// ❌ 易出錯:值含 & 會被誤判為參數分隔
$.ajax({ data: 'name=John&Doe&location=Taipei' });

// ✅ 推薦:物件格式,jQuery 自動編碼,無特殊字元困擾
$.ajax({ data: { name: 'John&Doe', location: 'Taipei' } });

2. async: false 慎用(同步阻塞)

  • 必須等待結果(如登入驗證、權限檢查)才設 false。
  • 其他情況一律 true(預設),否則頁面會「假死」,用戶無法操作。
  • 現代開發請改用 async/await + fetch 或 axios。

3. dataType 必須顯式聲明

$.ajax({
  dataType: 'json', // 強制解析為 JSON,否則可能當作 text/html 處理
  success: function(res) { /* res 直接是物件 */ }
});

曾因漏寫導致返回整個 HTML 頁面,res.code 為 undefined,排查耗時良久。

4. 統一錯誤處理

$.ajaxSetup({
  error: function(xhr, status, err) {
    console.error('AJAX 錯誤:', status, err);
    // 統一提示、上報、跳轉登入等
  }
});

二、選擇器與 DOM 操作篇

5. 選擇器永遠返回類陣列,不拋錯

$('#not-exist').css('color', 'red'); // 不報錯,但無效果
// 判斷是否存在
if ($('#btn').length) { /* 存在 */ }

6. 同 ID/Name 多元素:用相對查找

// 購物車列表:每行有相同 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);
});

7. 無 ID 元素遍歷取值

$('#list li').each(function() {
  var text = $(this).text();
  if (mySet.has(text)) $(this).addClass('highlight');
});

8. 事件委派取代大量綁定

// ❌ 綁定 100 個按鈕
$('.btn').click(handler);

// ✅ 委派給父容器
$('#container').on('click', '.btn', handler);

三、性能與記憶體篇

9. 緩存 jQuery 物件

// ❌ 反覆查找
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(); }

10. 批量 DOM 操作用 detach / DocumentFragment

var $ul = $('#list').detach(); // 脫離文檔流
for (var i=0; i<1000; i++) { $ul.append('
  • '+i+'
  • '); } $('#container').append($ul); // 一次重掛

    11. 避免在迴圈中重複訪問屬性

    // ❌ 每次迴圈都訪問 .length (DOM 屬性訪問較慢)
    for (var i=0; i<$items.length; i++) { ... }
    
    // ✅ 緩存長度
    var len = $items.length;
    for (var i=0; i

    四、常用工具方法

    12. $.proxy / 箭頭函數固定 this

    var obj = { name: 'A', show: function() { console.log(this.name); } };
    $('#btn').click($.proxy(obj.show, obj)); // 或用箭頭函數

    13. $.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 } }

    14. .data() 存取數據而非屬性

    $('#el').data('user', { id: 1, role: 'admin' }); // 物件存儲,不序列化
    var user = $('#el').data('user');

    15. 鏈式調用與 .end() 回溯

    $('#ul')
      .find('li.active')
        .addClass('highlight')
      .end() // 回到 #ul
      .find('li:first')
        .addClass('first');

    總結

    jQuery 的精髓在於「寫得少,做得多」,但濫用會導致性能與維護問題。牢記:緩存選擇器、事件委派、顯式 dataType、慎用同步 AJAX、善用工具方法,即可駕輕就熟。

    copyright © 萬盛學電腦網 all rights reserved