在整個 jQuery 函式庫中,最重要的莫過於 jQuery()(也就是 $())。它功能強大,共有四種不同的呼叫形式,各有其適用場景。
這是最常見的用法。把選擇器字串交給 $(),它會回傳當前任文中所有匹配的元素集合。jQuery 支援大部分 CSS3 選擇器語法,並額外擴充了一些自有的表達式。
你也可以把某個元素或 jQuery 物件作為第二個參數傳入,此時只會在該元素的子元素中尋找匹配項。這個可選的第二參數界定了查詢的起點,一般稱為上下文(context):
$('li', '#myList'); // 只在 #myList 內尋找 li
這種情況下,$() 只是把 Element、Document 或 window 包裝成 jQuery 物件後回傳,好讓你能用 jQuery 方法而非原生 DOM API 來操作它。因此 $(document) 與 $(this) 在 jQuery 程式中隨處可見。
此外也可以傳入一個元素陣列,回傳的 jQuery 物件即代表該陣列中的所有元素。
把 HTML 文字字串交給 $(),jQuery 會依內容建立對應元素,再包裝成 jQuery 物件回傳。注意:新建的元素不會自動插入文件,必須另外呼叫 append()、appendTo() 等方法安置它。
var newDiv = $('<div><p>Hello</p></div>');
$('body').append(newDiv);
這種寫法有個容易踩的雷:不能傳入純文字,因為 jQuery 會把不含標籤的字串當成 CSS 選擇器來解析。傳入的字串至少要包含一組角括號標籤。
它同樣接受可選的第二參數,有兩種形式:
css、html、text、width、height、offset、val、data,或是某個事件註冊方法(如 click),jQuery 會改為呼叫新元素上的同名方法並傳入該值。var img = $("<img>", {
src: url, // HTML 屬性
css: {borderWidth: 5}, // 呼叫 css() 設定樣式
click: handleClick // 註冊 click 事件
});
把函式交給 $(),該函式會在文件載入完成、DOM 可安全操作時被執行。這就是 onload 的 jQuery 版本,也是語意更精準的版本——它等的是 DOM 就緒,而非所有圖片都下載完畢。
jQuery(function(){
// 文件就緒後執行的程式碼
});
常見的老式寫法還有兩種,效果等價:
$(f);
$(document).ready(f);
傳入的函式被呼叫時,this 指向 document 物件,唯一參數則指向 jQuery 函式本身。這讓你可以在釋放全域 $ 之後,於區塊內部延續熟悉的 $ 寫法:
jQuery.noConflict(); // 還原 $() 為初始值
jQuery(function($){ // 在這裡讓 $ 成為 jQuery 的區域別名
// jQuery 程式碼
});
由 $() 註冊的函式會在 DOMContentLoaded 觸發時被 jQuery 執行;若瀏覽器不支援該事件,則改在 load 時觸發。另外,如果 DOM 早已就緒才呼叫 $() 傳入函式,該函式會在 $() 回傳前立刻執行,不會漏掉。
jQuery 同時把 jQuery() 當作自己的命名空間使用,在這個函式上掛載了許多工具函式與屬性,例如 jQuery.noConflict()、用於遍歷的 jQuery.each(),以及解析 JSON 的 jQuery.parseJSON()。理解這一點,就能明白為何有些方法寫成 $.xxx(),有些則必須透過選中的元素呼叫。