closest(e|o|e) | jQuery API 3.2 中文文档 | jQuery API 在线手册

jQuery API 3.2.1

推荐办理招商信用卡,新户首刷礼,五折享美食,需要的速度围观~click here
首页  >  筛选  > closest(e|o|e) 源码下载

返回值:jQueryclosest(expr|object|element)

概述

jQuery 1.3新增。从元素本身开始,逐级向上级元素匹配,并返回最先匹配的元素。。

closest会首先检查当前元素是否匹配,如果匹配则直接返回元素本身。如果不匹配则向上查找父元素,一层一层往上,直到找到匹配选择器的元素。如果什么都没找到则返回一个空的jQuery对象。

closest和parents的主要区别是:1,前者从当前元素开始匹配寻找,后者从父元素开始匹配寻找;2,前者逐级向上查找,直到发现匹配的元素后就停止了,后者一直向上查找直到根元素,然后把这些元素放进一个临时集合中,再用给定的选择器表达式去过滤;3,前者返回0或1个元素,后者可能包含0个,1个,或者多个元素。

closest对于处理事件委托非常有用。

.closest( selectors [, context ] )方法从 jQuery 1.7 开始,不再建议使用该方法,但是 jQuery 1.7 之前仍然可以使用。该方法将主要用于 jQuery 内部或插件作者使用。

参数

expr String,Array V1.3

用以过滤元素的表达式。jQuery 1.4开始,也可以传递一个字符串数组,用于查找多个元素。

expr,[context] String V1.4

expr:用以过滤子元素的表达式

context:DOM元素在其中一个匹配的元素可以被发现。如果没有上下文在当时的情况下通过了jQuery设置将被使用。

jQuery object object V1.6

一个用于匹配元素的jQuery对象

element DOMElement V1.6

一个用于匹配元素的DOM元素。

示例

描述:

展示如何使用clostest查找多个元素

HTML 代码:
            <ul><li></li><li></li></ul>
          
jQuery 代码:
            $("li:first").closest(["ul", "body"]);
          
结果:
            [ul, body]
          

描述:

展示如何使用clostest来完成事件委托。

HTML 代码:
            <ul>
    <li><b>Click me!</b></li>
    <li>You can also <b>Click me!</b></li>
</ul>
          
jQuery 代码:
            $(document).bind("click", function (e) {
    $(e.target).closest("li").toggleClass("hilight");
});