jQuery() 是整个函式庫的核心入口。你在頁面上寫的每一個 $(),其實都是它的縮寫。搞懂這支方法的四種呼叫形式,等於掌握了 jQuery 的用法骨架。
jQuery("div") // 等價於 $("div")
$ 只是 jQuery 的別名,兩者可以互相替換。之所以保留完整寫法,是因為有些頁面會把 $ 佔用給其他函式庫(例如 Prototype),此時用 jQuery.noConflict() 讓出 $ 之後,就得改用 jQuery() 來呼叫。
jQuery()
不傳任何參數時,會回傳一個空的 jQuery 物件,其 length 為 0。它本身沒有實用價值,但在撰寫外掛時常作為起始的空集合。
jQuery(selector, context)
selector 是要匹配的選擇器;context 是可選的搜尋起點,可以是 DOM 元素、文件或 jQuery 物件。未指定時預設搜尋整份文件。
// 範例一:搜尋整個文件
$("button").click(function(){
$("li").css("color","red");
});
// 範例二:只在 div 內部搜尋 li
$("button").click(function(){
$("li", $("div")).css("color","red");
});
第二個寫法只會改到 div 裡的 li,視窗外的 li 不受影響。指定上下文不只是效能考量(縮小搜尋範圍),更能避免不同區域的命名衝突。
jQuery(element | elementArray)
// 轉換單一 DOM 元素
$(document.getElementById("first")).css("color","red");
// 轉換 DOM 元素陣列
$(document.getElementsByTagName("li")).css("color","red");
這個語法在整合不提供 jQuery 介面的第三方函式庫時特別有用——它們通常回傳原生節點,包一層 $() 就能接手後續操作。
jQuery(callback)
這是 $(document).ready() 的簡寫形式,作用是在 DOM 解析完成後才執行 callback:
jQuery(function(){
alert("文檔加載完成了");
});
// 與下面這段功能完全相同
$(document).ready(function(){
alert("文檔加載完成了");
});
還有一個更短的等價寫法 $(function(){ ... }),這也是目前最常見的形式。三種寫法行為一致,挑一種貫穿整個專案即可,混用只會降低可讀性。
原因很實際:若 <script> 放在 head 中,執行時 body 裡的元素可能還沒被解析出來,此時抓元素會得到空集合。把初始化程式碼放進 ready 回呼,就能確保 DOM 已經完整可用——這也是為什麼前面所有範例都包了一層 $(document).ready()。