首页 > 语言 > JavaScript > 正文

jQuery选择器源码解读(一):Sizzle方法

2024-05-06 16:17:53
字体:
来源:转载
供稿:网友

这篇文章主要介绍了jQuery选择器源码解读(一):Sizzle方法,本文用详细的注释解读了Sizzle方法的实现源码,需要的朋友可以参考下

对jQuery的Sizzle各方法做了深入分析(同时也参考了一些网上资料)后,将结果分享给大家。我将采用连载的方式,对Sizzle使用的一些方法详细解释一下,每篇文章介绍一个方法。

若需要转载,请写明出处,多谢。
 

  1. /* 
  2. * Sizzle方法是Sizzle选择器包的主要入口,jQuery的find方法就是调用该方法获取匹配的节点 
  3. * 该方法主要完成下列任务: 
  4. * 1、对于单一选择器,且是ID、Tag、Class三种类型之一,则直接获取并返回结果 
  5. * 2、对于支持querySelectorAll方法的浏览器,通过执行querySelectorAll方法获取并返回匹配的DOM元素 
  6. * 3、除上之外则调用select方法获取并返回匹配的DOM元素 
  7.  
  8.  
  9. * @param selector 选择器字符串 
  10. * @param context 执行匹配的最初的上下文(即DOM元素集合)。若context没有赋值,则取document。 
  11. * @param results 已匹配出的部分最终结果。若results没有赋值,则赋予空数组。 
  12. * @param seed 初始集合 
  13. */ 
  14. function Sizzle(selector, context, results, seed) { 
  15. var match, elem, m, nodeType, 
  16. // QSA vars 
  17. i, groups, old, nid, newContext, newSelector; 
  18.  
  19. /* 
  20. * preferredDoc = window.document 
  21.  
  22. * setDocument方法完成一些初始化工作 
  23. */ 
  24. if ((context ? context.ownerDocument || context : preferredDoc) !== document) { 
  25. setDocument(context); 
  26.  
  27. context = context || document; 
  28. results = results || []; 
  29.  
  30. /* 
  31. * 若selector不是有效地字符串类型数据,则直接返回results 
  32. */ 
  33. if (!selector || typeof selector !== "string") { 
  34. return results; 
  35.  
  36. /* 
  37. * 若context既不是document(nodeType=9),也不是element(nodeType=1),那么就返回空集合 
  38. */ 
  39. if ((nodeType = context.nodeType) !== 1 && nodeType !== 9) { 
  40. return []; 
  41.  
  42. // 若当前过滤的是HTML文档,且没有设定seed,则执行if内的语句体 
  43. if (documentIsHTML && !seed) { 
  44.  
  45. /*  
  46. * 若选择器是单一选择器,且是ID、Tag、Class三种类型之一,则直接获取并返回结果 
  47.  
  48. * rquickExpr = /^(?:#([/w-]+)|(/w+)|/.([/w-]+))$/ 
  49. * 上述正则表达式括号内三段依次分别用来判断是否是ID、TAG、CLASS类型的单一选择器 
  50. * 上述正则表达式在最外层圆括号内有三个子表达式(即三个圆括号括起来的部分), 
  51. * 分别代表ID、Tag、Class选择器的值,在下面代码中,分别体现在match[1]、match[2]、match[3] 
  52. */ 
  53. if ((match = rquickExpr.exec(selector))) { 
  54. // Speed-up: Sizzle("#ID") 
  55. // 处理ID类型选择器,如:#ID 
  56. if ((m = match[1])) { 
  57. // 若当前上下文是一个document,则执行if内语句体 
  58. if (nodeType === 9) { 
  59. elem = context.getElementById(m); 
  60. // Check parentNode to catch when Blackberry 4.6 
  61. // returns 
  62. // nodes that are no longer in the document #6963 
  63. if (elem && elem.parentNode) { 
  64. // Handle the case where IE, Opera, and Webkit 
  65. // return items 
  66. // by name instead of ID 
  67. /* 
  68. * 一些老版本的浏览器会把name当作ID来处理, 
  69. * 返回不正确的结果,所以需要再一次对比返回节点的ID属性 
  70. */ 
  71. if (elem.id === m) { 
  72. results.push(elem); 
  73. return results; 
  74. else { 
  75. return results; 
  76. else { 
  77. // Context is not a document 
  78. /* 
  79. * contains(context, elem)用来确认获取的elem是否是当前context对象的子对象 
  80. */ 
  81. if (context.ownerDocument 
  82. && (elem = context.ownerDocument.getElementById(m)) 
  83. && contains(context, elem) && elem.id === m) { 
  84. results.push(elem); 
  85. return results; 
  86.  
  87. // Speed-up: Sizzle("TAG") 
  88. // 处理Tag类型选择器,如:SPAN 
  89. else if (match[2]) { 
  90. push.apply(results, context.getElementsByTagName(selector)); 
  91. return results; 
  92.  
  93. // Speed-up: Sizzle(".CLASS") 
  94. /* 
  95. * 处理class类型选择器,如:.class 
  96. * 下面条件判断分别是: 
  97. * m = match[3]:有效的class类型选择器 
  98. * support.getElementsByClassName 该选择器的div支持getElementsByClassName 
  99. * context.getElementsByClassName 当前上下文节点有getElementsByClassName方法 
  100.  
  101. */ 
  102.  
  103. else if ((m = match[3]) && support.getElementsByClassName 
  104. && context.getElementsByClassName) { 
  105. push.apply(results, context.getElementsByClassName(m)); 
  106. return results; 
  107.  
  108. // QSA path 
  109. /* 
  110. * 若浏览器支持querySelectorAll方法且选择器符合querySelectorAll调用标准,则执行if内语句体 
  111. * 在这里的检查仅仅是简单匹配 
  112. * 第一次调用Sizzle时,rbuggyQSA为空 
  113.  
  114. * if语句体内对当前context对象的id的赋值与恢复,是用来修正querySelectorAll的一个BUG 
  115. * 该BUG会在某些情况下把当前节点(context)也作为结果返回回来。 
  116. * 具体方法是,在现有的选择器前加上一个属性选择器:[id=XXX], 
  117. * XXX 为context的id,若context本身没有设置id,则给个默认值expando。 
  118. */ 
  119.  
  120. if (support.qsa && (!rbuggyQSA || !rbuggyQSA.test(selector))) { 
  121. nid = old = expando; 
  122. newContext = context; 
  123. // 若context是document,则newSelector取自selector,否则为false 
  124. newSelector = nodeType === 9 && selector; 
  125.  
  126. // qSA works strangely on Element-rooted queries 
  127. // We can work around this by specifying an extra ID on the 
  128. // root 
  129. // and working up from there (Thanks to Andrew Dupont for 
  130. // the technique) 
  131. // IE 8 doesn't work on object elements 
  132. if (nodeType === 1 && context.nodeName.toLowerCase() !== "object") { 
  133. groups = tokenize(selector); 
  134.  
  135. if ((old = context.getAttribute("id"))) { 
  136. /* 
  137. * rescape = /'|///g, 
  138. * 这里将old中的单引号、竖杠、反斜杠前加一个反斜杠 
  139. * old.replace(rescape, "//#FormatTableID_0#amp;")代码中的#FormatTableID_0#amp;代表匹配项 
  140. */ 
  141. nid = old.replace(rescape, "//#FormatTableID_0#amp;"); 
  142. else { 
  143. context.setAttribute("id", nid); 
  144. nid = "[id='" + nid + "'] "
  145.  
  146. // 重新组合新的选择器 
  147. i = groups.length; 
  148. while (i--) { 
  149. groups[i] = nid + toSelector(groups[i]); 
  150. /* 
  151. * rsibling = new RegExp(whitespace + "*[+~]") 
  152. * rsibling用于判定选择器是否存在兄弟关系符 
  153. * 若包含+~符号,则取context的父节点作为当前节点 
  154. */ 
  155. newContext = rsibling.test(selector) && context.parentNode 
  156. || context; 
  157. newSelector = groups.join(","); 
  158.  
  159. if (newSelector) { 
  160. /* 
  161. * 这里之所以需要用try...catch, 
  162. * 是因为jquery所支持的一些选择器是querySelectorAll所不支持的, 
  163. * 当使用这些选择器时,querySelectorAll会报非法选择器, 
  164. * 故需要jquery自身去实现。 
  165. */ 
  166. try { 
  167. // 将querySelectorAll获取的结果并入results,而后返回resulsts 
  168. push.apply(results, newContext 
  169. .querySelectorAll(newSelector)); 
  170. return results; 
  171. catch (qsaError) { 
  172. finally { 
  173. if (!old) { 
  174. context.removeAttribute("id"); 
  175.  
  176. // All others 
  177. // 除上述快捷方式和调用querySelectorAll方式直接获取结果外,其余都需调用select来获取结果 
  178. /* 
  179. * rtrim = new RegExp("^" + whitespace + "+|((?:^|[^////])(?:////.)*)" 
  180. * + whitespace + "+$", "g"), 
  181. * whitespace = "[//x20//t//r//n//f]"; 
  182. * 上述rtrim正则表达式的作用是去掉selector两边的空白,空白字符由whitespace变量定义 
  183. * rtrim的效果与new RegExp("^" + whitespace + "+|" + whitespace + "+$", "g")相似 
  184. */ 
  185. return select(selector.replace(rtrim, "$1"), context, results, seed); 

各位朋友,若觉得写得不错,帮我顶一下,给点动力,多谢
!

发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表

图片精选