Sizzle1.9的源码分析

没有完全看明白,看来得从Sizzle1.8看起。这是Sizzle又一个分水岭,引入了编译函数机制。

(function(window, undefined) {

    var i,
    cachedruns,
    Expr,
    getText,
    isXML,
    compile,
    outermostContext,
    recompare,
    sortInput,
    // Local document vars
    setDocument,
    document,
    docElem,
    documentIsHTML,
    rbuggyQSA,
    rbuggyMatches,
    matches,
    contains,
    // Instance-specific data
    expando = "sizzle" + -(new Date()),
        preferredDoc = window.document,
        support = {},
        dirruns = 0,
        done = 0,
        classCache = createCache(),
        tokenCache = createCache(),
        compilerCache = createCache(),
        hasDuplicate = false,
        sortOrder = function() {
            return 0;
        },
        // General-purpose constants
        strundefined = typeof undefined,
        MAX_NEGATIVE = 1 << 31,
        // Array methods
        arr = [],
        pop = arr.pop,
        push_native = arr.push,
        push = arr.push,
        slice = arr.slice,
        //用于判定元素是否在此数组内
        indexOf = arr.indexOf || function(elem) {
            var i = 0,
                len = this.length;
            for (; i < len; i++) {
                if (this[i] === elem) {
                    return i;
                }
            }
            return -1;
        },
        // Regular expressions

        // 空白的正则 http://www.w3.org/TR/css3-selectors/#whitespace
        whitespace = "[\\x20\\t\\r\\n\\f]",
        // 类选择器与标签选择器的正则 http://www.w3.org/TR/css3-syntax/#characters
        characterEncoding = "(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",
        //ID选择器与标签选择器的正则,HTML5将ID的规则放宽,允许ID可以是纯数字
        // An unquoted value should be a CSS identifier http://www.w3.org/TR/css3-selectors/#attribute-selectors
        // Proper syntax: http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier
        identifier = characterEncoding.replace("w", "w#"),
        // 属性选择器的操作符 http://www.w3.org/TR/selectors/#attribute-selectors
        operators = "([*^$|!~]?=)",
        //属性选择器的正则
        attributes = "\\[" + whitespace + "*(" + characterEncoding + ")" + whitespace +
            "*(?:" + operators + whitespace + "*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|(" + identifier + ")|)|)" + whitespace + "*\\]",
        // 伪类的正则
        pseudos = ":(" + characterEncoding + ")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|" + attributes.replace(3, 8) + ")*)|.*)\\)|)",
        // 去掉两端空白正则
        rtrim = new RegExp("^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g"),
        //并联选择器的正则
        rcomma = new RegExp("^" + whitespace + "*," + whitespace + "*"),
        //关系选择器的正则
        rcombinators = new RegExp("^" + whitespace + "*([\\x20\\t\\r\\n\\f>+~])" + whitespace + "*"),
        rpseudo = new RegExp(pseudos),
        ridentifier = new RegExp("^" + identifier + "$"),
        matchExpr = {
            "ID": new RegExp("^#(" + characterEncoding + ")"),
            "CLASS": new RegExp("^\\.(" + characterEncoding + ")"),
            "NAME": new RegExp("^\\[name=['\"]?(" + characterEncoding + ")['\"]?\\]"),
            "TAG": new RegExp("^(" + characterEncoding.replace("w", "w*") + ")"),
            "ATTR": new RegExp("^" + attributes),
            "PSEUDO": new RegExp("^" + pseudos),
            //子元素过滤伪类
            "CHILD": new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace +
                "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace +
                "*(\\d+)|))" + whitespace + "*\\)|)", "i"),
            // 位置伪类
            "needsContext": new RegExp("^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i")
        },
        rsibling = /[\x20\t\r\n\f]*[+~]/,
        //取函数的toString判定是否原生API,比如一些库伪造了getElementsByClassName
        rnative = /^[^{]+\{\s*\[native code/,
        //判定选择符是否为单个ID选择器,或标签选择器或类选择器
        rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,
        //jQuery自定义的input伪类
        rinputs = /^(?:input|select|textarea|button)$/i,
        //jQuery自定义的header伪类
        rheader = /^h\d$/i,
        rescape = /'|\\/g,
        //用于匹配不带引号的属性值,用于matchesSelector
        rattributeQuotes = /\=[\x20\t\r\n\f]*([^'"\]]*)[\x20\t\r\n\f]*\]/g,
        // CSS 字符转义 http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
        runescape = /\\([\da-fA-F]{1,6}[\x20\t\r\n\f]?|.)/g,
        funescape = function(_, escaped) {
            var high = "0x" + escaped - 0x10000;
            // NaN means non-codepoint
            return high !== high ? escaped :
            // BMP codepoint
            high < 0 ? String.fromCharCode(high + 0x10000) :
            // Supplemental Plane codepoint (surrogate pair)
            String.fromCharCode(high >> 10 | 0xD800, high & 0x3FF | 0xDC00);
        };

    //  将一个NodeList转换为一个纯数组
    try {
        push.apply(
        (arr = slice.call(preferredDoc.childNodes)),
        preferredDoc.childNodes);
        // Support: Android<4.0
        // Detect silently failing push.apply
        arr[preferredDoc.childNodes.length].nodeType;
    } catch (e) {
        push = {
            apply: arr.length ?
            // Leverage slice if possible

            function(target, els) {
                push_native.apply(target, slice.call(els));
            } :
            // IE6-8只能逐个遍历加入

            function(target, els) {
                var j = target.length,
                    i = 0;
                // Can't trust NodeList.length
                while ((target[j++] = els[i++])) {}
                target.length = j - 1;
            }
        };
    }

    function isNative(fn) {
        return rnative.test(fn + "");
    }


    //创建一个缓存函数,它以自己为储存仓库,键名放到闭包内的一个数组内,当数组的个数超过
    //Expr.cacheLength时,则去掉最前面的键值

    function createCache() {
        var cache,
        keys = [];
        return (cache = function(key, value) {
            //对键名进行改造,防止与Object.prototype的原生方法重名,比如toString, valueOf th native prototype properties (see Issue #157)
            if (keys.push(key += " ") > Expr.cacheLength) {
                // Only keep the most recent entries
                delete cache[keys.shift()];
            }
            return (cache[key] = value);
        });
    }

    /**
     * Mark a function for special use by Sizzle
     * @param {Function} fn The function to mark
     */

    function markFunction(fn) {
        fn[expando] = true;
        return fn;
    }


    //用于做各种特征检测,比如是否支持某个API,API支持是否完美

    function assert(fn) {
        var div = document.createElement("div");

        try {
            return !!fn(div);
        } catch (e) {
            return false;
        } finally {
            // release memory in IE
            div = null;
        }
    }
    //Sizzle主函数被设计得能递归自身,参数依次是选择符,上下文对象,结果集,种子集
    //除了第一个参数,其他都是可选,上下文对象默认是当前文档对象

    function Sizzle(selector, context, results, seed) {
        var match, elem, m, nodeType,
        // QSA vars
        i, groups, old, nid, newContext, newSelector;
        //如果指定了上下文对象的ownerDocument不等于当前文档对象,覆写所有涉及到document的内部方法
        if ((context ? context.ownerDocument || context : preferredDoc) !== document) {
            setDocument(context);
        }

        context = context || document;
        results = results || [];

        if (!selector || typeof selector !== "string") {
            return results;
        }

        if ((nodeType = context.nodeType) !== 1 && nodeType !== 9) {
            return [];
        }

        if (documentIsHTML && !seed) {

            // Shortcuts
            if ((match = rquickExpr.exec(selector))) {
                // Speed-up: Sizzle("#ID")
                //如果只有一个ID,那么直接getElementById,然后判定其是否在DOM树,
                //元素的ID确实为目标值就将它合并到结果集中
                if ((m = match[1])) {
                    if (nodeType === 9) {
                        elem = context.getElementById(m);
                        // Check parentNode to catch when Blackberry 4.6 returns
                        // nodes that are no longer in the document #6963
                        if (elem && elem.parentNode) {
                            // Handle the case where IE, Opera, and Webkit return items
                            // by name instead of ID
                            if (elem.id === m) {
                                results.push(elem);
                                return results;
                            }
                        } else {
                            return results;
                        }
                    } else {
                        //如果上下文非文档对象,需要用contains函数进行验证
                        if (context.ownerDocument && (elem = context.ownerDocument.getElementById(m)) && contains(context, elem) && elem.id === m) {
                            results.push(elem);
                            return results;
                        }
                    }

                    //如果选择符为一个标签选择器
                } else if (match[2]) {
                    push.apply(results, context.getElementsByTagName(selector));
                    return results;

                    //如果选择符为一个类选择器,浏览器又支持getElementsByClassName
                } else if ((m = match[3]) && support.getElementsByClassName && context.getElementsByClassName) {
                    push.apply(results, context.getElementsByClassName(m));
                    return results;
                }
            }

            // 尝试使用querySelectorAll,并且选择符不存在那些有问题的选择器
            if (!support.qsa && !rbuggyQSA.test(selector)) {
                old = true;
                nid = expando;
                newContext = context;
                newSelector = nodeType === 9 && selector;
                //IE8的querySelectorAll实现存在BUG,它会在包含自己的集合内查找符合自己的元素节点
                //根据规范,应该是当前上下文的所有子孙下找
                //IE8下如果元素节点为Object,无法找到元素

                if (nodeType === 1 && context.nodeName.toLowerCase() !== "object") {
                    groups = tokenize(selector); //将选择符细分N个分组
                    //如果存在ID,则将ID取得出来放到这个分组的最前面,比如div b --> [id=xxx] div b
                    //不存在ID,就创建一个ID,重复上面的操作,但最后会删掉此ID
                    if ((old = context.getAttribute("id"))) {
                        nid = old.replace(rescape, "\\$&");
                    } else {
                        context.setAttribute("id", nid);
                    }
                    nid = "[id='" + nid + "'] ";

                    i = groups.length;
                    while (i--) {
                        groups[i] = nid + toSelector(groups[i]);
                    }
                    newContext = rsibling.test(selector) && context.parentNode || context;
                    newSelector = groups.join(",");
                }

                if (newSelector) {
                    try {
                        push.apply(results,
                        newContext.querySelectorAll(newSelector));
                        return results;
                    } catch (qsaError) {} finally {
                        if (!old) {
                            context.removeAttribute("id");
                        }
                    }
                }
            }
        }

        // 否则去掉两边的空白开始查找
        return select(selector.replace(rtrim, "$1"), context, results, seed);
    }

    /**
     * Detect xml
     * @param {Element|Object} elem An element or a document
     */
    isXML = Sizzle.isXML = function(elem) {
        // documentElement is verified for cases where it doesn't yet exist
        // (such as loading iframes in IE - #4833)
        var documentElement = elem && (elem.ownerDocument || elem).documentElement;
        return documentElement ? documentElement.nodeName !== "HTML" : false;
    };

    /**
     * Sets document-related variables once based on the current document
     * @param {Element|Object} [doc] An element or document object to use to set the document
     * @returns {Object} Returns the current document
     */
    setDocument = Sizzle.setDocument = function(node) {
        var doc = node ? node.ownerDocument || node : preferredDoc;
        //如果文档对象等于当前文档对象,无法确认其文档对象,或没有HTML,直接返回
        //此情况出现机率接近零
        if (doc === document || doc.nodeType !== 9 || !doc.documentElement) {
            return document;
        }

        // Set our document
        document = doc;
        docElem = doc.documentElement;

        // 是否为HTML文档
        documentIsHTML = !isXML(doc);

        //判定getElementsByTagName("*")是否只返回元素节点,IE6-8会混杂注释节点
        support.getElementsByTagName = assert(function(div) {
            div.appendChild(doc.createComment(""));
            return !div.getElementsByTagName("*").length;
        });
        //判定浏览器是否区分property与attribute,比如下面测试,multiple为select的一个property
        //只能通过el.xxx这样的方法去取值,若使用getAttribute去取会返回null
        support.attributes = assert(function(div) {
            div.innerHTML = "<select></select>";
            var type = typeof div.lastChild.getAttribute("multiple");
            // IE8 returns a string for some attributes even when not present
            return type !== "boolean" && type !== "string";
        });

        //判定getElementsByClassName值得信任,比如下面测试发现opera9.6不支持第二个类名,
        //safari3.2缓存过度,忘了更新自身
        support.getElementsByClassName = assert(function(div) {
            div.innerHTML = "<div class='hidden e'></div><div class='hidden'></div>";
            if (!div.getElementsByClassName || !div.getElementsByClassName("e").length) {
                return false; //opera9.6
            }
            // Safari 3.2 
            div.lastChild.className = "e";
            return div.getElementsByClassName("e").length === 2;
        });

        // 判定getElementsByName是否可用Check if getElementsByName privileges form controls or returns elements by ID
        // If so, assume (for broader support) that getElementById returns elements by name
        support.getByName = assert(function(div) {
            div.id = expando + 0; //用于检测是否区分name与ID
            // getElementsByName是一个问题多的API,Sizzle原来的注释透露多少东西,
            //因此我在这里补上
            //1 IE6-7下getElementsByName与getElementById都不区分元素的name与ID
            //2 IE的getElementsByName只对表单元素有效,无视拥有相同name值的span div元素
            //3 IE6-7下即使通过document.createElement创建一个表单元素,动态设置name与插入
            //  DOM树,getElementsByName无法找到此元素,innerHTML也不行。一定需要以
            //   document.createElement("<input name="aaa"/>")方式生成元素才行。
            //   同样的情况也发生在iframe上,IE6-7的iframe的name也需要这样同时生成。
            //4 name本来是一个property,但标准浏览器好像已经默认setAttribute("name","xxx")
            //  也能被getElementsByName获取到。
            //5 IE6-8通过innerHTML生成包含name属性的元素时,可能发生无法捕获的错误
            div.appendChild(document.createElement("a")).setAttribute("name", expando);
            div.appendChild(document.createElement("i")).setAttribute("name", expando);
            docElem.appendChild(div);

            // Test
            var pass = doc.getElementsByName &&
            // buggy browsers will return fewer than the correct 2
            doc.getElementsByName(expando).length === 2 +
            // buggy browsers will return more than the correct 0
            doc.getElementsByName(expando + 0).length;

            // Cleanup
            docElem.removeChild(div);

            return pass;
        });

        // Support: Webkit<537.32
        // 判定compareDocumentPosition是否可靠
        support.sortDetached = assert(function(div1) {
            return div1.compareDocumentPosition &&
            // Should return 1, but Webkit returns 4 (following)
            (div1.compareDocumentPosition(document.createElement("div")) & 1);
        });

        // 调整IE6-7下获取某些属性的方式,这里只对href, type进行处理
        //实际上,在jQuery里它会被jQuery.attr覆盖
        Expr.attrHandle = assert(function(div) {
            div.innerHTML = "<a href='#'></a>";
            //IE取href, action, src时不会原型返回,会返回其绝对路径
            return div.firstChild && typeof div.firstChild.getAttribute !== strundefined && div.firstChild.getAttribute("href") === "#";
        }) ? {} : {
            "href": function(elem) {
                return elem.getAttribute("href", 2);
            },
            "type": function(elem) {
                return elem.getAttribute("type");
            }
        };

        // ID find and filter
        if (support.getByName) {
            Expr.find["ID"] = function(id, context) {
                //Blackberry 4.6 缓存过度,即便这元素被移出DOM树也能找到
                if (typeof context.getElementById !== strundefined && documentIsHTML) {
                    var m = context.getElementById(id);
                    return m && m.parentNode ? [m] : [];
                }
            };
            Expr.filter["ID"] = function(id) { //过滤器
                var attrId = id.replace(runescape, funescape);
                return function(elem) {
                    return elem.getAttribute("id") === attrId;
                };
            };
        } else {
            Expr.find["ID"] = function(id, context) {
                if (typeof context.getElementById !== strundefined && documentIsHTML) {
                    var m = context.getElementById(id);
                    //1 IE6-7无法区分name与ID,
                    //2 如果form元素的ID为aaa,它下面也有一个name为aaa的INPUT元素,会错误返回INPUT
                    return m ? m.id === id || typeof m.getAttributeNode !== strundefined && m.getAttributeNode("id").value === id ? [m] : undefined : [];
                }
            };
            Expr.filter["ID"] = function(id) {
                var attrId = id.replace(runescape, funescape);
                return function(elem) {
                    var node = typeof elem.getAttributeNode !== strundefined && elem.getAttributeNode("id");
                    return node && node.value === attrId;
                };
            };
        }

        // Tag
        Expr.find["TAG"] = support.getElementsByTagName ? function(tag, context) {
            if (typeof context.getElementsByTagName !== strundefined) {
                return context.getElementsByTagName(tag);
            }
        } : function(tag, context) {
            var elem,
            tmp = [],
                i = 0,
                results = context.getElementsByTagName(tag);

            // 过滤注释节点
            if (tag === "*") {
                while ((elem = results[i++])) {
                    if (elem.nodeType === 1) {
                        tmp.push(elem);
                    }
                }

                return tmp;
            }
            return results;
        };

        // Name
        Expr.find["NAME"] = support.getByName && function(tag, context) {
            if (typeof context.getElementsByName !== strundefined) {
                return context.getElementsByName(name);
            }
        };

        // Class
        Expr.find["CLASS"] = support.getElementsByClassName && function(className, context) {
            if (typeof context.getElementsByClassName !== strundefined && documentIsHTML) {
                return context.getElementsByClassName(className);
            }
        };


        rbuggyMatches = [];

        rbuggyQSA = [":focus"];
        //querySelectorAll可以说得上兼容性最差的API,每个浏览器每个版本可能都有差异
        //IE8只支持到CSS2,
        //对于focus伪类,其实现在除opera,safari外,其他浏览器取:focus都正常,
        //但这个东西实在很难在程序来侦测,jQuery选择了一刀切
        if ((support.qsa = isNative(doc.querySelectorAll))) {
            assert(function(div) {
                //对于布尔属性,只要是显式设置了无论值是什么,selected都为false,且通过属性选择器都能选取到
                //这个在IE下有BUG
                div.innerHTML = "<select><option selected=''></option></select>";
                //如果为零,则把常见的布尔属性都放到buggy列表中
                // IE8 - Some boolean attributes are not treated correctly
                if (!div.querySelectorAll("[selected]").length) {
                    rbuggyQSA.push("\\[" + whitespace + "*(?:checked|disabled|ismap|multiple|readonly|selected|value)");
                }
                //根据W3C标准,:checked应该包含被选中的option元素,IE8失败
                // Webkit/Opera - :checked should return selected option elements
                // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
                if (!div.querySelectorAll(":checked").length) {
                    rbuggyQSA.push(":checked");
                }
            });

            assert(function(div) {
                //如果属性值为空字符串,那么对于^= $= *=等操作符直接返回false,不会被匹配,opera10-12/IE8都不正确
                div.innerHTML = "<input type='hidden' i=''/>";
                if (div.querySelectorAll("[i^='']").length) {
                    rbuggyQSA.push("[*^$]=" + whitespace + "*(?:\"\"|'')");
                }
                //firefox3.5无法对隐藏元素取:enabled/:disabled伪类,而IE8则直接抛错
                if (!div.querySelectorAll(":enabled").length) {
                    rbuggyQSA.push(":enabled", ":disabled");
                }

                // Opera 10-11对于非法伪类不会抛错 
                div.querySelectorAll("*,:x");
                rbuggyQSA.push(",.*:");
            });
        }
        //判定是否支持matchesSelector,如果不支持,看它是否存在带私有前缀的近亲
        if ((support.matchesSelector = isNative((matches = docElem.matchesSelector || docElem.mozMatchesSelector || docElem.webkitMatchesSelector || docElem.oMatchesSelector || docElem.msMatchesSelector)))) {

            assert(function(div) {
                //IE9缓存过度,能匹配移出DOM树的节点
                support.disconnectedMatch = matches.call(div, "div");
                //Gecko对于非法选择符不会抛错,而是返回false
                matches.call(div, "[s!='']:x");
                rbuggyMatches.push("!=", pseudos);
            });
        }

        rbuggyQSA = new RegExp(rbuggyQSA.join("|"));
        rbuggyMatches = rbuggyMatches.length && new RegExp(rbuggyMatches.join("|"));
        //重写contains,有原生API就用原生API,否则就遍历DOM树
        contains = isNative(docElem.contains) || docElem.compareDocumentPosition ? function(a, b) {
            var adown = a.nodeType === 9 ? a.documentElement : a,
                bup = b && b.parentNode;
            return a === bup || !! (bup && bup.nodeType === 1 && (
            adown.contains ? adown.contains(bup) : a.compareDocumentPosition && a.compareDocumentPosition(bup) & 16));
        } : function(a, b) {
            if (b) {
                while ((b = b.parentNode)) {
                    if (b === a) {
                        return true;
                    }
                }
            }
            return false;
        };

        // 重写比较函数
        sortOrder = function(a, b) {
            //略
        }
    };
    //判定这些元素是否匹配expr
    Sizzle.matches = function(expr, elements) {
        return Sizzle(expr, null, null, elements);
    };

    Sizzle.matchesSelector = function(elem, expr) {
        // Set document vars if needed
        if ((elem.ownerDocument || elem) !== document) {
            setDocument(elem);
        }
        //IE9的querySelectorAll要求属性选择器的值必须被引起来
        expr = expr.replace(rattributeQuotes, "='$1']");
        //优化使用原生API
        if (support.matchesSelector && documentIsHTML && (!rbuggyMatches || !rbuggyMatches.test(expr)) && !rbuggyQSA.test(expr)) {
            try {
                var ret = matches.call(elem, expr);
                if (ret || support.disconnectedMatch || elem.document && elem.document.nodeType !== 11) {
                    return ret;
                }
            } catch (e) {}
        }

        return Sizzle(expr, document, null, [elem]).length > 0;
    };

    Sizzle.contains = function(context, elem) {
        // Set document vars if needed
        if ((context.ownerDocument || context) !== document) {
            setDocument(context);
        }
        return contains(context, elem);
    };

    Sizzle.attr = function(elem, name) {
        var val;

        // Set document vars if needed
        if ((elem.ownerDocument || elem) !== document) {
            setDocument(elem);
        }
        //HTML统一对属性名小写化
        if (documentIsHTML) {
            name = name.toLowerCase();
        }
        if ((val = Expr.attrHandle[name])) {
            return val(elem);
        }
        if (!documentIsHTML || support.attributes) {
            return elem.getAttribute(name);
        }
        return ((val = elem.getAttributeNode(name)) || elem.getAttribute(name)) && elem[name] === true ? name : val && val.specified ? val.value : null;
    };

    Sizzle.error = function(msg) {
        throw new Error("Syntax error, unrecognized expression: " + msg);
    };

    Sizzle.uniqueSort = function(results) {
        //去重排序
        var elem,
        duplicates = [],
            j = 0,
            i = 0;

        // Unless we *know* we can detect duplicates, assume their presence
        hasDuplicate = !support.detectDuplicates;
        // Compensate for sort limitations
        recompare = !support.sortDetached;
        sortInput = !support.sortStable && results.slice(0);
        results.sort(sortOrder);

        if (hasDuplicate) {
            while ((elem = results[i++])) {
                if (elem === results[i]) {
                    j = duplicates.push(i);
                }
            }
            while (j--) {
                results.splice(duplicates[j], 1);
            }
        }

        return results;
    };


    function siblingCheck(a, b) {
        //比较同一个父亲下,两个元素节点的先后顺序
        var cur = b && a,
            diff = cur && (~b.sourceIndex || MAX_NEGATIVE) - (~a.sourceIndex || MAX_NEGATIVE);

        // Use IE sourceIndex if available on both nodes
        if (diff) {
            return diff;
        }
        // Check if b follows a
        if (cur) {
            while ((cur = cur.nextSibling)) {
                if (cur === b) {
                    return -1;
                }
            }
        }

        return a ? 1 : -1;
    }

    //创建一个伪类的过滤函数,此方法是根据表单元素的type值生成
    //比如:radio, :text, :checkbox, :file, :image等自定义伪类

    function createInputPseudo(type) {
        return function(elem) {
            var name = elem.nodeName.toLowerCase();
            return name === "input" && elem.type === type;
        };
    }

    //创建一个伪类的过滤函数,此方法是根据表单元素的type值或标签类型生成
    //如果:button, :submit自定义伪类

    function createButtonPseudo(type) {
        return function(elem) {
            var name = elem.nodeName.toLowerCase();
            return (name === "input" || name === "button") && elem.type === type;
        };
    }

    //用于创建位置伪类的过滤函数,它们是模拟从左向右的顺序进行选择,
    //匹配到它时的结果集的位置来挑选元素的
    //比如:odd,:even, :eq, :gt, :lt, :first, :last

    function createPositionalPseudo(fn) {
        return markFunction(function(argument) {
            argument = +argument;
            return markFunction(function(seed, matches) {
                var j,
                matchIndexes = fn([], seed.length, argument),
                    i = matchIndexes.length;

                while (i--) {
                    if (seed[(j = matchIndexes[i])]) {
                        seed[j] = !(matches[j] = seed[j]);
                    }
                }
            });
        });
    }

    /**
     * Utility function for retrieving the text value of an array of DOM nodes
     * @param {Array|Element} elem
     */
    //用于:contains伪类,用于匹配当前元素的textConten是否包含目标字符串
    //但对于XML,则需要逐个取得它里面的文本节点,CDATA节点的nodeValue进行拼接了
    getText = Sizzle.getText = function(elem) {
        var node,
        ret = "",
            i = 0,
            nodeType = elem.nodeType;

        if (!nodeType) {
            // If no nodeType, this is expected to be an array
            for (;
            (node = elem[i]); i++) {
                // Do not traverse comment nodes
                ret += getText(node);
            }
        } else if (nodeType === 1 || nodeType === 9 || nodeType === 11) {

            if (typeof elem.textContent === "string") {
                return elem.textContent;
            } else {
                // Traverse its children
                for (elem = elem.firstChild; elem; elem = elem.nextSibling) {
                    ret += getText(elem);
                }
            }
        } else if (nodeType === 3 || nodeType === 4) {
            return elem.nodeValue;
        }
        // Do not include comment or processing instruction nodes

        return ret;
    };

    Expr = Sizzle.selectors = {
        // Can be adjusted by the user
        cacheLength: 50,
        createPseudo: markFunction,
        match: matchExpr,
        find: {},
        relative: {
            ">": {
                dir: "parentNode",
                first: true
            },
            " ": {
                dir: "parentNode"
            },
            "+": {
                dir: "previousSibling",
                first: true
            },
            "~": {
                dir: "previousSibling"
            }
        },
        preFilter: {
            //预处理,有的选择器,比如属性选择器与伪类从选择器组分割出来,还要再细分
            //属性选择器要切成属性名,属性值,操作符;伪类要切为类型与传参;
            //子元素过滤伪类还要根据an+b的形式再划分
            "ATTR": function(match) {
                match[1] = match[1].replace(runescape, funescape);

                // Move the given value to match[3] whether quoted or unquoted
                match[3] = (match[4] || match[5] || "").replace(runescape, funescape);

                if (match[2] === "~=") {
                    match[3] = " " + match[3] + " ";
                }

                return match.slice(0, 4);
            },
            "CHILD": function(match) {
                //将它的伪类名称与传参拆分为更细的单元,以数组形式返回
                //比如 ":nth-child(even)"变为
                //["nth","child","even", 2, 0, undefined, undefined, undefined]
            },
            "PSEUDO": function(match) {
                //将它的伪类名称与传参进行再处理
                //比如:contains伪类会去掉两边的引号,反义伪类括号部分会再次提取
            }
        },
        filter: {
            //过滤函数(它们基本上都是curry)
            "TAG": function(nodeName) { //标签选择器
                if (nodeName === "*") {
                    return function() {
                        return true;
                    };
                }

                nodeName = nodeName.replace(runescape, funescape).toLowerCase();
                return function(elem) {
                    return elem.nodeName && elem.nodeName.toLowerCase() === nodeName;
                };
            },
            "CLASS": function(className) { //类选择器,创建一个正则进行匹配
                var pattern = classCache[className + " "];

                return pattern || (pattern = new RegExp("(^|" + whitespace + ")" + className + "(" + whitespace + "|$)")) && classCache(className, function(elem) {
                    return pattern.test(elem.className || (typeof elem.getAttribute !== strundefined && elem.getAttribute("class")) || "");
                });
            },
            "ATTR": function(name, operator, check) {
                return function(elem) { //属性选择器
                    var result = Sizzle.attr(elem, name);

                    if (result == null) {
                        return operator === "!=";
                    }
                    if (!operator) {
                        return true;
                    }

                    result += "";
                    //这里的三目运算符套嵌得非常复杂,可以参看一下EXT的DOMQuery或mass的Icarus的实现
                    return operator === "=" ? result === check : operator === "!=" ? result !== check : operator === "^=" ? check && result.indexOf(check) === 0 : operator === "*=" ? check && result.indexOf(check) > -1 : operator === "$=" ? check && result.slice(-check.length) === check : operator === "~=" ? (" " + result + " ").indexOf(check) > -1 : operator === "|=" ? result === check || result.slice(0, check.length + 1) === check + "-" : false;
                };
            },
            "CHILD": function(type, what, argument, first, last) {
                //这里处理子元素过滤伪类,如:nth-child, :first-child, :only-child
            },
            "PSEUDO": function(pseudo, argument) {
                //这里各种伪类,分派给上方的"CHILD"与下方的"pseudos"去处理
            }
        },
        pseudos: {
            //这里包含各种伪类的过滤函数
            //如:not,:lang,:target,:root,:enabled,:disabled,:checked, :empty(原生伪类)
            //parent, :has,:contains(源自xpath的自定义伪类)
            // :header,:input,:text,:radio,:checkbox,:submit,:reset,
            // :file,:password,:image(自定义标签伪类)
            // :last,:first,:last, :eq, :even, :odd, :lt,:gt(自定义位置伪类)
        }
    };


    function tokenize(selector, parseOnly) {
        var matched, match, tokens, type,
        soFar, groups, preFilters,
        cached = tokenCache[selector + " "];
//先查看缓存了没有
        if (cached) {
            return parseOnly ? 0 : cached.slice(0);
        }
        soFar = selector;
        groups = [];//这是最后要返回的结果,一个二维数组
        //比如"title,div > :nth-child(even)"解析下面的符号流
        // [ [{value:"title",type:"TAG",matches:["title"]}],
        //   [{value:"div",type:["TAG",matches:["div"]},
        //    {value:">", type: ">"},
        //    {value:":nth-child(even)",type:"CHILD",matches:["nth",
        //     "child","even",2,0,undefined,undefined,undefined]}
        //   ] 
        // ]
        //有多少个并联选择器,里面就有多少个数组,数组里面是拥有value与type的对象
        preFilters = Expr.preFilter;
        while (soFar) {
            // 以第一个逗号切割选择符,然后去掉前面的部分
            if (!matched || (match = rcomma.exec(soFar))) {
                if (match) {
                    // Don't consume trailing commas as valid
                    soFar = soFar.slice(match[0].length) || soFar;
                }
                groups.push(tokens = []);
            }

            matched = false;
            //将刚才前面的部分以关系选择器再进行划分
            if ((match = rcombinators.exec(soFar))) {
                matched = match.shift();
                tokens.push({
                    value: matched,
                    // Cast descendant combinators to space
                    type: match[0].replace(rtrim, " ")
                });
                soFar = soFar.slice(matched.length);
            }
            //将每个选择器组依次用ID,TAG,CLASS,ATTR,CHILD,PSEUDO这些正则进行匹配
            for (type in Expr.filter) {//preFilters是用于分析选择器的名字与参数
                if ((match = matchExpr[type].exec(soFar)) && (!preFilters[type] || (match = preFilters[type](match)))) {
                    matched = match.shift();
                    tokens.push({
                        value: matched,
                        type: type,
                        matches: match
                    });
                    soFar = soFar.slice(matched.length);
                }
            }
            if (!matched) {
                break;
            }
        }
        return parseOnly ? soFar.length : soFar ? Sizzle.error(selector) :
        // 放到tokenCache函数里进行缓存
        tokenCache(selector, groups).slice(0);
    }

    function toSelector(tokens) {
        var i = 0,//将符合流重新组合成选择符,这时能把多余的空白去掉
            len = tokens.length,
            selector = "";
        for (; i < len; i++) {
            selector += tokens[i].value;
        }
        return selector;
    }

    function addCombinator(matcher, combinator, base) {
        var dir = combinator.dir,
            checkNonElements = base && dir === "parentNode",
            doneName = done++;

        return combinator.first ?
        // Check against closest ancestor/preceding element

        function(elem, context, xml) {
            while ((elem = elem[dir])) {
                if (elem.nodeType === 1 || checkNonElements) {
                    return matcher(elem, context, xml);
                }
            }
        } :
        // Check against all ancestor/preceding elements

        function(elem, context, xml) {
            var data, cache, outerCache,
            dirkey = dirruns + " " + doneName;

            // We can't set arbitrary data on XML nodes, so they don't benefit from dir caching
            if (xml) {
                while ((elem = elem[dir])) {
                    if (elem.nodeType === 1 || checkNonElements) {
                        if (matcher(elem, context, xml)) {
                            return true;
                        }
                    }
                }
            } else {
                while ((elem = elem[dir])) {
                    if (elem.nodeType === 1 || checkNonElements) {
                        outerCache = elem[expando] || (elem[expando] = {});
                        if ((cache = outerCache[dir]) && cache[0] === dirkey) {
                            if ((data = cache[1]) === true || data === cachedruns) {
                                return data === true;
                            }
                        } else {
                            cache = outerCache[dir] = [dirkey];
                            cache[1] = matcher(elem, context, xml) || cachedruns;
                            if (cache[1] === true) {
                                return true;
                            }
                        }
                    }
                }
            }
        };
    }

    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];
    }

    function condense(unmatched, map, filter, context, xml) {
        var elem,
        newUnmatched = [],
            i = 0,
            len = unmatched.length,
            mapped = map != null;

        for (; i < len; i++) {
            if ((elem = unmatched[i])) {
                if (!filter || filter(elem, context, xml)) {
                    newUnmatched.push(elem);
                    if (mapped) {
                        map.push(i);
                    }
                }
            }
        }

        return newUnmatched;
    }

    function setMatcher(preFilter, selector, matcher, postFilter, postFinder, postSelector) {
        if (postFilter && !postFilter[expando]) {
            postFilter = setMatcher(postFilter);
        }
        if (postFinder && !postFinder[expando]) {
            postFinder = setMatcher(postFinder, postSelector);
        }
        return markFunction(function(seed, results, context, xml) {
            var temp, i, elem,
            preMap = [],
                postMap = [],
                preexisting = results.length,
                // Get initial elements from seed or context
                elems = seed || multipleContexts(selector || "*", context.nodeType ? [context] : context, []),
                // Prefilter to get matcher input, preserving a map for seed-results synchronization
                matcherIn = preFilter && (seed || !selector) ? condense(elems, preMap, preFilter, context, xml) : elems,
                matcherOut = matcher ?
                // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,
                postFinder || (seed ? preFilter : preexisting || postFilter) ?
                // ...intermediate processing is necessary
                [] :
                // ...otherwise use results directly
                results : matcherIn;

            // Find primary matches
            if (matcher) {
                matcher(matcherIn, matcherOut, context, xml);
            }

            // Apply postFilter
            if (postFilter) {
                temp = condense(matcherOut, postMap);
                postFilter(temp, [], context, xml);

                // Un-match failing elements by moving them back to matcherIn
                i = temp.length;
                while (i--) {
                    if ((elem = temp[i])) {
                        matcherOut[postMap[i]] = !(matcherIn[postMap[i]] = elem);
                    }
                }
            }

            if (seed) {
                if (postFinder || preFilter) {
                    if (postFinder) {
                        // Get the final matcherOut by condensing this intermediate into postFinder contexts
                        temp = [];
                        i = matcherOut.length;
                        while (i--) {
                            if ((elem = matcherOut[i])) {
                                // Restore matcherIn since elem is not yet a final match
                                temp.push((matcherIn[i] = elem));
                            }
                        }
                        postFinder(null, (matcherOut = []), temp, xml);
                    }

                    // Move matched elements from seed to results to keep them synchronized
                    i = matcherOut.length;
                    while (i--) {
                        if ((elem = matcherOut[i]) && (temp = postFinder ? indexOf.call(seed, elem) : preMap[i]) > -1) {

                            seed[temp] = !(results[temp] = elem);
                        }
                    }
                }

                // Add elements to results, through postFinder if defined
            } else {
                matcherOut = condense(
                matcherOut === results ? matcherOut.splice(preexisting, matcherOut.length) : matcherOut);
                if (postFinder) {
                    postFinder(null, results, matcherOut, xml);
                } else {
                    push.apply(results, matcherOut);
                }
            }
        });
    }

    function matcherFromTokens(tokens) {
       //生成用于匹配单个选择器组的函数
    }

    function matcherFromGroupMatchers(elementMatchers, setMatchers) {
      //生成用于匹配单个选择器群组的函数
    }

    compile = Sizzle.compile = function(selector, group /* Internal Use Only */ ) {
        var i,
        setMatchers = [],
            elementMatchers = [],
            cached = compilerCache[selector + " "];

        if (!cached) {
            // Generate a function of recursive functions that can be used to check each element
            if (!group) {
                group = tokenize(selector);
            }
            i = group.length;
            while (i--) {
            //比如div:not(.aaa)跑到这里,group只剩下
            //[[{value:":not(.aaa)",type:"PSEUDO",matches:["not","aaa"]}]
                cached = matcherFromTokens(group[i]);
                if (cached[expando]) {
                    setMatchers.push(cached);
                } else {
                    elementMatchers.push(cached);
                }
            }

            // Cache the compiled function
            cached = compilerCache(selector, matcherFromGroupMatchers(elementMatchers, setMatchers));
        }
        return cached;
    };

    function multipleContexts(selector, contexts, results) {
        var i = 0,
            len = contexts.length;
        for (; i < len; i++) {
            Sizzle(selector, contexts[i], results);
        }
        return results;
    }

    function select(selector, context, results, seed) {
        var i, tokens, token, type, find,
        match = tokenize(selector);

        if (!seed) {
            // Try to minimize operations if there is only one group
            if (match.length === 1) {//如果只有一个选择器群组

                tokens = match[0] = match[0].slice(0);
                //如果里面包含ID选择器, 比如#aaa > div
                if (tokens.length > 2 && (token = tokens[0]).type === "ID" && context.nodeType === 9 && documentIsHTML && Expr.relative[tokens[1].type]) {
                    context = (Expr.find["ID"](token.matches[0].replace(runescape, funescape), context) || [])[0];
                    if (!context) {//如果最左边的那个祖先都不存在,那么就不用找下去了
                        return results;
                    }
                   //将最初的选择符去掉ID选择器 --->  " > div"
                    selector = selector.slice(tokens.shift().value.length);
                }
                // Fetch a seed set for right-to-left matching
                i = matchExpr["needsContext"].test(selector) ? 0 : tokens.length;
                while (i--) {
                    token = tokens[i];

                    // Abort if we hit a combinator
                    if (Expr.relative[(type = token.type)]) {
                        break;
                    }
                     //find查找器有ID,TAG,NAME,CLASS,都是对应原生API,比如div:not(.aaa),div就优先被处理了
                    if ((find = Expr.find[type])) {
                        //如果tokens[0].type为关系选择器,则往上找一级,用其父节点作上下文
                        if ((seed = find(
                        token.matches[0].replace(runescape, funescape),
                        rsibling.test(tokens[0].type) && context.parentNode || context))) {
                            //然后去掉用过的选择器,比如上例中的div
                            tokens.splice(i, 1);
                            selector = seed.length && toSelector(tokens);
                            if (!selector) {//如果选择符为空白,那么将种子集合并到结构集中
                                push.apply(results, seed);
                                return results;
                            }

                            break;
                        }
                    }
                }
            }
        }

        // Compile and execute a filtering function
        // Provide `match` to avoid retokenization if we modified the selector above
        compile(selector, match)(
        seed,
        context, !documentIsHTML,
        results,
        rsibling.test(selector));
        return results;
    }

    // Deprecated
    Expr.pseudos["nth"] = Expr.pseudos["eq"];

    // Easy API for creating new setFilters

    function setFilters() {}
    setFilters.prototype = Expr.filters = Expr.pseudos;
    Expr.setFilters = new setFilters();


    //判定稳定性
    //http://www.iteye.com/topic/714688
    // Array.prototype.sort在不同浏览器中表现可能不一致。 
    //var arr =[{id:1, value:'a'},{id:1, value:'b'},{id:1, value:'c'}]; 
    //var arr = arr.sort(function(a,b){return b.id-a.id}); 
    //for(var n=0,m=arr.length;n<m;n++){ 
    //  alert(arr[n].value); 
    //} 
    //以上代码在Chrome执行,将得到c,b,a。 
    //而在其他浏览器(IE6/7/8,FF3,Opera10,Safari5)中,得到a,b,c。 
    //不强制参与排序的元素保持原来的顺序(可以不稳定)。实际上Chrome对比较后相等的元素进行了交换操作,而其他的JS引擎没有这么做。 
    support.sortStable = expando.split("").sort(sortOrder).join("") === expando;

    // Initialize with the default document
    setDocument();

    // Always assume the presence of duplicates if sort doesn't
    // pass them to our comparison function (as in Google Chrome).
    [0, 0].sort(sortOrder);
    support.detectDuplicates = hasDuplicate;

    // EXPOSE
    if (typeof define === "function" && define.amd) {
        define(function() {
            return Sizzle;
        });
    } else {
        window.Sizzle = Sizzle;
    }
    // EXPOSE

})(window);
机器瞎学/数据掩埋/模式混淆/人工智障/深度遗忘/神经掉线/计算机幻觉/专注单身二十五年
原文地址:https://www.cnblogs.com/rubylouvre/p/2943666.html