jQuery 以簡潔的 API 封裝了繁瑣的 DOM 操作,但方法眾多、參數變化大,開發者常需查閱文件。本文系統整理 jQuery 最常用的取值/賦值模式,涵蓋表單元素、屬性操作、CSS 樣式、DOM 遍歷、元素維護、AJAX 請求與實用工具方法,作為開發隨身速查手冊。
| 元素類型 | 取值 | 賦值/設定 | 備註 |
|---|---|---|---|
文字輸入框<input type="text"><textarea> | $('#id').val() | $('#id').val('新內容') | 推薦用 .val(),而非 .attr('value') |
單選按鈕<input type="radio"> | $('input[name="sex"]:checked').val() | $('input[name="sex"][value="male"]').prop('checked', true) | 用 :checked 過濾,prop 設定布林屬性 |
複選框<input type="checkbox"> | $('#id').is(':checked') (布林)$('#id').val() (值) | $('#id').prop('checked', true/false) | 多選框取值常用 .map() 陣列化 |
下拉選單<select> | $('#id').val() (取 value)$('#id option:selected').text() (取顯示文字) | $('#id').val('targetValue') | 多選 select 回傳陣列 |
// 清空輸入框
$('#text').val('');
// 批量新增 option
$('').appendTo('#select');
// 清空下拉選單
$('#select').empty();
// 設定 select 選中索引(原生 DOM)
$('#select')[0].selectedIndex = 1; // 第二項
// 設定 radio 選中索引
$('input[name="items"]').get(1).checked = true; // 第二項
// 重置整個表單
$('form')[0].reset(); // 原生 reset() 最快
// 或
$('form').trigger('reset'); // jQuery 觸發事件
// ID 選取(最快)
$('#myid') // 等同 document.getElementById('myid')
$('#myid')[0] // 轉為原生 DOM 元素
// 標籤選取
$('img') // 所有圖片
// Class 選取
$('div.TextBox') // class="TextBox" 的 div
// 屬性選取
$('div[myattr]') // 有 myattr 屬性
$('div[myattr="myclass"]') // 屬性值等於
$('div[myattr!="myclass"]') // 屬性值不等於
$('div[myattr^="my"]') // 以 my 開頭
$('div[myattr$="class"]') // 以 class 結尾
$('div[myattr*="cla"]') // 包含 cla
// 遍歷處理
$('div').each(function () {
$(this).css('background-color', '#F00');
alert($(this).html());
$(this).width('200px');
});
// 頁面載入完成(DOMReady)
$(function () { ... }); // 等同 $(document).ready()
// 可綁定多個 ready handler,依序執行
// 特定事件
$('#myid').on('keydown', function () { ... }); // 推薦 .on()
// 不常用事件需用 .on() 或 .bind() (jQuery 3.0+ 棄用 .bind())
$('#myid').on('custom-event', handler);
| 操作 | 方法 | 說明 |
|---|---|---|
| 高度/寬度 | .height() / .width() | 不帶參數取值,帶參數設定(數字視為 px) |
| 位置 | .offset() | 回傳 {top, left} 相對文件;唯讀 |
| HTML 內容 | .html() | 取/設 innerHTML |
| 純文字內容 | .text() | 取/設 innerText(自動編碼 HTML 實體) |
| 表單值 | .val() | 統一處理 input/select/textarea |
| 屬性值 | .attr('name') | 取 HTML 屬性;設定用 .attr('name', 'val') |
| 屬性物件 | .attr({k:v, k2:v2}) | 批量設定 |
| 移除屬性 | .removeAttr('disabled') |
// 單一樣式(CSS 命名法:kebab-case)
$('#id').css('background-color', '#FF0000');
// 多重樣式(JS 命名法:camelCase)
$('#id').css({
backgroundColor: '#FF0000',
width: '100px',
height: '20px'
});
// 切換 class(推薦:關注點分離)
$('#id').addClass('myclass');
$('#id').removeClass('myclass');
$('#id').toggleClass('myclass', condition);
關鍵差異:.css('background-color') 用 CSS 命名;.css({backgroundColor}) 用 JS 命名,切勿混淆。
| 關係 | 方法 | 說明 |
|---|---|---|
| 下一個同級 | .next() | 單一元素 |
| 所有下方同級 | .nextAll() | 集合 |
| 上一個同級 | .prev() | |
| 所有上方同級 | .prevAll() | |
| 直系子元素 | .children() | 不含孫代 |
| 父元素 | .parent() | 單一 |
| 所有祖先 | .parents() | 含 document |
| 祖先篩選 | .parents('div.l2') | 只取符合選擇器的祖先 |
// 在 body 結尾前插入
$('body').append('');
// 在 body 開頭後插入
$('body').prepend('');
// 移除自身
$('#id').remove();
// 清空子元素
$('#id').empty();
// 複製元素
var $clone = $('#id').clone(true); // true = 複製事件綁定
// 替換元素
$('#old').replaceWith('新內容');
// GET 請求
$.get('url', { param: 'value' }, function (data, status) {
// data: 回傳資料, status: 'success'/'error'...
});
// POST 請求
$.post('url', { key: 'val' }, callback);
// 通用 AJAX(完整控制)
$.ajax({
url: 'api/users',
type: 'POST',
dataType: 'json',
data: JSON.stringify({ name: 'John' }),
contentType: 'application/json',
success: function (res) { ... },
error: function (xhr, status, err) { ... }
});
$.trim(str) // 去除首尾空白
$.browser // 已棄用(jQuery 1.9+),請用特性檢測或 navigator.userAgent
$.browser.version // 同上
$.param(obj) // 物件序列化為查詢字串
$.extend(target, obj1) // 合併物件(深拷貝用 $.extend(true, target, obj1))
$.each(arr, fn) // 通用遍歷
$.map(arr, fn) // 映射轉換
$.grep(arr, fn) // 過濾
$.inArray(val, arr) // 索引查找
$.makeArray(obj) // 類陣列轉陣列
$.proxy(fn, context) // 綁定 this 上下文
$.now() // Date.now() 簡寫
$.support // 特性檢測物件
官方插件庫:plugins.jquery.com(已歸檔,現多託管於 npm/GitHub)。常用類別:
$(parent).on('event', 'selector', handler)。$el.css(...).addClass(...).show() 減少重複選取。將本文加入書籤,下次遇到「這個值怎麼取?那個屬性怎麼設?」秒速找到答案!