jQuery 是目前使用最廣的 JavaScript 函式庫。統計顯示,全球排名前一百萬的網站中約有 46% 使用 jQuery,遠超其他函式庫;微軟甚至將它列為官方函式庫。對網頁開發者而言,學會 jQuery 是必修課——它讓你掌握業界最通用的技術,為日後學習更進階的函式庫打底,而且確實能輕鬆做出許多複雜的效果。
jQuery 的基本設計與主要用法就是「選取某個網頁元素,然後對它進行某種操作」。這是它與其他函式庫最根本的差異。
使用 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
選到多個元素後,jQuery 提供過濾器來縮小範圍:
$('div').has('p'); // 含 p 元素的 div
$('div').not('.myClass'); // class 不為 myClass 的 div
$('div').filter('.myClass'); // class 為 myClass 的 div
$('div').first(); // 第一個 div
$('div').eq(5); // 第六個 div(索引從 0 起)
有時需要從目前結果出發,移動到附近的相關元素,jQuery 也提供了 DOM 樹上的走訪方法:
$('div').next('p'); // div 之後的第一個 p
$('div').parent(); // 父元素
$('div').closest('form'); // 離 div 最近的 form 祖先
$('div').children(); // 所有子元素
$('div').siblings(); // 同層元素
選好元素後就能進行操作。jQuery 允許把所有操作串成一條鏈:
$('div').find('h3').eq(2).html('Hello');
拆開來看就是:
$('div') // 找到 div 元素
.find('h3') // 選取其中的 h3
.eq(2) // 選第三個 h3
.html('Hello'); // 把它的內容改為 Hello
這是 jQuery 最令人稱道、最方便的特點。原理在於每一步操作回傳的都是一個 jQuery 物件,所以不同操作可以連在一起。
jQuery 還提供 .end() 讓結果集退回上一步:
$('div')
.find('h3')
.eq(2)
.html('Hello')
.end() // 退回選中所有 h3 的那一步
.eq(0) // 選第一個 h3
.html('World'); // 內容改為 World
操作元素最常見的需求是取得或設定值。jQuery 用同一組函式完成兩件事,究竟是取值還是赋值,由有無參數決定:
$('h1').html(); // 無參數:取出 h1 的內容
$('h1').html('Hello'); // 有參數:對 h1 赋值
常見的取值/赋值函式:
.html() 取出或設定 HTML 內容.text() 取出或設定純文字內容.attr() 取出或設定某個屬性的值.width() / .height() 取出或設定寬高.val() 取出或設定表單元素的值要注意的是:若結果集含多個元素,赋值時會作用於全部;取值時則只取第一個(.text() 是例外,它會串接所有元素的文字)。
移動選中的元素有兩種思路:直接移動該元素,或移動其他元素使目標到位。以下把 div 移到 p 之後為例。
第一種用 .insertAfter(),把 div 移到 p 之後:
$('div').insertAfter('p');
第二種用 .after(),把 div 插到 p 之後:
$('p').after('div');
表面效果相同,但回傳的元素不同:前者回傳 div,後者回傳 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 也提供一些不必選元素就能直接使用的工具方法(utility)。
若了解 JavaScript 的繼承原理就能理解其本質:工具方法定義在建構函式上(jQuery.method()),因此可直接呼叫;而操作元素的方法定義在 prototype 上(jQuery.prototype.method()),必須先有實例。若一時不分辨也無妨,把工具方法理解為「像原生函式那樣可直接使用的函式」即可。
常用的有:
$.trim() 去除字串兩端空白$.each() 走訪陣列或物件$.inArray() 回傳某值在陣列中的索引,不存在則為 -1$.grep() 篩選陣列中符合條件的元素$.extend() 把多個物件合併到第一個物件$.makeArray() 把物件轉為陣列$.type() 判斷物件類別$.isArray() / $.isFunction() 型別判斷$.isEmptyObject() 判斷物件是否無任何屬性$.isPlainObject() 判斷是否為 {} 或 new Object 建立$.support() 判斷瀏覽器是否支援某特性可以為元素綁定事件,依不同事件執行相應函式:
$('p').click(function(){
alert('Hello');
});
jQuery 主要支援的事件:
.blur() 失去焦點、.focus() 取得焦點、.focusin() / .focusout() 子元素焦點變化、.change() 值改變、.select() 選中文本、.submit() 遞交表單.click() 單擊、.dblclick() 雙擊、.mousedown() / .mouseup() 按下與放開、.mouseenter() / .mouseleave() 進入與離開(不含子元素)、.mouseover() / .mouseout() 進入與離開(含子元素)、.mousemove() 內部移動、.hover() 同時指定進入與離開.keydown() 按下(長按只觸發一次)、.keypress() 按下(長按會連續觸發)、.keyup() 放開.load() 載入完成、.ready() DOM 就緒、.resize() 視窗尺寸改變、.scroll() 捲動、.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 / pageY:事件發生時滑鼠距網頁左上角的距離event.type:事件類型event.which:按下了哪一個鍵event.data:綁定時附帶的資料event.target:事件針對的元素event.preventDefault():阻止預設行為(如點連結不跳頁)event.stopPropagation():停止事件向上冒泡在處理函式中,this 指向事件針對的 DOM 元素:
$('a').click(function(){
if ($(this).attr('href').match('evil')){ // 確認為有害連結
e.preventDefault(); // 阻止開啟
$(this).addClass('evil'); // 加上標記 class
}
});
自動觸發事件有兩種方式,直接用事件函式,或用 .trigger():
$('a').click();
$('a').trigger('click');
jQuery 讓元素呈現各種動畫效果:
$('h1').show(); // 展現一個 h1 標題
常用的特效:
.fadeIn() 淡入、.fadeOut() 淡出、.fadeTo() 調整透明度.hide() 隱藏、.show() 顯示.slideDown() 向下展開、.slideUp() 向上捲起、.slideToggle() 輪流展開與捲起.toggle() 輪流顯示與隱藏除了 .show() 與 .hide(),其他特效的預設執行時間是 400 毫秒,可以自行調整:
$('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 則可關閉所有動畫。
以上內容涵蓋了 jQuery 的核心,但這套 API 在今日多數新專案中已不再是首選。原生 querySelectorAll、classList、fetch 已能取代大半功能,而 React、Vue 這類框架更是主流。學習 jQuery 的價值主要在兩點:一是維護既有專案時必備,二是它示範的鏈式呼叫與 DOM 操作思維,能幫助你理解框架背後在做什麼。若為新專案選擇技術,建議先評估原生 API 與現代框架是否已能滿足需求。