要讀懂 Sizzle 的 compile 執行過程,前提是弄清楚各子程式的職責與關鍵變數。本文以 jQuery-1.10.2 版本為例,逐一說明 compile 相關程式碼,第一站就是 elementMatcher。
function elementMatcher(matchers) { return matchers.length > 1 ? function(elem, context, xml) { var i = matchers.length; while (i--) { if (!matchers[i](elem, context, xml)) { return false; } } return true; } : matchers[0]; }
elementMatcher 會回傳一個函式,用來判定傳入的 elem 是否符合 matchers 陣列中的所有匹配條件:全部滿足回傳 true,否則回傳 false。若 matchers 只有一個元素,則直接回傳該元素本身;若有多個,則回傳程式碼中那個 function(elem, context, xml) 新函式。
它的效果有點類似 context.filter(selectors),差別在於其結果只是一個布林值,而非 jQuery 物件。
matchers——一個陣列,每個元素都是「非偽類」的匹配器執行函式。舉例來說,執行 div.map span:lt(10) 時,div 與 .map 的匹配執行函式會作為 matchers 的兩個元素傳入 elementMatcher,用來過濾 span 的父節點是否同時滿足 div 與 .map 兩個條件。
4.1 當 matchers 多於 1 個元素時,回傳:
function(elem, context, xml) { var i = matchers.length; while (i--) { if (!matchers[i](elem, context, xml)) { return false; } } return true; }
4.1.1 功能:從 matchers 的最後一個元素往前逐個呼叫,檢查傳入的 elem 是否全部滿足;全數通過回傳 true,任一失敗即回傳 false。
4.1.2 參數:
elem——待檢查的單一節點元素。
context——執行整個選擇器匹配的上下文節點,多數情況下用不到。
xml——標示當前搜尋對象是 HTML 還是 XML 文件;若為 HTML,則 xml 為 false。
4.2 當 matchers 只有 1 個元素時,直接回傳該元素本身。
4.2.1 功能:檢查傳入的 elem 是否與選擇器匹配,匹配回傳 true,否則 false。
4.2.2 參數:同 4.1.2。