Function addCombinator

2.0.3/Sizzle-annotation.js:1672–1730

(matcher, combinator, base)

	//这是一个递归深搜的过程。
	//addCombinator方法就是为了生成有位置词素的匹配器。
	function addCombinator(matcher, combinator, base) {
		var dir = combinator.dir,
			checkNonElements = base && dir === "parentNode",
			doneName = done++; //第几个关系选择器

		return combinator.first ?
		// Check against closest ancestor/preceding element
		// 检查最靠近的祖先元素
		// 如果是紧密关系的位置词素
		function(elem, context, xml) {
			while ((elem = elem[dir])) {
				if (elem.nodeType === 1 || checkNonElements) {
					//找到第一个亲密的节点，立马就用终极匹配器判断这个节点是否符合前面的规则
					return matcher(elem, context, xml);
				}
			}
		} :

		// Check against all ancestor/preceding elements
		//检查最靠近的祖先元素或兄弟元素（概据>、~、+还有空格检查）
		//如果是不紧密关系的位置词素
		function(elem, context, xml) {
			var data, cache, outerCache,
				dirkey = dirruns + " " + doneName;

			// We can't set arbitrary data on XML nodes, so they don't benefit from dir caching
			// 我们不可以在xml节点上设置任意数据，所以它们不会从dir缓存中受益
			if (xml) {
				while ((elem = elem[dir])) {
					if (elem.nodeType === 1 || checkNonElements) {
						if (matcher(elem, context, xml)) {
							return true;
						}
					}
				}
			} else {
				while ((elem = elem[dir])) {
		            //如果是不紧密的位置关系
		            //那么一直匹配到true为止
		            //例如祖宗关系的话，就一直找父亲节点直到有一个祖先节点符合规则为止
					if (elem.nodeType === 1 || checkNonElements) {
						outerCache = elem[expando] || (elem[expando] = {});
						//如果有缓存且符合下列条件则不用再次调用matcher函数
						if ((cache = outerCache[dir]) && cache[0] === dirkey) {
							if ((data = cache[1]) === true || data === cachedruns) {
								return data === true;
							}
						} else {
							cache = outerCache[dir] = [dirkey];
							cache[1] = matcher(elem, context, xml) || cachedruns; //cachedruns//正在匹配第几个元素
							if (cache[1] === true) {
								return true;
							}
						}
					}
				}
			}
		};