十五、附录 B：快速参考

本附录旨在作为 jQueryAPI 的快速参考，包括其选择器表达式和方法。关于每种方法和选择器的更详细讨论，请访问 jQuery 文档站点http://api.jquery.com 。

选择器表达式

jQuery 工厂函数$()用于在页面上查找要使用的元素。此函数接受由类似 CSS 的语法组成的字符串，称为选择器表达式。选择器表达式将在第 2 章选择元素中详细讨论。

简单 CSS

| 选择器 | 匹配 | | * | 所有元素。 | | #id | 具有给定 ID 的元素。 | | element | 给定类型的所有元素。 | | .class | 具有给定类的所有元素。 | | a, b | 由a或b匹配的元素。 | | a b | 元素b是a的后代。 | | a > b | 属于a的子元素b。 | | a + b | 紧接着a的元素b。 | | a ~ b | 元素b是a的兄弟元素，跟随a。 |

兄弟姐妹间的地位

匹配元素间的位置

选择器	匹配
`:first`	结果集中的第一个元素。
`:last`	结果集中的最后一个元素。
`:not(a)`	结果集中与`a`不匹配的所有元素。
`:even`	结果集中的偶数元素（基于 0）。
`:odd`	结果集中的奇数元素（基于 0）。
`:eq(index)`	结果集中的编号元素（基于 0）。
`:gt(index)`	结果集中位于（大于）给定索引（基于 0）之后的所有元素。
`:lt(index)`	结果集中给定索引之前（小于）的所有元素（基于 0）。

属性

形式

选择器	匹配
`:input`	所有的`<input>`、`<select>`、`<textarea>`和`<button>`元素。
`:text`	带有`type="text"`的`<input>`元素。
`:password`	带有`type="password"`的`<input>`元素。
`:file`	带有`type="file"`的`<input>`元素。
`:radio`	带有`type="radio"`的`<input>`元素。
`:checkbox`	带有`type="checkbox"`的`<input>`元素。
`:submit`	带有`type="submit"`的`<input>`元素。
`:image`	带有`type="image"`的`<input>`元素。
`:reset`	带有`type="reset"`的`<input>`元素。
`:button`	具有`type="button"`和`<button>`元素的`<input>`元素。
`:enabled`	启用的表单元素。
`:disabled`	禁用表单元素。
`:checked`	选中复选框和单选按钮。
`:selected`	选择`<option>`元素。

杂项选择器

DOM 遍历方法

在使用$()创建 jQuery 对象之后，我们可以通过调用这些 DOM 遍历方法之一来更改正在使用的匹配元素集。DOM 遍历方法在第 2 章、选择元素中有详细讨论。

过滤

后代

兄弟姐妹

穿越方式	返回一个包含。。。
`.next([selector])`	紧跟在每个选定元素之后的同级元素，可选地由选择器过滤。
`.nextAll([selector])`	每个选定元素后面的所有同级元素（可选地由选择器过滤）。
`.nextUntil([selector], [filter])`	每个选定元素后面的所有同级元素，直到且不包括匹配`selector`的第一个元素，可选地由附加选择器过滤。
`.prev([selector])`	紧靠每个选定元素前面的同级元素，可选地由选择器过滤。
`.prevAll([selector])`	每个选定元素前面的所有同级元素，可选地由选择器过滤。
`.prevUntil([selector], [filter])`	每个选定元素前面的所有同级元素，直到且不包括匹配`selector`的第一个元素，可选地由附加选择器过滤。
`.siblings([selector])`	所有同级，可选地由选择器过滤。

祖先

集合操纵

使用选定图元

事件方法

为了对用户行为做出反应，我们需要使用这些事件方法注册处理程序。注意，许多 DOM 事件只适用于某些元素类型；这里不涉及这些微妙之处。事件方法在第 3 章、处理事件中详细讨论。

结合

事件方法	说明
`.ready(handler)`	绑定`handler`以在 DOM 和 CSS 完全加载时调用。
`.on(type, [selector], [data], handler)`	将给定类型的事件发送到元素时要调用的绑定`handler`。如果提供了`selector`，则执行事件委托。
`.on(events, [selector], [data])`	为`events`对象参数中指定的事件绑定多个处理程序。
`.off(type, [selector], [handler])`	删除元素上的绑定。
`.one(type, [data], handler)`	将给定类型的事件发送到元素时要调用的绑定`handler`。调用处理程序时移除绑定。

速记装订

事件方法	说明
`.blur(handler)`	绑定`handler`以在元素失去键盘焦点时调用。
`.change(handler)`	绑定`handler`以在元素值更改时调用。
`.click(handler)`	绑定`handler`以在单击元素时调用。
`.dblclick(handler)`	双击元素时绑定要调用的`handler`。
`.focus(handler)`	绑定`handler`以在元素获得键盘焦点时调用。
`.focusin(handler)`	绑定`handler`以在元素或子元素获得键盘焦点时调用。
`.focusout(handler)`	绑定`handler`以在元素或后代失去键盘焦点时调用。
`.keydown(handler)`	绑定`handler`以在按下某个键且该元素具有键盘焦点时调用。
`.keypress(handler)`	绑定`handler`以在发生击键且元素具有键盘焦点时调用。
`.keyup(handler)`	绑定`handler`以在释放键且元素具有键盘焦点时调用。
`.mousedown(handler)`	在元素内按下鼠标按钮时绑定要调用的`handler`。
`.mouseenter(handler)`	当鼠标指针进入元素时绑定要调用的`handler`。不受事件冒泡的影响。
`.mouseleave(handler)`	绑定`handler`以在鼠标指针离开元素时调用。不受事件冒泡的影响。
`.mousemove(handler)`	当鼠标指针在元素内移动时绑定要调用的`handler`。
`.mouseout(handler)`	绑定`handler`以在鼠标指针离开元素时调用。
`.mouseover(handler)`	当鼠标指针进入元素时绑定要调用的`handler`。
`.mouseup(handler)`	绑定`handler`以在元素内释放鼠标按钮时调用。
`.resize(handler)`	在调整元素大小时绑定要调用的`handler`。
`.scroll(handler)`	绑定`handler`以在元素的滚动位置更改时调用。
`.select(handler)`	选择元素中的文本时绑定要调用的`handler`。
`.submit(handler)`	绑定提交表单元素时要调用的`handler`。
`.hover(enter, leave)`	绑定`enter`在鼠标进入元素时调用，绑定`leave`在鼠标离开元素时调用。

触发

速记触发

公用事业

效果方法

这些效果方法可用于在 DOM 元素上执行动画。在第 4 章、样式和动画中详细讨论了效果方法。

预定义效果

效果方法	说明
`.show()`	显示匹配的元素。
`.hide()`	隐藏匹配的元素。
`.show(speed, [callback])`	通过设置`height`、`width`和`opacity`的动画来显示匹配的元素。
`.hide(speed, [callback])`	通过设置`height`、`width`和`opacity`的动画来隐藏匹配的元素。
`.slideDown([speed], [callback])`	显示具有滑动运动的匹配图元。
`.slideUp([speed], [callback])`	通过滑动运动隐藏匹配的元素。
`.slideToggle([speed], [callback])`	显示或隐藏具有滑动运动的匹配元素。
`.fadeIn([speed], [callback])`	通过将匹配的图元淡入不透明状态来显示这些图元。
`.fadeOut([speed], [callback])`	通过将匹配的元素淡入透明状态来隐藏这些元素。
`.fadeToggle([speed], [callback])`	显示或隐藏带有淡入淡出动画的匹配元素。
`.fadeTo(speed, opacity, [callback])`	调整匹配元素的不透明度。

自定义动画

队列操作

效果方法	说明
`.queue([queueName])`	检索第一个匹配元素上的函数队列。
`.queue([queueName], callback)`	将`callback`添加到队列的末尾。
`.queue([queueName], newQueue)`	将队列替换为新队列。
`.dequeue([queueName])`	执行队列上的下一个函数。
`.clearQueue([queueName])`	清空所有挂起函数的队列。
`.stop([clearQueue], [jumpToEnd])`	停止当前正在运行的动画，然后启动排队的动画（如果有）。
`.finish([queueName])`	停止当前正在运行的动画，并立即将所有排队的动画推进到其目标值。
`.delay(duration, [queueName])`	在执行队列中的下一项之前等待`duration`毫秒。
`.promise([queueName], [target])`	返回集合上的所有排队操作完成后要解析的承诺对象。

DOM 操作方法

在第 5 章、操作 DOM中详细讨论了 DOM 操作方法。

属性和属性

手法	说明
`.attr(key)`	获取名为`key`的属性。
`.attr(key, value)`	将名为`key`的属性设置为`value`。
`.attr(key, fn)`	将名为`key`的属性设置为`fn`的结果（对每个匹配的元素分别调用）。
`.attr(obj)`	设置作为键值对给定的属性值。
`.removeAttr(key)`	删除名为`key`的属性。
`.prop(key)`	获取名为`key`的属性。
`.prop(key, value)`	将名为`key`的属性设置为`value`。
`.prop(key, fn)`	将名为`key`的属性设置为`fn`的结果（对每个匹配的元素分别调用）。
`.prop(obj)`	设置作为键值对给定的属性值。
`.removeProp(key)`	删除名为`key`的属性。
`.addClass(class)`	将给定的类添加到每个匹配的元素。
`.removeClass(class)`	从每个匹配的元素中删除给定的类。
`.toggleClass(class)`	为每个匹配的元素移除给定的类（如果存在），如果不存在则添加它。
`.hasClass(class)`	如果任何匹配的元素具有给定的类，则返回`true`。
`.val()`	获取第一个匹配元素的 value 属性。
`.val(value)`	将每个元素的值属性设置为`value`。

所容纳之物

CSS

尺寸

插入

手法	说明
`.append(content)`	在每个匹配元件的内部末端插入`content`。
`.appendTo(selector)`	在`selector`匹配的元素内部的末端插入匹配的元素。
`.prepend(content)`	在每个匹配元素的内部开始处插入`content`。
`.prependTo(selector)`	在`selector`匹配的元素内部的开始处插入匹配的元素。
`.after(content)`	在每个匹配元素后插入`content`。
`.insertAfter(selector)`	在`selector`匹配的每个元素之后插入匹配的元素。
`.before(content)`	在每个匹配元素前插入`content`。
`.insertBefore(selector)`	在`selector`匹配的每个元素之前插入匹配的元素。
`.wrap(content)`	将每个匹配元素包装在`content`中。
`.wrapAll(content)`	将所有匹配元素包装为`content`内的单个单元。
`.wrapInner(content)`	将每个匹配元素的内部内容包装在`content`中。

替换

移动

手法	说明
`.empty()`	删除每个匹配元素的子节点。
`.remove([selector])`	从 DOM 中删除匹配的节点（可选地由`selector`过滤）。
`.detach([selector])`	从 DOM 中删除匹配的节点（可选地由`selector`过滤），保留附加到它们的 jQuery 数据。
`.unwrap()`	删除元素的父元素。

临摹

| 手法 | 说明 | | .clone([withHandlers], [deepWithHandlers]) | 创建所有匹配元素的副本，还可以选择复制事件处理程序。 |

数据

Ajax 方法

通过调用这些 Ajax 方法之一，我们可以从服务器检索信息，而无需刷新页面。在第 6 章、使用 Ajax 发送数据中详细讨论了 Ajax 方法。

发出请求

Ajax 方法	说明
`$.ajax([url], options)`	使用提供的一组选项发出 Ajax 请求。这是一种低级方法，通常通过其他方便的方法调用。
`.load(url, [data], [callback])`	向`url`发出 Ajax 请求，并将响应放入匹配的元素中。
`$.get(url, [data], [callback], [returnType])`	使用`GET`方法向`url`发出 Ajax 请求。
`$.getJSON(url, [data], [callback])`	向`url`发出 Ajax 请求，将响应解释为 JSON 数据结构。
`$.getScript(url, [callback])`	向`url`发出 Ajax 请求，以 JavaScript 形式执行响应。
`$.post(url, [data], [callback], [returnType])`	使用`POST`方法向`url`发出 Ajax 请求。

请求监视

配置

公用事业

递延对象

延迟对象及其承诺允许我们使用方便的语法对长时间运行的任务的完成做出反应。在第 11 章、高级效果中详细讨论。

对象创建

延迟对象的方法

方法	说明
`.resolve([args])`	将对象的状态设置为已解析。
`.resolveWith(context, [args])`	将对象的状态设置为已解析，同时使关键字`this`在回调中引用`context`。
`.reject([args])`	将对象的状态设置为“已拒绝”。
`.rejectWith(context, [args])`	将对象的状态设置为拒绝，同时使关键字`this`在回调中引用`context`。
`.notify([args])`	执行任何进度回调。
`.notifyWith(context, [args])`	执行任何进度回调，同时使关键字`this`引用`context`。
`.promise([target])`	返回与此延迟对象对应的承诺对象。

承诺对象的方法

杂项属性和功能

这些实用程序方法不适合前面的类别，但在使用 jQuery 编写脚本时通常非常有用。

这本书是从 AvaxHome 下载的！

访问我的博客，了解更多新书：

https://avxhm.se/blogs/AlenMiler

jQuery 对象的属性

| 物业 | 说明 | | $.ready | 一个承诺实例，在 DOM 准备就绪后立即解析。 |

数组和对象

对象内省

功能	说明
`$.isArray(object)`	确定`object`是否为真正的 JavaScript 数组。
`$.isEmptyObject(object)`	确定`object`是否为空。
`$.isFunction(object)`	确定`object`是否为函数。
`$.isPlainObject(object)`	确定`object`是作为对象文字创建的还是使用`new Object`创建的。
`$.isNumeric(object)`	确定`object`是否为数值标量值。
`$.isWindow(object)`	确定`object`是否表示浏览器窗口。
`$.isXMLDoc(object)`	确定`object`是否为 XML 节点。
`$.type(object)`	获取`object`的 JavaScript 类。

另外

Files

15.md

Latest commit

History

15.md

File metadata and controls

十五、附录 B：快速参考

选择器表达式

简单 CSS

兄弟姐妹间的地位

匹配元素间的位置

属性

形式

杂项选择器

DOM 遍历方法

过滤

后代

兄弟姐妹

祖先

集合操纵

使用选定图元

事件方法

结合

速记装订

触发

速记触发

公用事业

效果方法

预定义效果

自定义动画

队列操作

DOM 操作方法

属性和属性

所容纳之物

CSS

尺寸

插入

替换

移动

临摹

数据

Ajax 方法

发出请求

请求监视

配置

公用事业

递延对象

对象创建

延迟对象的方法

承诺对象的方法

杂项属性和功能

jQuery 对象的属性

数组和对象

对象内省

另外