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
選到多個元素後,可用過濾器進一步篩選:
$('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 起)
另外也常需要從目前位置移動到周邊元素:
$('div').next('p'); // 後面第一個 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) // 取第三個 h3
.html('Hello'); // 把內容改成 Hello
之所以能串起來,是因為每一步操作回傳的都是 jQuery 物件本身。
若想往回退一步,用 .end():
$('div')
.find('h3')
.eq(2)
.html('Hello')
.end() // 退回「選中所有 h3」那一步
.eq(0) // 選第一個 h3
.html('World');
操作元素最常見的兩種需求就是取值(getter)與賦值(setter)。jQuery clever 地用同一組函式處理兩者,靠參數有無來區分:
$('h1').html(); // 沒有參數 → 取出 h1 的內容
$('h1').html('Hello'); // 有參數 → 設定 h1 的內容
常用的一組對應函式:
.html():取出或設定 HTML 內容.text():取出或設定純文字內容.attr():取出或設定某個屬性的值.width() / .height():取出或設定寬度、高度.val():取出或設定表單元素的值要注意的是:當結果集含多個元素時,賦值會套用到「全部」元素,取值卻只回傳「第一個」元素的值(.text() 是例外,它會串接所有元素的文字)。
移動元素有兩種視角:直接搬目標元素,或搬另一個元素過來。以下把 div 移到 p 後面:
$('div').insertAfter('p'); // 把 div 搬到 p 之後,回傳 div
$('p').after('div'); // 把 div 插到 p 之後,回傳 p
兩者視覺結果相同,但回傳的物件不同,這點在鏈式呼叫時很關鍵。同類方法共有四組:
.insertAfter() / .after():外部、後方插入.insertBefore() / .before():外部、前方插入.appendTo() / .append():內部、後方插入.prependTo() / .prepend():內部、前方插入$('div').clone(); // 複製元素
$('div').remove(); // 刪除元素(連事件一起丟掉)
$('div').detach(); // 刪除元素(保留事件,適合之後再放回)
$('div').empty(); // 清空內容但保留元素本身
建立新元素非常直覺,把 HTML 字串丟進 $() 即可:
$('<p>Hello</p>');
$('<li class="new">new list item</li>');
$('ul').append('<li>list item</li>');
除了操作元素的方法,jQuery 還提供一批不需選取元素就能直接呼叫的工具函式。懂 JavaScript 原型鏈的話會發現:元素方法是掛在 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
把這八個部分串起來,大致就涵蓋了日常 jQuery 開發所需的九成知識。建議搭配實作反覆練習,比死記 API 有效得多。