首页 > 语言 > JavaScript > 正文

jQuery选择器源码解读(二):select方法

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

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

 

 
  1. /* 
  2. * select方法是Sizzle选择器包的核心方法之一,其主要完成下列任务: 
  3. * 1、调用tokenize方法完成对选择器的解析 
  4. * 2、对于没有初始集合(即seed没有赋值)且是单一块选择器(即选择器字符串中没有逗号), 
  5. * 完成下列事项: 
  6. * 1) 对于首选择器是ID类型且context是document的,则直接获取对象替代传入的context对象 
  7. * 2) 若选择器是单一选择器,且是id、class、tag类型的,则直接获取并返回匹配的DOM元素 
  8. * 3) 获取最后一个id、class、tag类型选择器的匹配DOM元素赋值给初始集合(即seed变量) 
  9. * 3、通过调用compile方法获取“预编译”代码并执行,获取并返回匹配的DOM元素 
  10.  
  11. * @param selector 已去掉头尾空白的选择器字符串 
  12. * @param context 执行匹配的最初的上下文(即DOM元素集合)。若context没有赋值,则取document。 
  13. * @param results 已匹配出的部分最终结果。若results没有赋值,则赋予空数组。 
  14. * @param seed 初始集合 
  15. */ 
  16. function select(selector, context, results, seed) { 
  17.  
  18. var i, tokens, token, type, find,  
  19. // 调用tokenize函数解析selector 
  20. match = tokenize(selector); 
  21.  
  22. // 若没有提供初始集合 
  23. if (!seed) { 
  24. // Try to minimize operations if there is only one group 
  25. // 若只有一组选择器,即选择器字符串没有逗号 
  26. if (match.length === 1) { 
  27. // Take a shortcut and set the context if the root selector 
  28. // is an ID 
  29. /* 
  30. * 下面代码是用来处理根选择器是ID类型的快捷方式 
  31.  
  32. * 在此使用slice[0]来创建一个新的集合, 
  33. * 确保原有的集合不会被之后代码变更掉 
  34. */ 
  35. tokens = match[0] = match[0].slice(0); 
  36. /* 
  37. * 若选择器是以id类型开始,且第二个是关系符(即+~>或空格), 
  38. * 则获取id所属对象作为context继续完成后续的匹配 
  39.  
  40. * 此处的条件判断依次为: 
  41. * tokens.length > 2 :若tokens有两个以上的选择器 
  42. * (token = tokens[0]).type === "ID" :第一个选择器的类型为ID(即以#开头的), 
  43. * support.getById :支持getElementById函数 
  44. * context.nodeType === 9 :context对象是document 
  45. * documentIsHTML :当前处理的是HTML代码 
  46. * Expr.relative[tokens[1].type] :第二个tokens元素是一个关系(即+~>或空格) 
  47. * 在满足上面所有条件的情况下,执行if内的语句体 
  48. */ 
  49. if (tokens.length > 2 && (token = tokens[0]).type === "ID" 
  50. && support.getById && context.nodeType === 9 
  51. && documentIsHTML && Expr.relative[tokens[1].type]) { 
  52.  
  53. // 将当前上下文指向第一个ID选择器指定的节点对象 
  54. context = (Expr.find["ID"](token.matches[0].replace( 
  55. runescape, funescape), context) || [])[0]; 
  56.  
  57. // 若当前上下文内没有指定ID对象,则直接返回results 
  58. if (!context) { 
  59. return results; 
  60.  
  61. // 选择器字符串去掉第一个ID选择器 
  62. selector = selector.slice(tokens.shift().value.length); 
  63.  
  64. // Fetch a seed set for right-to-left matching 
  65. /*  
  66. * 下面while循环的作用是用来根据最后一个id、class、tag类型的选择器获取初始集合 
  67. * 举个简单例子:若选择器是"div[title='2']", 
  68. * 代码根据div获取出所有的context下的div节点,并把这个集合赋给seed变量, 
  69. * 然后在调用compile函数,产生预编译代码, 
  70. * 预编译代码完成在上述初始集合中执行[title='2']的匹配 
  71.  
  72. * 首先,检查选择器字符串中是否存在与needsContext正则表达式相匹配的字符 
  73. * 若没有,则将依据选择器从右到左过滤DOM节点 
  74. * 否则,将先生成预编译代码后执行(调用compile方法)。  
  75. */ 
  76.  
  77. /* 
  78. * "needsContext" : new RegExp("^" + whitespace 
  79. * + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?://(" 
  80. * + whitespace + "*((?:-//d)?//d*)" + whitespace 
  81. * + "*//)|)(?=[^-]|$)", "i") 
  82. * needsContext用来匹配选择器字符串中是否包含下列内容: 
  83. * 1、>+~三种关系符 
  84. * 2、:even、:odd、:eq、:gt、:lt、:nth、:first、:last八种伪类 
  85. * 其中,(?=[^-]|$)用来过滤掉类似于:first-child等带中杠的且以上述八个单词开头的其它选择器 
  86. */ 
  87. i = matchExpr["needsContext"].test(selector) ? 0 
  88. : tokens.length; 
  89. while (i--) { 
  90. token = tokens[i]; 
  91.  
  92. // Abort if we hit a combinator 
  93. // 遇到关系符跳出循环 
  94. if (Expr.relative[(type = token.type)]) { 
  95. break
  96. if ((find = Expr.find[type])) { 
  97. // Search, expanding context for leading sibling 
  98. // combinators 
  99. /* 
  100. * rsibling = new RegExp(whitespace + "*[+~]") 
  101. * rsibling用于判定token选择器是否是兄弟关系符 
  102. */ 
  103. if ((seed = find(token.matches[0].replace( 
  104. runescape, funescape), rsibling 
  105. .test(tokens[0].type) 
  106. && context.parentNode || context))) { 
  107.  
  108. // If seed is empty or no tokens remain, we can 
  109. // return early 
  110. // 剔除刚用过的选择器 
  111. tokens.splice(i, 1); 
  112. selector = seed.length && toSelector(tokens); 
  113. /* 
  114. * 若selector为空,说明选择器仅为单一id、class、tag类型的, 
  115. * 故直接返回获取的结果,否则,在获取seed的基础上继续匹配 
  116. */ 
  117. if (!selector) { 
  118. push.apply(results, seed); 
  119. return results; 
  120.  
  121. break
  122.  
  123. // Compile and execute a filtering function 
  124. // Provide `match` to avoid retokenization if we modified the 
  125. // selector above 
  126. /* 
  127. * 先执行compile(selector, match),它会返回一个“预编译”函数, 
  128. * 然后调用该函数获取最后匹配结果 
  129. */ 
  130. compile(selector, match)(seed, context, !documentIsHTML, results, 
  131. rsibling.test(selector)); 
  132. return results; 

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

图片精选