.add()
通过把元素添加到匹配元素的集合,来创建一个新的jQuery对象
jQuery是一个快速、小巧、功能丰富的JavaScript库。利用一些容易上手的API,它使一些任务,譬如HTML文档遍历和操纵、事件处理、动画,以及Ajax更简单,并能跨浏览器起作用。如果你是jQuery新手,我们建议你学习一下jQuery学习中心。
如果你已经更新到新的jQuery版本,请确保已经读取了在我们的博客上发布的新公告。如果你是从jQuery 1.9以前的版本升级过来的,你还应该检查1.9更新指南。
请注意,此API文档是针对jQuery核心的。其它项目的API文档在别的位置:
通过把元素添加到匹配元素的集合,来创建一个新的jQuery对象
把栈中前面的元素集合添加到当前集合,视情况用一个筛选器过滤。
对匹配元素的集合中的每个元素添加指定的样式类。对匹配元素的集合中的每个元素添加指定的样式类。
在匹配元素的集合中每个元素的后面插入用参数指定的内容。
注册一个事件处理函数,当Ajax请求完成时调用它。这是一个Ajax事件。
注册一个事件处理函数,当Ajax请求以一个错误完成时调用它。这是一个Ajax事件。
附加一个函数,在Ajax请求发送之前执行它。这是一个Ajax事件。
注册一个事件处理函数,在第一个Ajax请求开始之前调用它。这是一个Ajax事件。
注册一个处理函数,当所有的Ajax请求都完成时调用它。注册一个处理函数,当所有的Ajax请求都完成时调用它。这是一个Ajax事件。
附加一个函数,每当有一个Ajax请求成功完成时执行它。这是一个Ajax事件。
选择所有元素。
把栈中前面元素的集合加到当前集合。
执行一些CSS属性的自定义动画。
选择当运行选择器时,正在动画进程中的所有元素。
在匹配元素的集合中每个元素的末尾插入用参数指定的内容。
把匹配的元素集合中的每个元素插入到目标的末尾。
针对匹配的元素集合中的第一个元素,取得一个特性的值,或者对每个匹配的元素设置一个或多个特性。
选择带有指定的特性,且特性值等于给定的字符串,或者特性值以给定的字符串开头,后面跟着连字符的元素。
选择带有指定的特性,且特性值包含了一个给定的子字符串的元素。
选择具有指定的特性,且特性值包含了一个给定的单词,用空格隔开的元素。
选择带有指定的特性,且特性值恰好以给定字符串结尾的元素。此比较是大小写敏感的。
选择具有指定的特性且特性值带有一个值恰好等于特性值的元素。
选择不具有指定的特性或者具有指定的特性但是特性值不是特性值的元素。
选择具有指定的特性且特性值恰好以给定的字符串开头的元素。
在匹配元素的集合中每个元素的开头插入用参数指定的内容。
把一个处理函数附加到针对元素的一个事件。
把一个事件处理函数绑定到“blur”JavaScript事件,或在一个元素上触发该事件。
选择所有按钮以及按钮类型的元素。
把一个回调函数或者一些回调函数添加到某个回调函数的列表。
禁用一个回调函数列表,阻止它做任何事情。
确定某个回调函数是否已经被禁用。
从某个列表中删除所有回调函数。
用给定的参数调用所有的回调函数。
确定某个回调函数是否已经至少被调用过一次。
用给定的上下文和给定的参数调用列表中所有的回调函数。
确定一个列表是否附加了回调函数。如果提供了一个回调函数作为参数,确定它是否在列表中。
把某个回调函数列表锁定在它当前状态。
确定某个回调函数列表是否已经被锁定。
从一个回调函数列表中删除一个回调函数或者一些回调函数。
把一个事件绑定到“change”JavaScript事件,或者在一个元素上触发该事件。
选择所有type="checkbox"的元素。
匹配所有已勾选或者已选中的元素。
选择由“parent”指定的元素的所有由“child”指定的子元素。
在匹配的元素集合上,取得每个元素的子元素,视情况可用一个选择器来筛选。
选择所有带有给定类的元素。
从队列中删除还没有运行的所有项。
把一个事件处理函数绑定到“click”JavaScript事件,或者在一个元素上触发该事件。
为匹配元素的集合创建一个深复制。
针对集合中的每个元素,通过测试元素本身,以及在DOM树中遍历遍它的祖先,来找到第一个匹配选择器的元素。
选择包含指定文本的所有元素。
取得匹配的元素集合中每个元素的子元素,包括文本和注释节点。
DOM节点的上下文来源自传递给jQuery()的参数;如果没有参数,则上下文很有可能是document。
把一个事件处理函数绑定到“contextmenu”JavaScript事件上,或者在一个元素上触发该事件。
针对匹配的元素集合中的第一个元素,取得计算的样式属性的值,或者针对每个匹配的元素,设置一个或多个CSS属性。
存储与匹配的元素相关联的任意数据,或者针对匹配的元素集合中第一个元素,返回命名数据存储的值。
把一个事件处理函数绑定到“dblclick”JavaScript事件上,或者在一个元素上触发该事件。
添加在延迟对象被解决或被拒绝时要调用的处理函数。
添加在延迟对象被拒绝时要调用的处理函数。
添加延迟对象被解决时要调用的处理函数。
添加在延迟对象被拒绝时要调用的处理函数。
确定一个延迟对象是否已经被拒绝。
确定一个迟延对象是否已经被解决。
用给定的参数在延迟对象上调用progressCallbacks。
用给定的上下文和给定的参数在延迟对象上调用progressCallbacks。
实用方法,用来筛选和/或前缀延迟对象。
添加要在延迟对象生成进程通知时调用的处理函数。
返回延迟对象的应答对象。
拒绝一个延迟对象,并用给定的参数调用任何failCallbacks。
拒绝一个延迟对象,并用给定的上下文和给定的参数调用任何failCallbacks。
解决一个延迟对象,并用给定的参数调用任何doneCallbacks。
解决一个延迟对象,并用给定的上下文和给定的参数调用任何doneCallbacks。
确定延迟对象的当前状态。
添加延迟对象在被解决、被拒绝或依然处于进程时要调用的处理函数。
设置一个定时,来延迟队列中后续项目的执行。
基于特定的根元素集合,针对匹配选择器的所有元素,无论是现在匹配的元素还是未来匹配的元素,对一个或多个事件附加一个处理函数。
针对匹配的元素,执行某队列中下一个函数。
选择一个给定祖先元素的所有后代元素。
从DOM中删除匹配元素的集合。从DOM中删除匹配的元素集合。
从元素上删除先前利用.live()附加上去的事件处理函数。
选择所有已禁用的元素。
遍历一个jQuery对象,对每个匹配的元素执行一个函数。
选择带有给定标签名称的所有元素。
从DOM中删除匹配的元素集合的所有子元素节点。
选择所有不具有子元素的元素(包括文本节点)。
选择所有已启用的元素。
结束当前连缀中最近的筛选操作,并把匹配的元素集合返回到它的上一个状态。
把匹配的元素集合缩小到指定索引的那一个。
在匹配集合内部选择位于索引n的元素。
把一个事件处理函数绑定到“error”JavaScript事件上,或者在一个元素上触发该事件。
选择偶数元素、零索引元素。 请参阅odd。
在事件冒泡阶段内部的当前DOM元素。
当绑定当前执行的处理函数时,传递给事件方法的可选的数据对象。
附加当前调用的jQuery事件处理函数的元素。
指示event.preventDefault()是否已经在事件对象上调用过了。
指示event.stopImmediatePropagation()是否已经在事件对象上调用过了。
指示event.stopPropagation()是否已经在事件对象上调用过了。
指示当引发事件时,META键是否已经被按下。
触发事件时所指定的命名空间。
相对于文档左侧边缘的鼠标位置。
相对于文档顶部边缘的鼠标位置。
如果调用了此方法,将不触发事件的默认动作。
涉及此事件的其它DOM元素,如果有的话。
由此事件触发的一个事件处理函数返回的最后的值,除非值是undefined。
确保剩余的事件处理函数不被执行,防止事件沿着DOM树向上传播。
防止事件沿着DOM树向上传播,防止任何父处理函数被事件通知到。
初始化事件的DOM元素。
浏览器创建此事件的时间与1970年1月1日之间的毫秒差距。
描述事件的性质。
对于键盘事件或鼠标事件,此属性指示了被按下的特定的键或按钮。
通过把匹配的元素褪色到不透明来显示它们。
通过把匹配的元素褪色到透明来隐藏它们。
调整匹配元素的不透明度。
通过变翅匹配元素的不透明度来显示或隐藏它们。
选择所有type="file"的元素。
把匹配的元素集合缩小到匹配选择器或者传递函数的测试。
取得匹配的元素的当前集合中每个元素的后代,用一个选择器、jQuery对象或元素来筛选。
针对匹配的元素,停止当前运行的动画,删除所有的队列的动画,结束所有的动画。
把匹配的元素集合缩小为集合中第一个元素。
选择所有的属于它们的父元素的第一个子元素的元素。
选择所有的属于相同元素名称的同辈元素第一个的元素。
选择第一个匹配的DOM元素。
把一个事件处理函数绑定到“focus”JavaScript事件上,或者在一个元素上触发该事件。
选择当前获得焦点的元素。
把一个事件处理函数绑定到“focusin”事件上。
把一个事件处理函数绑定到“focusout”事件上。
检索由jQuery对象匹配的DOM元素对象。
在匹配的集合内部,选择索引大于给定索引的元素。
把匹配的元素集合缩小到具有一个后代匹配选择器或者DOM元素的元素。
选择具有指定特性的元素,特性值任意。
选择包含至少一个元素匹配指定的选择器的元素。
确定是否有任何匹配元素已经带有指定的样式类。
选择所有标题元素,譬如h1、h2、h3,等等。
针对匹配的元素集合中的第一个元素,取得当前的计算高度,或者针对每个匹配的元素设置高度。
选择所有隐藏的元素。
隐藏匹配的元素。
把一个或多个处理函数绑定到匹配的元素,当鼠标指针进入或离开元素时执行它们。
取得匹配的元素集合中第一个元素的HTML内容,或者设置每个匹配的元素的HTML内容。
用给定的ID特性选择一个元素。
选择所有image类型的元素。
从匹配的元素中搜索给定的元素。
针对匹配的元素集合中的第一个元素,取得当前计算内部高度(包括补白,但是不包括边框),或者设置每个匹配元素的内部高度。
针对匹配的元素集合中的第一个元素,取得当前计算内部宽度(包括补白,但是不包括边框),或者设置每个匹配元素的内部宽度。
选择所有的input、textarea、select和button元素。
把匹配的元素集合中的每个元素插入到目标后面。
把匹配的元素集合中的每个元素插入到目标前面。
针对一个选择器、元素或jQuery对象检查当前匹配的元素集合,如果这些元素至少有一个匹配给定的参数,就返回true。
返回匹配元素的集合,要么是在DOM中基于传入的参数找到的,要么是通过传入一个HTML字符串创建的。
一个包含jQuery版本号的字符串。
实施一个异步HTTP(Ajax)请求。
处理自定义Ajax选择或者在每次请求发送之前、在它们被$.ajax()处理之前,修改已有的选项。
为未来的Ajax数据设置默认值。不建议使用它。
创建一个对象,处理实际的Ajax数据传输。
陈述用户的浏览器中的当前的网页,是否是用W3C CSS 盒模型呈现的。jQuery 1.8中删除了此属性。请用功能侦测来代替它。
包含针对用户代理的标记,读取自navigator.userAgent。jQuery 1.9中删除了此属性,只能通过jQuery.migrate插件来使用它。请用功能侦测来代替它。
一个多目的的回调函数列表对象,提供了一个强大的方式,来管理回调函数列表。
检查一个DOM元素是否是另一个DOM元素的后代。
钩子直接进入jQuery以覆盖特定的CSS属性如何被检索或设置,规范化CSS属性命名,或者创建自定义属性。
一些对象包含所有的可以不带单位地使用的CSS属性。.css()方法使用此对象来检查它是否可以把px追加给无单位值。
存储与指定的元素相关联的数据,或者返回已经设置的值。
一个工厂函数,返回一个可前缀的实用工具对象,带有向回调函数队列注册多个回调函数的方法,调用回调函数队列,并延迟任何同步或异步函数的成功或失败状态。
针对匹配的元素,在队列上执行下一个函数。
一个原生的遍历函数,它可以用来无停段地遍历遍对象和数组。一个原生的遍历函数,它可以用来无停段地遍历遍对象和数组。可以利用数字索引,从0到length-1,来遍历数组以及带有length属性的类似数组的对象(譬如函数的arguments对象)。可以利用数字索引,从0到length-1,来遍历数组以及带有length属性的类似数组的对象(譬如函数的arguments对象)。其它对象通过它们的命名属性来遍历。
取一个字符,并抛出一个包含它的异常。
转义在CSS选择器中有特殊含义的任何字符。
把两个或多个对象的内容合并到第一个对象。
把对象的内容合并到jQuery原型,以提供新的jQuery实例方法。
动画引发的速率(以毫秒计)。
全局禁用所有动画。
利用HTTP GET请求,从服务器载入数据。
利用HTTP GET请求,从服务器载入JSON编码的数据。
使用HTTP GET请求从服务器载入一个JavaScript文件,然后执行它。
全局地执行一些JavaScript代码。
找到一个数组的元素,它满足筛选器函数。不影响原始数组。
确定一个元素是否具有任何jQuery数据与它相关联。
控住或释放jQuery的就绪事件的执行。
修改并筛选通过jQuery操纵方法传入的HTML字符串。控住或者释放jQuery的就绪事件的执行。
在一个数组内部搜索一个指定的值,并返回它的索引(如果没找到则返回-1)。
确定参数是否是一个数组。
检查一个对象是不是空的(没有包含任何可枚举的属性)。
确定传入的参数是否是一个JavaScript函数对象。
确定它的参数是否代表一个JavaScript数字。
检查一个对象是否是扁平对象(使用 {}
或new Object
创建的对象)。
确定参数是否是一个窗口。
检查一个DOM节点是否位于一个XML文档内部(或者正是一个XML文档)。
把一个类似数据的对象转换为真正的JavaScript数组。
把数组或对象中的所有项翻译为项的新数组。
把两个数组的内容合并到第一个数组。
让出jQuery对 $
变量的控制。
一个空函数。
返回一个数值,代表当前时间。
为数据、扁平对象或者jQuery对象创建一个序列化的表达,适合于URL查询字符串中使用,或者在Ajax请求中使用。当传入了一个jQuery对象时,它应该包含带有名值属性的输入元素。
把一个字符串解析为一个DOM节点的数组。
取用一个格式良好的JSON字符串,返回结果的JavaScript值。
把一个字符串解析为一个XML文档。
利用HTTP POST请求从服务器载入数据。
取用一个函数,返回一个将始终具有特定上下文的新函数。
显示或操作在匹配的元素上,要被执行的函数的队列。
一个类似预约的对象(或者可延后的对象)当文档就绪时就解决它们。
同步处理封装在jQuery()里的函数中错误抛出。
删除先前存储的数据片断。
创建一个对象,包含了一些属性,预备用于自定义动画的定义。
创建一个jQuery的新副本,可以修改其属性和方法,而不会影响原始的jQuery对象。
一个属性的集合,代表了不同的浏览器功能或bug的表现。原本是为jQuery内部使用而设计的,特定属性当它们不再被内部需要时,可能被删除,以增进网页启动性能。对于你自己的项目的功能侦测需求,我们强烈建议使用外部库,譬如Modernizr代替jQuery.support中的属性的依赖性。
删除字符串开头和末尾的空白。
确定一个对象的内部JavaScript[[Class]]。
排序一个DOM元素的数组,同时删除重复的项。请注意它只对DOM元素的数组起作用,对字符串数组或数字数组不起作用。
排序一个DOM元素的数组,同时删除重复的项。请注意它只对DOM元素的数组起作用,对字符串数组或数字数组不起作用。
提供一种方式来执行回调函数,基于零个或多个可延后的对象,通常是延迟对象,代表异步事件。
把事件处理函数绑定到“keydown”JavaScript事件,或者在一个元素上触发事件。
把一个事件处理函数绑定到“keypress”JavaScript事件上,或者在一个元素上触发该事件。
把一个事件处理函数绑定到“keyup”JavaScript事件,或者在一个元素上触发该事件。
选择指定语言的所有元素。
把匹配的元素集合缩小为集合中最后一个元素。
选择所有的属于它们的父元素的最后一个子元素的元素。
选择所有的属于相同元素名称的同辈元素最后一个的元素。
选择最后的匹配元素。
jQuery对象中元素的数目。
把一个事件处理函数附加到年有匹配当前选择器的元素,无论是现在的元素还是未来的元素。
从服务器载入数据,并把返回的HTML放置到匹配的元素中。从服务器载入数据,并把返回的HTML放置到匹配的元素中。
把一个事件处理函数绑定到“load”JavaScript事件。
在匹配的元素内部,选择索引小于给定索引的所有元素。
通过一个函数传递当前匹配集合中的每个元素,产生一个新的jQuery对象,包含返回值。
把事件处理函数绑定到“mousedown”JavaScript事件,或者在一个元素上触发事件。
绑定一个要在鼠标进入元素时引发的事件处理函数,或者在元素上触发此处理函数。
绑定一个要在鼠标离开元素时引发的事件处理函数,或者在元素上触发此处理函数。
把一个事件处理函数绑定到“mousemove”JavaScript事件,或者在元素上触发此事件。
把一个事件处理函数绑定到“mouseout”JavaScript事件,或者在元素上触发此事件。
把一个事件处理函数绑定到“mouseover”JavaScript事件,或者在元素上触发此事件。
把一个事件处理函数绑定到“mouseup”JavaScript事件,或者在元素上触发此事件。
匹配元素匹配所有指定的特性筛选器。
选择所有指定选择器的组合结果。
取得紧跟在匹配的元素集合中每个元素后面的同辈元素。如果提供了一个选择器,它会检索此匹配此选择器的下一个同辈元素。
选择所有的匹配“next”的下一个元素,它前面必须紧挨着同辈元素“prev”。
选择跟在“prev”元素后面所有的同辈元素,具有同一个父元素,匹配用于筛选的“siblings”选择器。
取得匹配的元素集合中每个元素所有后跟着的同辈元素,视情况可用一个选择器作筛选。
取所每个元素所有后跟着的同辈元素,直到但不包括被传入的选择器、DOM节点或jQuery对象所匹配的元素。
从匹配的元素集合中删除元素。
选择所有不匹配给定选择器的元素。
选择所有的属于它们的父元素的第n个子元素的元素。
选择所有的属于它们的父元素的第n个子元素的元素,从最后一个元素向前数。
选择所有的属于它们的父元素的倒数第n个子元素的元素,相对于具有相同元素名的同辈元素。
选择所有的属于它们的父元素中的第n个子元素的元素,相对于具有相同元素名的同辈元素。
选择奇数元素、零索引的元素。 请参阅even。
删除一个事件处理函数。
在匹配的元素集合中,相对于文档,取得第一个元素的当前坐标,或者设置每个元素的坐标。
取得已定位的最近的祖先元素。
对选中的元素,针对一个或多个事件,附加一个事件处理函数。
把一个处理函数附加到针对元素的一个事件。 此处理函数针对每个元素每种事件类型最多执行一次。
选择所有的属于它们的父元素的唯一子元素的元素。
选择所有的没有相同元素名称的同辈元素的元素。
针对匹配的元素集合中的第一个元素,取得当前的计算外部高度(包括补白、边框和可选的边距),或者针对每个匹配的元素设置外部高度。
针对匹配的元素集合中的第一个元素,取得当前的计算外部宽度(包括补白、边框和可选的边距),或者针对每个匹配的元素设置外部宽度。
在匹配元素的当前集合中,取得每个元素的父元素,视情况可用一个选择器作筛选。
选择所有的至少具有一个子节点(既可以是元素也可以是文本)的元素。
在匹配元素的当前集合中,取得每个元素的祖先元素,视情况可用一个选择器作筛选。
取得匹配的元素的当前集合中每个元素的祖先元素,直到但是不包括被传入的选择器、DOM节点或jQuery对象匹配的元素。
选择所有type="password"的元素。
取得匹配的元素集合中第一个元素的当前坐标,相对于定位父元素。
在匹配元素的集合中每个元素的前面插入用参数指定的内容。
把匹配的元素集合中的每个元素插入到目标的前面。
取得紧靠在匹配的元素集合中每个元素前面的同辈元素。如果提供了一个选择器,它会检索此匹配此选择器的上一个同辈元素。
取得匹配的元素集合中每个元素所有走前面的同辈元素,视情况可用一个选择器作筛选。
取所每个元素所有走前面的同辈元素,直到但不包括被传入的选择器、DOM节点或jQuery对象所匹配的元素。
返回一个应答对象,用来观察当某个类型的所有操作绑定到集合时,是否排队,是否已经完成。
针对匹配的元素集合中第一个元素取得一个属性的值,或者针对每个匹配的元素设置一个或多个属性。
把一个DOM元素集合添加到jQuery堆栈。
显示或操纵要在匹配的元素上执行的函数队列。
选择所有type="radio"的元素。
指定一个元素,当DOM完全载入时执行它。
从DOM中删除匹配元素的集合。从DOM中删除匹配的元素集合。
从匹配的元素集合的每个元素上删除一个特性。
从匹配的元素集合中每个元素上删除一个类、多个类或者所有类。
删除先前存储的数据片断。
针对匹配的元素集合删除一个属性。
用匹配的元素集合替换每个目标元素。
把匹配的元素集合中每个元素替换成提供的新内容,并返回被删除的元素集合。
选择所有type="reset"的元素。
把一个事件处理函数绑定到“resize”JavaScript事件,或在元素上触发该事件。
选择作为文档根节点的元素。
把事件处理函数绑定到“scroll”JavaScript事件上,或者在元素上触发此事件。
针对匹配的元素集合中第一个元素,取得当前滚动条的水平位置,或者针对每个匹配的元素设置水平滚动条的位置。
针对匹配的元素集合中第一个元素,取得当前滚动条的垂直位置,或者针对每个匹配的元素设置垂直滚动条的位置。
把事件处理函数绑定到“select”JavaScript事件,或者在元素上触发此事件。
选择所有被选中的元素。
一个选择器,代表当创建原始集的时候,传递给jQuery()的选择器,如果有的话。
把一些表单元素编码为一个字符串以提交。
把一些表单元素编码为名值对数组。
显示匹配的元素。
取得匹配的元素集合中每个元素的同辈元素,视情况可用一个选择器作筛选。
返回jQuery对象中元素的数目。
把匹配的元素集合缩小为由一个索引范围指定的子集。
用一个滑动动画显示匹配的元素。
用滑动动画显示或隐藏匹配的元素。
用滑动动画隐藏匹配的元素。
在匹配的元素上停止当前正在运行的动画。
把事件处理函数绑定到“submit”JavaScript事件上,或者在元素上触发此事件。
选择所有type="submit"的元素。
选择由文档的URL的片段标识符指示的目标元素。
取得匹配的元素集合中每个元素的文本内容合并,包括它们的后代元素,或者设置匹配的元素的文本内容。
选择所有type="text"的input元素
检索包含在jQuery集合中的所有元素,作为一个数组。
显示或隐藏匹配的元素。
把两个或多个处理函数绑定到匹配的元素,在交替单击时执行它们。
从匹配的元素集合的每个元素上添加或删除一个或多个类,取决于类是否存在,或者状态参数的值。
执行附加到匹配的元素上针对给定事件类型的所有处理函数以及行为。
执行所有针对某个事件附加到某个元素上的处理函数。
从元素上删除先前附加的事件处理函数。
基于特定的根元素集合,针对匹配当前选择器的所有元素,从事件上删除一个处理函数。
把事件处理函数绑定到“unload”JavaScript事件上。
从DOM中删除匹配的元素集合的父元素,留下匹配的元素在它们原来的位置。
取得匹配的元素集合中每一个元素的当前值,或者设置每个匹配的元素的值。
选择所有可见的元素。
针对匹配的元素集合中的第一个元素,取得当前的计算宽度,或者针对每个匹配的元素设置宽度。
把HTML结构包围在匹配的元素集合中每个元素的周围。
把HTML结构包围在匹配的元素集合中所有元素的周围。
把HTML结构包围在匹配的元素集合中每个元素的内容周围。