系統整理 jQuery 1.x/2.x/3.x 常用 API 分類速查,包含 DOM 屬性操作、節點操作、遍歷、核心工具、事件綁定,適合開發時快速查閱。
屬性操作 (Attributes)
| 方法 | 說明 | 範例 |
| addClass(className) | 添加 CSS 類別 | $('p').addClass('highlight') |
| attr(name, value) | 設定/取得屬性 | $('img').attr({src:'a.jpg', alt:'圖片'}) |
| removeAttr(name) | 移除屬性 | $('input').removeAttr('disabled') |
| removeClass(className) | 移除 CSS 類別 | $('div').removeClass('active') |
| toggleClass(className) | 切換類別 (有則移除、無則添加) | $('li').toggleClass('selected') |
| html() / html(val) | 取得/設定 innerHTML | $('div').html('<b>新內容</b>') |
| text() / text(val) | 取得/設定純文字 (自動轉義) | $('span').text('含<特殊字元>') |
| val() / val(value) | 取得/設定表單值 | $('input').val('預設值') |
節點操作 (Manipulation)
| 方法 | 說明 |
| after(content) | 在元素後插入 (同級) |
| append(content) | 在元素內容末尾插入 (子元素) |
| appendTo(target) | 將元素插入目標末尾 |
| before(content) | 在元素前插入 (同級) |
| clone(true/false) | 複製元素,true 含事件綁定 |
| empty() | 清空元素內容 |
| remove([selector]) | 移除元素 (含事件/資料),可選擇器過濾 |
| wrap(html/element) | 用結構包裹元素 |
| unwrap() | 移除父層包裹 |
遍歷
| 方法 | 說明 |
| children([selector]) | 直接子元素 |
| find(selector) | 後代元素 (含深層) |
| parent([selector]) | 直接父元素 |
| parents([selector]) | 所有祖先元素 |
| siblings([selector]) | 所有同輩元素 |
| next([selector]) | 下一個同輩 |
| prev([selector]) | 上一個同輩 |
| filter(selector) | 從當前集合篩選 |
| not(selector) | 排除符合選擇器 |
| is(selector) | 判斷是否符合,回傳布林 |
| end() | 回到上一個 jQuery 物件 (鏈式中斷點) |
核心
$(html):建立元素;$(selector, context):指定查找範圍。
$(fn) / $(document).ready(fn):DOM 就緒執行。
each(callback):遍歷 jQuery 物件,this 指向 DOM 元素,回傳 false 中斷。
jQuery.extend(obj):擴充靜態方法 (如 $.ajax)。
jQuery.fn.extend(obj):擴充實例方法 (如 .plugin())。
事件
| 方法 | 說明 |
| ready(fn) | DOM 就緒綁定 (可多次) |
| on(type, [selector], [data], fn) | 統一綁定 (支援代理) |
| off(type, [selector], fn) | 移除綁定 |
| one(type, [selector], [data], fn) | 只觸發一次 |
| trigger(type, [data]) | 手動觸發事件 |
| triggerHandler(type, [data]) | 觸發但不冒泡、不執行預設行為 |
常用事件類型
blur, focus, focusin, focusout, load, resize, scroll, unload,
click, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout,
mouseenter, mouseleave, change, select, submit,
keydown, keypress, keyup, error, contextmenu
事件對象常用屬性/方法
e.target:觸發元素;e.currentTarget:綁定元素 (同 this)。
e.preventDefault():阻止預設行為;e.stopPropagation():停止冒泡。
e.which:按鍵碼/滑鼠鍵 (統一跨瀏覽器);e.pageX/Y:頁面座標。
e.data:綁定時傳入的額外資料。