jQuery 3.2.1 API

jQuery是一个快速、小巧、功能丰富的JavaScript库。利用一些容易上手的API,它使一些任务,譬如HTML文档遍历和操纵、事件处理、动画,以及Ajax更简单,并能跨浏览器起作用。如果你是jQuery新手,我们建议你学习一下jQuery学习中心

如果你已经更新到新的jQuery版本,请确保已经读取了在我们的博客上发布的新公告。如果你是从jQuery 1.9以前的版本升级过来的,你还应该检查1.9更新指南

请注意,此API文档是针对jQuery核心的。其它项目的API文档在别的位置:


.ajaxStop()

注册一个处理函数,当所有的Ajax请求都完成时调用它。注册一个处理函数,当所有的Ajax请求都完成时调用它。这是一个Ajax事件。

.attr()

针对匹配的元素集合中的第一个元素,取得一个特性的值,或者对每个匹配的元素设置一个或多个特性。

.children()

在匹配的元素集合上,取得每个元素的子元素,视情况可用一个选择器来筛选。

.click()

把一个事件处理函数绑定到“click”JavaScript事件,或者在一个元素上触发该事件。

.closest()

针对集合中的每个元素,通过测试元素本身,以及在DOM树中遍历遍它的祖先,来找到第一个匹配选择器的元素。

.css()

针对匹配的元素集合中的第一个元素,取得计算的样式属性的值,或者针对每个匹配的元素,设置一个或多个CSS属性。

.data()

存储与匹配的元素相关联的任意数据,或者针对匹配的元素集合中第一个元素,返回命名数据存储的值。

.dblclick()

把一个事件处理函数绑定到“dblclick”JavaScript事件上,或者在一个元素上触发该事件。

.end()

结束当前连缀中最近的筛选操作,并把匹配的元素集合返回到它的上一个状态。

.filter()

把匹配的元素集合缩小到匹配选择器或者传递函数的测试。

.find()

取得匹配的元素的当前集合中每个元素的后代,用一个选择器、jQuery对象或元素来筛选。

.finish()

针对匹配的元素,停止当前运行的动画,删除所有的队列的动画,结束所有的动画。

.has()

把匹配的元素集合缩小到具有一个后代匹配选择器或者DOM元素的元素。

.hover()

把一个或多个处理函数绑定到匹配的元素,当鼠标指针进入或离开元素时执行它们。

.innerWidth()

针对匹配的元素集合中的第一个元素,取得当前计算内部宽度(包括补白,但是不包括边框),或者设置每个匹配元素的内部宽度。

.is()

针对一个选择器、元素或jQuery对象检查当前匹配的元素集合,如果这些元素至少有一个匹配给定的参数,就返回true。

jQuery()

返回匹配元素的集合,要么是在DOM中基于传入的参数找到的,要么是通过传入一个HTML字符串创建的。

jQuery.cssHooks

钩子直接进入jQuery以覆盖特定的CSS属性如何被检索或设置,规范化CSS属性命名,或者创建自定义属性。

jQuery.Deferred()

一个工厂函数,返回一个可前缀的实用工具对象,带有向回调函数队列注册多个回调函数的方法,调用回调函数队列,并延迟任何同步或异步函数的成功或失败状态。

jQuery.each()

一个原生的遍历函数,它可以用来无停段地遍历遍对象和数组。一个原生的遍历函数,它可以用来无停段地遍历遍对象和数组。可以利用数字索引,从0到length-1,来遍历数组以及带有length属性的类似数组的对象(譬如函数的arguments对象)。可以利用数字索引,从0到length-1,来遍历数组以及带有length属性的类似数组的对象(譬如函数的arguments对象)。其它对象通过它们的命名属性来遍历。

jQuery.param()

为数据、扁平对象或者jQuery对象创建一个序列化的表达,适合于URL查询字符串中使用,或者在Ajax请求中使用。当传入了一个jQuery对象时,它应该包含带有名值属性的输入元素。

jQuery.support

一个属性的集合,代表了不同的浏览器功能或bug的表现。原本是为jQuery内部使用而设计的,特定属性当它们不再被内部需要时,可能被删除,以增进网页启动性能。对于你自己的项目的功能侦测需求,我们强烈建议使用外部库,譬如Modernizr代替jQuery.support中的属性的依赖性。

jQuery.unique()

排序一个DOM元素的数组,同时删除重复的项。请注意它只对DOM元素的数组起作用,对字符串数组或数字数组不起作用。

jQuery.uniqueSort()

排序一个DOM元素的数组,同时删除重复的项。请注意它只对DOM元素的数组起作用,对字符串数组或数字数组不起作用。

jQuery.when()

提供一种方式来执行回调函数,基于零个或多个可延后的对象,通常是延迟对象,代表异步事件。

.keypress()

把一个事件处理函数绑定到“keypress”JavaScript事件上,或者在一个元素上触发该事件。

.keyup()

把一个事件处理函数绑定到“keyup”JavaScript事件,或者在一个元素上触发该事件。

.load()

从服务器载入数据,并把返回的HTML放置到匹配的元素中。从服务器载入数据,并把返回的HTML放置到匹配的元素中。

.map()

通过一个函数传递当前匹配集合中的每个元素,产生一个新的jQuery对象,包含返回值。

.next()

取得紧跟在匹配的元素集合中每个元素后面的同辈元素。如果提供了一个选择器,它会检索此匹配此选择器的下一个同辈元素。

.nextAll()

取得匹配的元素集合中每个元素所有后跟着的同辈元素,视情况可用一个选择器作筛选。

.nextUntil()

取所每个元素所有后跟着的同辈元素,直到但不包括被传入的选择器、DOM节点或jQuery对象所匹配的元素。

.outerHeight()

针对匹配的元素集合中的第一个元素,取得当前的计算外部高度(包括补白、边框和可选的边距),或者针对每个匹配的元素设置外部高度。

.outerWidth()

针对匹配的元素集合中的第一个元素,取得当前的计算外部宽度(包括补白、边框和可选的边距),或者针对每个匹配的元素设置外部宽度。

.parent()

在匹配元素的当前集合中,取得每个元素的父元素,视情况可用一个选择器作筛选。

.parents()

在匹配元素的当前集合中,取得每个元素的祖先元素,视情况可用一个选择器作筛选。

.parentsUntil()

取得匹配的元素的当前集合中每个元素的祖先元素,直到但是不包括被传入的选择器、DOM节点或jQuery对象匹配的元素。

.prev()

取得紧靠在匹配的元素集合中每个元素前面的同辈元素。如果提供了一个选择器,它会检索此匹配此选择器的上一个同辈元素。

.prevAll()

取得匹配的元素集合中每个元素所有走前面的同辈元素,视情况可用一个选择器作筛选。

.prevUntil()

取所每个元素所有走前面的同辈元素,直到但不包括被传入的选择器、DOM节点或jQuery对象所匹配的元素。

.promise()

返回一个应答对象,用来观察当某个类型的所有操作绑定到集合时,是否排队,是否已经完成。

.siblings()

取得匹配的元素集合中每个元素的同辈元素,视情况可用一个选择器作筛选。

.text()

取得匹配的元素集合中每个元素的文本内容合并,包括它们的后代元素,或者设置匹配的元素的文本内容。