jQuery原始碼學習之$()

盪漾發表於2018-07-21

jQuery之$()

一般我們使用jQuery的時候,都是使用$()$指向全域性的jQuery,所以其實是呼叫了jQuery(),結果是返回一個jq物件,但我們使用時卻不需使用new建立物件,所以可以推測$()是一個工廠函式。

$()的定義

jQuery()src/core.js中定義,若在該方法中呼叫return new jQuery()則陷入迴圈,所以呼叫init()協助構造例項。值得一提的是,jQuery.fn/src/core.js指向了jQuery.prototype

    // Define a local copy of jQuery
    jQuery = function( selector, context ) {

        // The jQuery object is actually just the init constructor `enhanced`
        // Need init if jQuery is called (just allow error to be thrown if not included)
        return new jQuery.fn.init( selector, context );
    }

init方法的定義

jQuery.fn.init()src/core/init.js中定義。方法接受三個引數selector, context, root,在方法內部,先判斷是否有引數,無引數時返回false

    init = jQuery.fn.init = function( selector, context, root ) {
        var match, elem;

        // HANDLE: $(""), $(null), $(undefined), $(false)
        if ( !selector ) {
            return this;
        }

        // Method init() accepts an alternate rootjQuery
        // so migrate can support jQuery.sub (gh-2101)
        root = root || rootjQuery;

        // Handle HTML strings
        // < xxx > 或 $(#id)
        if ( typeof selector === "string" ) {
            if ( selector[ 0 ] === "<" &&
                selector[ selector.length - 1 ] === ">" &&
                selector.length >= 3 ) {

                // Assume that strings that start and end with <> are HTML and skip the regex check
                match = [ null, selector, null ];

            } else {
                // match[1]是html字串,match[2]是匹配元素的id
                // selector是id選擇器時match[1]為undefined,match[2]是匹配元素的id
                // selector是html字串,match[1]是html字串,match[2]為undefined
                match = rquickExpr.exec( selector );
            }

            // Match html or make sure no context is specified for #id
            // 匹配結果非空 且 存在匹配字串或context空時執行
            // 未為id選擇器限定查詢範圍
            if ( match && ( match[ 1 ] || !context ) ) {

                // HANDLE: $(html) -> $(array)
                if ( match[ 1 ] ) {
                    context = context instanceof jQuery ? context[ 0 ] : context;

                    // Option to run scripts is true for back-compat
                    // Intentionally let the error be thrown if parseHTML is not present
                    // 生成dom節點併合併到this上
                    jQuery.merge( this, jQuery.parseHTML(
                        match[ 1 ],
                        context && context.nodeType ? context.ownerDocument || context : document,
                        true
                    ) );

                    // HANDLE: $(html, props)
                    // 遍歷props,新增屬性或方法
                    if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) {
                        for ( match in context ) {

                            // Properties of context are called as methods if possible
                            if ( jQuery.isFunction( this[ match ] ) ) {
                                this[ match ]( context[ match ] );

                            // ...and otherwise set as attributes
                            } else {
                                this.attr( match, context[ match ] );
                            }
                        }
                    }

                    return this;

                // HANDLE: $(#id)
                // 處理id選擇器且無context
                } else {
                    elem = document.getElementById( match[ 2 ] );

                    if ( elem ) {

                        // Inject the element directly into the jQuery object
                        this[ 0 ] = elem;
                        this.length = 1;
                    }
                    return this;
                }

            // HANDLE: $(expr, $(...))
            // selector是選擇器 context為undefined或context.jquery存在時執行。
            // $(#id,context)或$(.class [, context])等情況
            } else if ( !context || context.jquery ) {
                return ( context || root ).find( selector );

            // HANDLE: $(expr, context)
            // (which is just equivalent to: $(context).find(expr)
            } else {
                return this.constructor( context ).find( selector );
            }

        // HANDLE: $(DOMElement)
        // 傳入DOM元素
        } else if ( selector.nodeType ) {
            this[ 0 ] = selector;
            this.length = 1;
            return this;

        // HANDLE: $(function)
        // Shortcut for document ready
        } else if ( jQuery.isFunction( selector ) ) {
            return root.ready !== undefined ?
                root.ready( selector ) :

                // Execute immediately if ready is not present
                selector( jQuery );
        }

        return jQuery.makeArray( selector, this );
    };

selector是字串

如果有selector非空,先處理selector是字串的情況,分為html字串、$(selector)$(expr, $(...))$(expr, context)四種。如果selector是字串型別,根據傳入的字串返回生成的dom節點,處理時先用正則匹配,查詢html字串或id。匹配結果非空且存在匹配字串或context空時說明selctor是html字串或selector是id選擇器且未限定查詢上下文。執行處理html字串時,先確定生成後的節點要插入的document是哪個(即context引數),預設是載入jQuery的document,呼叫$.parseHTML()生成dom節點並新增到this;如果context是物件,則是$(html, props)的呼叫,將屬性或者方法掛載到dom上,返回生成的jq物件。如果匹配到$(#id)的呼叫且context空時,則直接呼叫document.getElementById查詢元素,元素存在時將this[0]指向該元素,返回查詢結果。

如果selector不是id選擇器或context非空,呼叫find進行查詢,如果context非空,則從context開始查詢,否則全域性查詢,將查詢結果作為返回值。

selector是DOM元素

接著處理傳入引數是Dom元素的情況。將this[0]指向Dom元素,設定jq物件長度為1,並返回this

selector是函式

最後處理$(function(){}),如果存在ready則呼叫傳入函式呼叫ready(f()),否則傳入jQuery,直接呼叫函式,呼叫makeArray,將其結果作為返回值。

修改init的原型

init = jQuery.fn.init = function( selector, context, root ) {
    ...
    }
// Give the init function the jQuery prototype for later instantiation
init.prototype = jQuery.fn;

在原型上定義方法init,然後將init的原型指向jQuery的原型,如果不這麼做,則建立的例項的原型是init.prototype,不是jQuery.fn,其實是init的例項而不是jQuery的例項,無法呼叫在core.js中定義在jQuery.fn上的各種變數和方法。

相關文章