jQuery 的核心思想只有一句話:先選中元素,再對它做事。理解這一點,整個 API 幾乎都能自行推導。以下把常用知識重新梳理成一條學習路徑。
兩者都在「頁面準備好之後」執行程式,但時機不同。window.onload 要等所有資源下載完畢(包含圖片、iframe、Flash),因此常被大量圖片拖慢;$(document).ready() 只要 DOM 樹建立完成就執行,不必等圖片。此外 onload 一次只能指派一個函式,後寫的會覆蓋前面的,而 ready 可以寫任意多段,並可簡寫為 $(function(){})。
把選擇式放進 $() 就得到一組元素。CSS 選擇器:
$(document) // 整個文件
$('#myId') // id 為 myId 的元素
$('div.myClass') // class 為 myClass 的 div
$('input[name=first]') // name 屬性等於 first 的 input
jQuery 自有的過濾表達式:
$('a:first') // 第一個 a
$('tr:odd') // 表格奇數行
$('#myForm :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').eq(5) // 第六個
$('div').next('p') // 後面的第一個 p
$('div').parent() // 父元素
$('div').closest('form') // 最近的 form 祖先
$('div').children() // 所有子元素
$('div').siblings() // 同層元素
因為每個 jQuery 方法都會回傳 jQuery 物件,所以可以一路串下去:
$('div').find('h3').eq(2).html('Hello');
而 .end() 能退回上一個「破壞性操作」之前,讓同一條鏈往回走:
$("p").find("span").end()
上例先選取所有 p,找出其中的 span,再用 end() 退回「選取 p」的那一步。
jQuery 用同一個方法同時處理讀取與寫入,靠有沒有傳參數來區分:
$('h1').html(); // 讀取
$('h1').html('Hello'); // 寫入
常用的有 .html()(含標籤的內容)、.text()(純文字)、.attr()(屬性)、.width()/.height()(尺寸)、.val()(表單值)。注意:結果集含多個元素時,賦值會作用於全部,取值則只回傳第一個(.text() 例外,它會串接所有元素的文字)。
四組成對的方法,涵蓋「外部/內部」與「前/後」的組合:
.after() / .insertAfter() // 外部、後面 .before() / .insertBefore() // 外部、前面 .append() / .appendTo() // 內部、後面 .prepend() / .prependTo() // 內部、前面
兩組的差別只在敘述角度:以「被操作的元素」為主詞的是 after、before、append、prepend;以「要被插入的內容」為主詞的是 insertAfter 那一組。實際效果相同,選順手的那個即可。
$('p').clone(); // 複製
$('p').remove(); // 刪除,連事件一起丟掉
$('p').detach(); // 刪除但保留事件,適合之後要放回
$('p').empty(); // 只清空內容,元素本身留著
$('ul').append('<li>list item</li>'); // 直接傳 HTML 字串即可建立新元素
$.trim() 去頭尾空白、$.each() 遍歷陣列或物件、$.inArray() 找索引、$.grep() 篩選陣列、$.extend() 合併物件、$.makeArray() 轉陣列、$.type() 判型別,以及 $.isArray()、$.isEmptyObject()、$.isFunction()、$.isPlainObject()、$.support() 等判斷函式。
$('p').click(function () { alert('Hello'); });
click、dblclick、focus、blur、change、submit、keydown/keypress/keyup、mouseenter/mouseleave、hover、scroll、resize、ready、unload 等都有對應的簡寫方法,它們在內部都是 .bind() 的包裝。需要一次綁多個事件時直接用 bind:
$('input').bind('click change', function () { alert('Hello'); });
$("p").one("click", function () { alert("只會執行一次"); });
$('p').unbind('click');
事件處理函式都會收到一個 event 物件,常用成員包括 pageX/pageY(滑鼠位置)、type(事件類型)、which(按下的鍵或滑鼠鍵)、target(觸發的來源元素)、data(附帶資料),以及 preventDefault() 阻止預設行為、stopPropagation() 阻止事件冒泡。
在處理函式裡用 this 可以拿到原生 DOM 元素,包成 $(this) 就是 jQuery 物件:
$('a').click(function (e) {
if ($(this).attr('href').match('evil')) {
e.preventDefault();
$(this).addClass('evil');
}
});
淡入淡出:fadeIn / fadeOut / fadeTo;滑動:slideDown / slideUp / slideToggle;顯示隱藏:show / hide / toggle。除了 show 與 hide,其餘效果預設 400 毫秒,可傳入數字或 'slow'、'normal'、'fast':
$('h1').fadeIn(300);
$('p').fadeOut(300, function () { $(this).remove(); });
更複雜的變化交給 .animate() 自訂屬性與回呼:
$('div').animate({
left: "+=50",
opacity: 0.25
}, 300, function () { alert('done!'); });
.stop() 可中止進行中的動畫,.delay() 可插入延遲,把 $.fx.off 設為 true 則能全域關閉動畫。
官方 CDN 是最省事的選擇,也可以搭配 migrate 插件過渡舊 API:
<script src="//code.jquery.com/jquery-1.11.0.min.js"></script> <script src="//code.jquery.com/jquery-migrate-1.2.1.min.js"></script>
把這條主線走熟,其餘 API 都能靠文件查詢補齊。真正需要花心思的不是記住方法名稱,而是養成「先想清楚要選什麼、再挑對應方法」的習慣。