描述: 判断当前匹配的元素集合中的元素,是否为一个选择器,DOM元素,或者jQuery对象,如果这些元素至少一个匹配给定的参数,那么返回true。

一个字符串,包含一个用来匹配元素的选择器表达式。

一个函数,用来测试集合中的元素。它接受一个参数,index ,这是元素在jQuery集合的索引位置。在函数中, this指的是当前的DOM元素。

现有的jQuery对象,以匹配当前的元素。

不像其他过滤和遍历方法,.is()并不创建一个新的jQuery对象。相反,它允许我们检测jQuery对象的内容,而无需修改该对象。通常在回调函数内使用该方法,例如事件处理。

假设我们有其包含两个项目的子元素列表:

我们可以在 元素上绑定一个单击处理程序,然后限制的代码只有当列表项目本身时触发,并不是它的子元素被点击:

从jQuery 1.7开始,位置选择器的选择器字符串适用于文档的选择器,然后再确定是否为jQuery集合的第一个元素是否匹配任何由此产生的元素。因此,上面显示的HTML ,比如$("li:first").is("li:last")这样一个选择器返回false。请注意,由于位置选择器jQuery添加的功能,而不是W3C标准,我们建议在可行情况下使用W3C的选择器。

第二个形式方法相关函数表达上,而不是一个选择器。对于每个元素,如果函数返回true , .is()返回true也。例如,给出一个较为复杂的HTML片段:

Example: 显示的 is()可用于在一个事件处理程序的几种方法。

Example: 返回true,因为input的父级是一个表单的元素。

Example: 返回false,因为input的父级是一个P元素。

Example: 另一种方式来实现上面的例子中使用的元素而不是一个jQuery对象。Blue alternating list elements slide up while others turn red.