jQuery3.0的domManip浅析

domManip 这个函数的历史由来已久，从 jQuery 1.0 版本开始便存在了，一直到最新的 jQuery 版本。可谓是元老级工具函数。

domManip 的主要功能是为了实现 DOM 的插入和替换。具体共为以下 5 个函数服务

• 内部后插入（append）
• 内部前插入（prepend）
• 外部前插入（before）
• 外部后插入（after）
• 替换元素 （replaceWith，1.9.x 之前的版本没有使用 domMainp）

而一个 each 就生成了另外 5 个函数：appendTo、prependTo、insertBefore、insertAfter、replaceAll

jQuery.each( {
	appendTo: "append",
	prependTo: "prepend",
	insertBefore: "before",
	insertAfter: "after",
	replaceAll: "replaceWith"
}, function( name, original ) {
	jQuery.fn[ name ] = function( selector ) {
		var elems,
			ret = [],
			insert = jQuery( selector ),
			last = insert.length - 1,
			i = 0;

		for ( ; i <= last; i++ ) {
			elems = i === last ? this : this.clone( true );
			jQuery( insert[ i ] )[ original ]( elems );

			// Support: Android <=4.0 only, PhantomJS 1 only
			// .get() because push.apply(_, arraylike) throws on ancient WebKit
			push.apply( ret, elems.get() );
		}

		return this.pushStack( ret );
	};
} );

如图

内部调用如图

源码

append: function() {
	return domManip( this, arguments, function( elem ) {
		if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
			var target = manipulationTarget( this, elem );
			target.appendChild( elem );
		}
	} );
},
prepend: function() {
	return domManip( this, arguments, function( elem ) {
		if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
			var target = manipulationTarget( this, elem );
			target.insertBefore( elem, target.firstChild );
		}
	} );
},
before: function() {
	return domManip( this, arguments, function( elem ) {
		if ( this.parentNode ) {
			this.parentNode.insertBefore( elem, this );
		}
	} );
},
after: function() {
	return domManip( this, arguments, function( elem ) {
		if ( this.parentNode ) {
			this.parentNode.insertBefore( elem, this.nextSibling );
		}
	} );
},
replaceWith: function() {
	var ignored = [];

	// Make the changes, replacing each non-ignored context element with the new content
	return domManip( this, arguments, function( elem ) {
		var parent = this.parentNode;

		if ( jQuery.inArray( this, ignored ) < 0 ) {
			jQuery.cleanData( getAll( this ) );
			if ( parent ) {
				parent.replaceChild( elem, this );
			}
		}

	// Force callback invocation
	}, ignored );
}

domManip 的实现

domManip 的主要功能就是添加 DOM 元素，因为添加的位置不同而提供了四个公开函数 append、prepend、before、after，此外还有一个 replaceWith。简单说 domManip 就做了两件事

1. 先完成 DOM 节点添加
2. 如果添加的 DOM 节点内有 script 标签，需要额外处理下。对于可执行的 script （通过type属性判断）则执行其内的脚本代码，其它的则不执行。

domManip 依赖的一个重要函数就是 buildFragment，为 DOM 插入提高了性能。

domManip 内对 script 节点元素做了特殊处理

1. script 无 type 属性，默认会执行其内的 JS 脚本
2. script 的 type="text/javascript" 或 type="text/ecmascript" ，会执行其内的 JS 脚本
3. script 如果有 src 属性，会执行 $._evalUrl 请求远程的 JS 文件并执行
4. 其它不会执行 JS 脚本，有时我们会用 script 来做 html 模板，如 underscore.js，type="text/template" 或 type="text/plain" 这种，其内的 JS 都不会被执行

此外 dataPriv.access( node, "globalEval" )，这一句标示了如果该 script 已经执行过，则不会再次执行。或者说执行后会设置一个 globalEval: true 的标示。

domManip 内部依赖 buildFragment、restoreScript、disableScript、jQuery._evalUrl、DOMEval 这几个小函数，而 restoreScript、jQuery._evalUrl 也仅在 domManip 用到。

// Replace/restore the type attribute of script elements for safe DOM manipulation
function disableScript( elem ) {
	elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type;
	return elem;
}
function restoreScript( elem ) {
	var match = rscriptTypeMasked.exec( elem.type );

	if ( match ) {
		elem.type = match[ 1 ];
	} else {
		elem.removeAttribute( "type" );
	}

	return elem;
}
jQuery._evalUrl = function( url ) {
	return jQuery.ajax( {
		url: url,

		// Make this explicit, since user can override this through ajaxSetup (#11264)
		type: "GET",
		dataType: "script",
		cache: true,
		async: false,
		global: false,
		"throws": true
	} );
};

domManip 经历了各个版本的演变

1. 3.0.x 之前版本的 domManip 函数是挂在 jQuery 对象上面的（jQuery.fn.domManip），即通过 $().domManip 方式可以访问；3.0.x 后 domManip 是一个私有函数，外部无法访问
2. 1.2.x 之前 domManip 有 4 个参数；1.3.x ~ 1.9.x 是 3 个参数；2.x 只有 2 个参数；3.x 有 4 个参数
3. 1.9.x 之前的版本 replaceWith 没有使用 domMainp