2.3.4 生成 DOM 元素

jQuery.fn.init() 构造函数能够构建 jQuery 对象,并把匹配的 DOM 元素存储在 jQuery 对象内部集合中。jQuery.fn.init() 构造函数可以接收单个的 DOM 元素,也可以接收 DOM 集合。如果接收的是字符串型 ID 值,则直接在文档中查找对应的 DOM 元素,并把它传递给 jQuery 对象;如果接收的是字符串型 HTML 片段,则需要把这个字符串片段生成 DOM 元素。下面我们将重点分析 jQuery 是如何把 HTML 片段生成 DOM 元素的。

在2.3.3节中,我们可以看到 jQuery.fn.init() 构造器通过 jQuery.clean([match[1], context]); 语句实现把 HTML 片段生成 DOM 元素,jQuery.clean() 是一个公共函数。源代码及其注释如下所示。

jQuery.clean() 包含三个参数,其中 elems 和 context 可以支持多种形式的值。Elems 参数可以为数组、类数组、对象结构的形式。数组元素和对象属性可以混合使用。

对于数字类型参数,则会被转换为字符串型,除了字符串型外,其他的都放入返回的数组中,当然对于集合形式只需要读取集合中每个元素即可。

对于字符串型参数,则把它转换成 DOM 元素,再存入返回的数组中。转换的方式是,把 HTML 字符串片段赋值给创建的 div 元素的 innerHTML ,这样就可以把 HTML 字符串片段挂到 DOM 文档树中,从而实现把字符串转换成 DOM  元素。

在转换过程中,应该考虑 HTML 语法约定,因为标签嵌套是有严格限制的,例如,<td> 必须存在 <tr> 中。因此在执行转换前,还应该对 HTML 字符串进行预处理,即修正 HTML 标签不规范的用法,这也是 jQuery.clean() 函数的一个重要工作。

[html] view plaincopy
  1. <script type="text/javascript">  
  2. (function(){  
  3. var   
  4.     window = this,  
  5.     jQuery = window.jQuery = window.$ = function(selector, context){  
  6.         return new jQuery.fn.init(selector, context);  
  7.     },  
  8.     quickExpr = /^[^<]*(<(.|\s)+>)[^>]*$|^#([\w-]+)$/;  
  9.   
  10. jQuery.fn = jQuery.prototype = {  
  11.     init: function(selector, context){  
  12.         selector = selector || document;  
  13.   
  14.         if(typeof selector == "string"){  
  15.             var match = quickExpr.exec(selector);  
  16.   
  17.             if (match && (match[1] || !context)){  
  18.                 // 第二种情况,处理 HTML 字符串,类似 $(html) -> $(array)  
  19.                 if (match[1]){                    
  20.                     selector = jQuery.clean( [ match[1] ], context );  
  21.                 }     
  22.             }  
  23.         }   
  24.     }  
  25. };  
  26. jQuery.fn.init.prototype = jQuery.fn;   
  27.   
  28. // jQuery 功能扩展函数  
  29. jQuery.extend = jQuery.fn.extend = function(obj){  
  30.     for(var prop in obj){  
  31.         this[prop] = obj[prop];  
  32.     }  
  33.     return this;  
  34. };  
  35. // 公共函数扩展  
  36. jQuery.extend({  
  37.     // 参数说明:object 表示 jQuery 对象,callback 表示回调函数, args 回调函数的参数数组  
  38.     each: function(object, callback, args){  
  39.         var name, i=0length = object.length;  
  40.         if(args){     // 如果存在回调函数的参数数组  
  41.             if(length === undefined){ // 如果 object 不是 jQuery 对象  
  42.                 for(name in object){  // 遍历 object 的属性  
  43.                     if(callback.apply( object[name], args ) === false)  
  44.                                         // 在对象上调用回调函数  
  45.                         break;          // 如果回调函数返回值为 false ,则跳出循环  
  46.                 }  
  47.             } else {  
  48.                 for( ; i<length; )       // 遍历 jQuery 对象数组  
  49.                     if(callback.apply( object[i++], args ) === false)  
  50.                                         // 在对象上调用回调函数  
  51.                         break;          // 如果回调函数返回值为 false ,则跳出循环  
  52.             }  
  53.         } else {  
  54.             if(length === undefined){   // 如果 object 不是 jQuery 对象  
  55.                 for(name in object)     // 遍历 object 的属性  
  56.                     if(callback.call(object[name], name, object[name]) === false)  
  57.                         break;          // 如果回调函数返回值为 false ,则跳出循环    
  58.             } else {            // 如果 object 是 jQuery 对象  
  59.                 for(var value = object[0]; // 遍历 jQuery对象数组  
  60.                     i<length && callback.call(value, i, value) !== false; value = object[++i]){}  
  61.             }  
  62.         }  
  63.     },  
  64.     // 把HTML字符串片段转换成 DOM 元素  
  65.     // 参数说明:  
  66.     // elems 参数表示多个 HTML 字符串片段的数据  
  67.     // context 参数表示上下文  
  68.     // fragment 参数表示框架对象  
  69.     clean: function(elems, context, fragment){  
  70.         context = context || document; // 默认的上下文是 document  
  71.         // 在IE中 !context.createElement 是错误用法,因为它返回的是对象类型,而不是逻辑值,  
  72.         // 故通过返回类型进行判断        
  73.         if(typeof context.createElement == "undefined")  
  74.             // 支持 context 为 jQuery 对象,并获取第一个元素  
  75.             context = context.ownerDocument || context[0] && context[0].ownerDocument || document;  
  76.         // 如果仅匹配一个标签,且没有指定框架参数,则直接创建 DOM 元素,并跳过后面的解析  
  77.         if(!fragment && elems.length === 1 && typeof elems[0] === "string") {  
  78.             var match = /^<(\w+)\s*\/?>$/.exec(elems[0]);  
  79.             if ( match )  
  80.                 return [ context.createElement( match[1] ) ];  
  81.         }  
  82.         var ret = [], scripts = [], div = context.createElement("div");  
  83.         // 匹配每一个 HTML 字符串片段,并为每一个片段执行回调函数             
  84.         jQuery.each(elems, function(i, elem){  
  85.             if(typeof elem === "number") // 把数值转换为字符串的高效方法  
  86.                 elem += '';  
  87.             if(!elem) // 如果不存在元素,则返回,或者为 ''、undefined、false 等时也返回  
  88.                 return;  
  89.             // HTML 字符串转换为 DOM 节点  
  90.             if(typeof elem === "string"){  
  91.                 // 统一转换为 XHTML 严谨型文档的标签形式,如 <div/> 的形式修改为 <div></div>  
  92.                 // 但是对于 (abbr|br|col|img|input|link|meta|param|hr|area|embed) 不修改  
  93.                 // front=(<(\w+)[^>]*?)  -- 非贪婪的重复  
  94.                 elem = elem.replace(/(<(\w+)[^>]*?)\/>/g, function(all, front, tag){  
  95.                 // all -- 匹配项  
  96.                 // front -- 第一个捕获组  
  97.                 // tag -- 第二个捕获组  
  98.                     return tag.match(/^(abbr|br|col|img|input|link|meta|param|hr|area|embed)$/i) ?  
  99.                         all :  
  100.                         front + "></" + tag + ">";  
  101.                 });  
  102.                 // 清除空格,否则 indexof 可能会出现不能正常工作 , elem.replace(/^\s+/, "") 清除左侧空格  
  103.                 var tags = elem.replace(/^\s+/, "").substring(0, 10).toLowerCase();  
  104.                 // 有些标签必须是有一些约束的,如 <option> 必须在 <select></select>中间  
  105.                 // 下面代码大部分是对 <table> 中的子元素进行修正。数组中第一个元素为深度  
  106.                 var wrap =   
  107.                     // 约束 <option> ,<opt在开始位置(index=0)就返回&&运算符后面的数组 (!0 返回true)  
  108.                     !tags.indexOf("<opt") &&  
  109.                     [ 1, "<select multiple='multiple'>", "</select>" ] ||  
  110.                     // <leg 必须在 <fieldset> 内部                        
  111.                     !tags.indexOf("<leg") &&  
  112.                     [ 1, "<fieldset>", "</fieldset>" ] ||  
  113.                     // thead|tbody|tfoot|colg|cap 必须在 <table> 内部  
  114.                     tags.match(/^<(thead|tbody|tfoot|colg|cap)/) &&  
  115.                     [ 1, "<table>", "</table>" ] ||  
  116.                     // tr 在 <tbody 中间  
  117.                     !tags.indexOf("<tr") &&  
  118.                     [ 2, "<table><tbody>", "</tbody></table>" ] ||  
  119.                     // td 在 tr 中间  
  120.                     (!tags.indexOf("<td") || !tags.indexOf("<th")) &&  
  121.                     [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ] ||  
  122.                     // col 在 <colgroup> 中间  
  123.                     !tags.indexOf("<col") &&  
  124.                     [ 2, "<table><tbody></tbody><colgroup>", "</colgroup></table>" ] ||  
  125.                     // IE 中 link, script 不能串行化  
  126.                     // IE can't serialize <link> and <script> tags normally  
  127.                     !jQuery.support.htmlSerialize &&  
  128.                     [ 1, "div<div>", "</div>" ] ||  
  129.                     // 默认不修正  
  130.                     [ 0, "", "" ];  
  131.                 // 包裹 HTML 之后,采用 innerHTML 转换成 DOM  
  132.                 div.innerHTML = wrap[1] + elem + wrap[2];  
  133.                 // 转到正确的深度,对于 [1, "<table>", "</table>"], div=<table>  
  134.                 while ( wrap[0]-- )  
  135.                     div = div.lastChild;  
  136.                 // fragments 去掉 IE 对 <table>自动插入的 <tbody>  
  137.                 //if ( !jQuery.support.tbody ) {  
  138.                     // 第一种情况:tags 以 <table> 开头但没有 <tbody>。在IE生成的元素中可能自动加 <tbody>  
  139.                     // 第二种情况:thead|tbody|tfoot|colg|cap 为 tags,那 wrap[1] == "<table>"  
  140.                     // TODO  
  141.                 //}  
  142.                 // 使用 innerHTML ,IE 会去掉开头的空格节点,因此加上去掉的空格节点  
  143.                 // TODO  
  144.                   
  145.                 // elem 从字符转换成了数组  
  146.                 // TODO   
  147.             }  
  148.             // 如果是 DOM 元素,则推入数组,否则就合并数组  
  149.             /*if( elem.nodeType )  
  150.                 ret.push(elem);  
  151.             else  
  152.                 ret = jQuery.merge(ret, elem);*/  
  153.         });  
  154.         // 如果指定了第3个参数,即框架对象,则附加到框架对象上  
  155.         // 这段是新增加的,用来处理 js 代码,同时也取消了 form 的处理  
  156.         if (fragment){  
  157.             // TODO  
  158.         }  
  159.         // 返回 DOM 元素集合  
  160.         return ret;  
  161.     }         
  162. });  
  163.   
  164. })();  
  165.   
  166. window.onload = function(){  
  167.       
  168. var context = document.getElementById("wrap");  
  169. // 测试代码  
  170. $("<option /><div />", context);  
  171.   
  172. };  
  173. </script>  
上面这段代码实际上最后访问的是一个名为 ret 的数组,数组中的元素变为 DOM 元素的对象,而它的 innerHTML 正好就是刚才的 HTML 字符串。

本文转载:CSDN博客