jQuery 是目前使用最廣泛的 JavaScript 函式庫。統計顯示,全球前一百萬名的網站中有 46% 採用 jQuery,比例遠高於其他函式庫,微軟甚至把它列為官方函式庫。

對網頁開發者而言,學會 jQuery 有其必要性:它讓你接觸業界最通用的技術,替日後學習更進階的函式庫打底,而且確實能輕鬆做出許多複雜效果。
但「上手容易、精通困難」是它的寫照。jQuery 橫跨網頁開發的各個環節,提供的方法與內部變化多達上千種,初學者常卡在「入門之後不知道往哪走」。
網路上公認最好的入門教材是 Rebecca Murphey 的《jQuery Fundamentals》,在搜尋引擎搜尋 jQuery 培訓時長期排第一,jQuery 官方團隊也已同意以其作為官方教程基礎。

這本書雖是入門書,仍有百餘頁。以下是我整理過的筆記,目標是理清設計脈絡,讓自己在遇到問題時心裡有底:知道該用哪個功能,然後能迅速從手冊查到確切寫法。只要有基本的 JavaScript 知識就能讀懂,並在最短時間內掌握 jQuery 的主要層面(Ajax 與外掛開發除外)。
原文網址:https://jqfundamentals.com/book/
jQuery 的基本設計與主要用法,就是「選某個網頁元素,然後對它做某種操作」。這是它與其他函式庫最根本的差異。
使用的第一步,是把選擇表示式放進建構函式 jQuery()(簡寫為 $),取得被選中的元素。
選擇表示式可以是 CSS 選擇器:
$(document) // 整個文件物件
$('#myId') // id 為 myId 的元素
$('div.myClass') // class 為 myClass 的 div
$('input[name=first]') // name 等於 first 的 input
也可以是 jQuery 特有的表示式:
$('a:first') // 第一個 a 元素
$('tr:odd') // 表格奇數列
$('#myForm :input') // 表單中的 input 元素
$('div:visible') // 可見的 div
$('div:gt(2)') // 除了前三個之外的所有 div
$('div:animated') // 正在執行動畫的 div
選到多個元素時,可用過濾器縮小範圍:
$('div').has('p'); // 含 p 的 div
$('div').not('.myClass'); // class 不為 myClass 的 div
$('div').filter('.myClass'); // class 為 myClass 的 div
$('div').first(); // 第一個 div
$('div').eq(5); // 第 6 個 div
需要往鄰近元素移動時,jQuery 提供 DOM 樹上的走訪方法:
$('div').next('p'); // div 之後的第一個 p
$('div').parent(); // 父元素
$('div').closest('form'); // 最近的 form 祖先
$('div').children(); // 所有子元素
$('div').siblings(); // 同層元素
選好元素後就可以操作,而 jQuery 允許把所有操作串成一條鏈:
$('div').find('h3').eq(2).html('Hello');
展開來看:
$('div') // 找到 div
.find('h3') // 選其中的 h3
.eq(2) // 選第 3 個 h3
.html('Hello'); // 把內容改成 Hello
這是最受好評的特性,原理在於每一步操作回傳的都是 jQuery 物件,因此可以串接下去。
另外 .end() 可以讓結果集退回上一步:
$('div')
.find('h3')
.eq(2)
.html('Hello')
.end() // 退回「選中所有 h3」那一步
.eq(0) // 選第一個 h3
.html('World'); // 內容改成 World
最常見的需求是取得元素的值或替它賦值。jQuery 用同一個函式處理兩件事,差別只在有沒有帶參數:
$('h1').html(); // 無參數 → 取值
$('h1').html('Hello'); // 有參數 → 賦值
常用配對:
.html() 取出或設定 HTML 內容
.text() 取出或設定文字內容
.attr() 取出或設定某個屬性
.width() 取出或設定寬度
.height() 取出或設定高度
.val() 取出表單元素的值
要注意的是:結果集含多個元素時,賦值會作用於全部,取值只取第一個。.text() 是例外,它會取出所有元素的文字內容。
移動選中的元素有兩種視角:直接搬這個元素,或搬其他元素來讓目標就位。以下把 div 移到 p 後面為例。
$('div').insertAfter('p'); // 搬 div,回傳 div
$('p').after('div'); // 搬 p,回傳 p
表面上效果相同,但回傳的元素不同,這會影響後續的鏈式操作,需依需要挑選。這組模式共四對:
.insertAfter() / .after() 在既有元素外部、後方插入
.insertBefore() / .before() 在既有元素外部、前方插入
.appendTo() / .append() 在既有元素內部、後方插入
.prependTo() / .prepend() 在既有元素內部、前方插入
複製用 .clone()。
刪除有 .remove() 與 .detach(),差別在於前者不保留被刪元素的事件綁定,後者保留,適合「先取下、處理完再放回」的情境。
只清空內容而保留元素本身用 .empty()。
建立新元素非常簡單,直接把 HTML 字串丟進建構函式:
$('<p>Hello</p>');
$('<li class="new">new list item</li>');
$('ul').append('<li>list item</li>');
除了針對選中元素的操作,jQuery 另提供一些不必選元素就能直接使用的工具方法。
若了解 JavaScript 的繼承原理就能理解其本質:工具方法定義在建構函式上(jQuery.method()),可直接呼叫;而操作元素的方法定義在 prototype 上(jQuery.prototype.method()),必須先有實例(即選中元素)才能用。若一時無法理解也無妨,把工具方法想成「像原生函式那樣可直接使用」即可。
$.trim() 去除字串兩端空格
$.each() 遍歷陣列或物件
$.inArray() 回傳某值在陣列中的索引,不存在則回傳 -1
$.grep() 篩出陣列中符合條件的元素
$.extend() 把多個物件合併到第一個物件
$.makeArray() 把物件轉為陣列
$.type() 判斷物件類別(函式、日期、陣列、正則等)
$.isArray() 是否為陣列
$.isEmptyObject() 是否為空物件(不含任何屬性)
$.isFunction() 是否為函式
$.isPlainObject() 是否為以 {} 或 new Object 建立的物件
$.support() 瀏覽器是否支援某項特性
可以為元素綁定事件,依事件類型執行對應函式:
$('p').click(function () {
alert('Hello');
});
常用事件:
.blur() 表單元素失去焦點
.change() 表單元素的值改變
.click() 滑鼠單擊
.dblclick() 滑鼠雙擊
.focus() 表單元素獲得焦點
.focusin() 子元素獲得焦點
.focusout() 子元素失去焦點
.hover() 同時為 mouseenter 與 mouseleave 指定處理函式
.keydown() 按下按鍵(長按只回傳一個事件)
.keypress() 按下按鍵(長按會回傳多個事件)
.keyup() 放開按鍵
.load() 元素載入完畢
.mousedown() 按下滑鼠
.mouseenter() 滑鼠進入(進入子元素不觸發)
.mouseleave() 滑鼠離開(離開子元素不觸發)
.mousemove() 滑鼠在元素內移動
.mouseout() 滑鼠離開(離開子元素也會觸發)
.mouseover() 滑鼠進入(進入子元素也會觸發)
.mouseup() 放開滑鼠
.ready() DOM 載入完成
.resize() 視窗尺寸改變
.scroll() 捲動條位置改變
.select() 使用者選取文字框內容
.submit() 使用者送出表單
.toggle() 依點擊次數輪流執行多個函式
.unload() 使用者離開頁面
這些在 jQuery 內部都是 .bind() 的便捷寫法。用 bind() 可以更靈活,例如一次為多個事件綁同一個函式:
$('input').bind(
'click change', // 同時綁定 click 與 change
function () { alert('Hello'); }
);
只想執行一次時用 .one():
$("p").one("click", function () {
alert("Hello"); // 只執行一次
});
解除綁定用 .unbind():
$('p').unbind('click');
所有事件處理函式都可接受一個事件物件作為參數:
$("p").click(function (e) {
alert(e.type); // "click"
});
這個物件常用的屬性與方法:
event.pageX 滑鼠距網頁左上角的水平距離
event.pageY 滑鼠距網頁左上角的垂直距離
event.type 事件類型
event.which 按下了哪一個鍵
event.data 在事件上綁定的資料,會傳入處理函式
event.target 事件針對的元素
event.preventDefault() 阻止預設行為(例如點連結自動跳頁)
event.stopPropagation() 停止事件向上冒泡
處理函式中可用 this 取得事件針對的 DOM 元素:
$('a').click(function (e) {
if ($(this).attr('href').match('evil')) { // 確認為有害連結
e.preventDefault(); // 阻止跳轉
$(this).addClass('evil'); // 加上標記 class
}
});
要主動觸發事件有兩種方式:
$('a').click();
$('a').trigger('click');
$('h1').show(); // 展現一個 h1 標題
常用效果:
.fadeIn() 淡入
.fadeOut() 淡出
.fadeTo() 調整透明度
.hide() 隱藏元素
.show() 顯示元素
.slideDown() 向下展開
.slideUp() 向上捲起
.slideToggle() 輪流展開或捲起
.toggle() 輪流顯示或隱藏
除 .show() 與 .hide() 外,其餘效果預設執行時間為 400ms,可以自行調整:
$('h1').fadeIn(300); // 300 毫秒內淡入
$('h1').fadeOut('slow'); // 緩慢淡出
效果結束後可指定要執行的函式:
$('p').fadeOut(300, function () { $(this).remove(); });
更複雜的效果用 .animate() 自訂:
$('div').animate(
{
left: "+=50", // 持續右移
opacity: 0.25 // 指定透明度
},
300, // 持續時間
function () { alert('done!'); } // 回呼函式
);
.stop() 與 .delay() 用來停止或延緩效果。另外若把 $.fx.off 設為 true,可全域關閉所有動畫效果——這在處理 prefers-reduced-motion 需求時很好用。