• jQuery
  • jQuery UI
  • jQuery Mobile
  • Sizzle
  • QUnit
  • 插件 (Plugins)
  • 贡献 (Contribute)
    • CLA
    • 风格指南 (Style Guides)
    • Bug 分类 (Bug Triage)
    • 代码 (Code)
    • 文档 (Documentation)
    • 网站 (Web Sites)
  • 活动 (Events)
  • 支持 (Support)
    • 学习中心 (Learning Center)
    • 聊天 (Chat)
    • Stack Overflow
    • 报告 Bug (Report a bug)
  • OpenJS 基金会
    • 加入 (Join)
    • 成员 (Members)
    • jQuery 团队
    • 治理 (Governance)
    • 行为准则 (Conduct)
    • 项目 (Projects)

jQuery API 文档

  • 下载 (Download)
  • API 文档
  • 博客 (Blog)
  • 插件 (Plugins)
  • 浏览器支持
  • 版本支持

类别: 选择器


jQuery 借鉴了 CSS 1-3 标准,并在此基础上进行了扩展,提供了一套强大的工具,用于在文档中匹配一组元素。

要将任何元字符(例如 !"#$%&'()*+,./:;<=>?@[\]^`{|}~ )用作名称的字面部分,必须用两个反斜杠进行转义:\\。例如,一个 `id="foo.bar"` 的元素,可以使用选择器 `$("#foo\\.bar")`。W3C CSS 规范包含了 关于有效 CSS 选择器的完整规则集。Mathias Bynens 关于 CSS 标识符字符转义序列 的博文也很有用。

也在: 选择器 > 基本 CSS 选择器

所有选择器 (“*”)

选择所有元素。

也在: 选择器 > 基本过滤器选择器 | 选择器 > jQuery 选择器扩展

:animated 选择器

选择在选择器运行时处于动画进行中的所有元素。

也在: 选择器 > 属性选择器

属性包含前缀选择器 [name|=”value”]

选择具有指定属性的元素,其值等于给定字符串或以该字符串后跟连字符 (-) 开头。

也在: 选择器 > 属性选择器

属性包含选择器 [name*=”value”]

选择具有指定属性的元素,其值包含给定子字符串。

也在: 选择器 > 属性选择器

属性包含单词选择器 [name~=”value”]

选择具有指定属性的元素,其值包含一个由空格分隔的给定单词。

也在: 选择器 > 属性选择器

属性以…结尾选择器 [name$=”value”]

选择具有指定属性的元素,其值精确地以给定字符串结尾。比较区分大小写。

也在: 选择器 > 属性选择器

属性等于选择器 [name=”value”]

选择具有指定属性的元素,其值精确等于某个值。

也在: 选择器 > 属性选择器 | 选择器 > jQuery 选择器扩展

属性不等于选择器 [name!=”value”]

选择不具有指定属性的元素,或者具有指定属性但值不为某个特定值的元素。

也在: 选择器 > 属性选择器

属性以选择器开头 [name^=”value”]

选择具有指定属性的元素,其值精确地以给定字符串开头。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:button 选择器

选择所有按钮元素和类型为 button 的元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:checkbox 选择器

选择所有类型为 checkbox 的元素。

也在: 选择器 > 表单选择器

:checked 选择器

匹配所有被选中或已选择的元素。

也在: 选择器 > 层级选择器

子选择器(“parent > child”)

选择所有由“parent”指定的元素的直接子元素中由“child”指定的所有元素。

也在: 选择器 > 基本 CSS 选择器

类选择器 (“.class”)

选择所有具有给定类的元素。

也在: 选择器 > 内容过滤器选择器 | 选择器 > jQuery 选择器扩展

:contains() 选择器

选择所有包含指定文本的元素。

也在: 选择器 > 层级选择器

后代选择器(“ancestor descendant”)

选择作为给定祖先元素的后代的所有元素。

也在: 选择器 > 表单选择器

:disabled 选择器

选择所有被禁用的元素。

也在: 选择器 > 基本 CSS 选择器

元素选择器(“element”)

选择所有具有给定标签名的元素。

也在: 选择器 > 内容过滤器选择器

:empty 选择器

选择所有没有子元素(包括文本节点)的元素。

也在: 选择器 > 表单选择器

:enabled 选择器

选择所有已启用的元素。

亦收录于:选择器 > 基本筛选 | 已弃用 > 已弃用 3.4 | 选择器 > jQuery 扩展

:eq() 选择器

选择匹配集中索引为 n 的元素。

亦收录于:选择器 > 基本筛选 | 已弃用 > 已弃用 3.4 | 选择器 > jQuery 扩展

:even 选择器

选择偶数元素,零索引。另请参阅 :odd。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:file 选择器

选择所有类型为 file 的元素。

也在: 选择器 > 子元素过滤器选择器

:first-child 选择器

选择所有作为其父元素第一个子元素的元素。

也在: 选择器 > 子元素过滤器选择器

:first-of-type 选择器

选择所有在相同元素名称的兄弟元素中是第一个的元素。

亦收录于:选择器 > 基本筛选 | 已弃用 > 已弃用 3.4 | 选择器 > jQuery 扩展

:first 选择器

选择第一个匹配的 DOM 元素。

也在: 选择器 > 基本过滤器选择器 | 选择器 > 表单选择器

:focus 选择器

如果元素当前处于焦点,则选择该元素。

亦收录于:选择器 > 基本筛选 | 已弃用 > 已弃用 3.4 | 选择器 > jQuery 扩展

:gt() 选择器

选择匹配集中索引大于给定索引的所有元素。

也在: 选择器 > 属性选择器

具有属性选择器 [name]

选择具有指定属性且值不限的元素。

也在: 选择器 > 内容过滤器选择器 | 选择器 > jQuery 选择器扩展

:has() 选择器

选择至少包含一个匹配指定选择器的元素的元素。

也在: 选择器 > 基本过滤器选择器 | 选择器 > jQuery 选择器扩展

:header 选择器

选择所有标题元素,如 h1、h2、h3 等。

也在: 选择器 > jQuery 选择器扩展 | 选择器 > 可见性过滤器选择器

:hidden 选择器

选择所有隐藏的元素。

也在: 选择器 > 基本 CSS 选择器

ID 选择器 (“#id”)

选择具有给定 ID 属性的单个元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:image 选择器

选择所有类型为 image 的元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:input 选择器

选择所有 input、textarea、select 和 button 元素。

也收录于:选择器 > 基本过滤

:lang() 选择器

选择指定语言的所有元素。

也在: 选择器 > 子元素过滤器选择器

:last-child 选择器

选择所有作为其父元素最后一个子元素的元素。

也在: 选择器 > 子元素过滤器选择器

:last-of-type 选择器

选择所有在相同元素名称的兄弟元素中是最后一个的元素。

亦收录于:选择器 > 基本筛选 | 已弃用 > 已弃用 3.4 | 选择器 > jQuery 扩展

:last 选择器

选择最后一个匹配的元素。

亦收录于:选择器 > 基本筛选 | 已弃用 > 已弃用 3.4 | 选择器 > jQuery 扩展

:lt() 选择器

选择匹配集中索引小于给定索引的所有元素。

也在: 选择器 > 属性选择器

多属性选择器 [name=”value”][name2=”value2″]

匹配符合所有指定属性过滤器的元素。

也在: 选择器 > 基本 CSS 选择器

多重选择器 (“selector1, selector2, selectorN”)

选择所有指定选择器的组合结果。

也在: 选择器 > 层级选择器

相邻兄弟选择器(“prev + next”)

选择所有紧接在兄弟元素“prev”之后的、匹配“next”的下一个元素。

也在: 选择器 > 层级选择器

后续兄弟选择器(“prev ~ siblings”)

选择所有在“prev”元素之后、具有相同父元素并匹配筛选器“siblings”选择器的兄弟元素。

也收录于:选择器 > 基本过滤

:not() 选择器

选择所有不匹配给定选择器的元素。

也在: 选择器 > 子元素过滤器选择器

:nth-child() 选择器

选择所有作为其父元素第 n 个子元素的元素。

也在: 选择器 > 子元素过滤器选择器

:nth-last-child() 选择器

选择所有作为其父元素第 n 个子元素的元素,从最后一个元素开始计数到第一个。

也在: 选择器 > 子元素过滤器选择器

:nth-last-of-type() 选择器

选择所有与其父元素中具有相同元素名称的兄弟元素相关的第 n 个子元素,从最后一个元素开始计数到第一个。

也在: 选择器 > 子元素过滤器选择器

:nth-of-type() 选择器

选择所有与其父元素中具有相同元素名称的兄弟元素相关的第 n 个子元素。

亦收录于:选择器 > 基本筛选 | 已弃用 > 已弃用 3.4 | 选择器 > jQuery 扩展

:odd 选择器

选择奇数元素,零索引。另请参阅 :even。

也在: 选择器 > 子元素过滤器选择器

:only-child 选择器

选择所有作为其父元素唯一子元素的元素。

也在: 选择器 > 子元素过滤器选择器

:only-of-type 选择器

选择所有没有相同元素名称的兄弟元素的元素。

也在: 选择器 > 内容过滤器选择器 | 选择器 > jQuery 选择器扩展

:parent 选择器

选择所有至少有一个子节点(元素或文本)的元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:password 选择器

选择所有类型为 password 的元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:radio 选择器

选择所有类型为 radio 的元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:reset 选择器

选择所有类型为 reset 的元素。

也收录于:选择器 > 基本过滤

:root 选择器

选择文档的根元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:selected 选择器

选择所有已选择的元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:submit 选择器

选择所有类型为 submit 的元素。

也收录于:选择器 > 基本过滤

:target 选择器

选择由文档 URI 的片段标识符指示的目标元素。

也在: 选择器 > 表单选择器 | 选择器 > jQuery 选择器扩展

:text 选择器

选择所有类型为 text 的 input 元素。

也在: 选择器 > jQuery 选择器扩展 | 选择器 > 可见性过滤器选择器

:visible 选择器

选择所有可见的元素。

  • Ajax
    • 全局 Ajax 事件处理器
    • 辅助函数 (Helper Functions)
    • 底层接口
    • 快捷方法 (Shorthand Methods)
  • 属性 (Attributes)
  • 回调对象 (Callbacks Object)
  • 核心 (Core)
  • CSS
  • 数据 (Data)
  • 延迟对象 (Deferred Object)
  • 已弃用 (Deprecated)
    • 1.3 版弃用
    • 1.7 版弃用
    • 1.8 版弃用
    • 1.9 版弃用
    • 1.10 & 2.0 版弃用
    • 3.0 版弃用
    • 3.2 版弃用
    • 3.3 版弃用
    • 3.4 版弃用
    • 3.5 版弃用
    • 3.7 版弃用
  • 尺寸 (Dimensions)
  • 特效 (Effects)
    • 基础
    • 自定义
    • 渐变 (Fading)
    • 滑动 (Sliding)
  • 活动 (Events)
    • 浏览器事件
    • 文档加载
    • 事件处理器绑定
    • 事件对象
    • 表单事件
    • 键盘事件
    • 鼠标事件
  • 表单 (Forms)
  • 内部机制
  • 操作 (Manipulation)
    • 类属性
    • 复制
    • DOM 插入,环绕
    • DOM 插入,内部
    • DOM 插入,外部
    • DOM 移除
    • DOM 替换
    • 通用属性
    • 样式属性
  • 杂项 (Miscellaneous)
    • 集合操作
    • 数据存储
    • DOM 元素方法
    • 设置方法
  • 偏移 (Offset)
  • 属性 (Properties)
    • jQuery 对象实例属性
    • 全局 jQuery 对象属性
  • 已移除 (Removed)
  • 选择器 (Selectors)
    • 属性
    • 基础
    • 基础过滤
    • 子元素过滤
    • 内容过滤
    • 表单
    • 层级
    • jQuery 扩展
    • 可见性过滤
  • 遍历 (Traversing)
    • 筛选 (Filtering)
    • 杂项遍历
    • 树遍历
  • 实用工具 (Utilities)
  • 版本
    • 1.0 版
    • 1.0.4 版
    • 1.1 版
    • 1.1.2 版
    • 1.1.3 版
    • 1.1.4 版
    • 1.2 版
    • 1.2.3 版
    • 1.2.6 版
    • 1.3 版
    • 1.4 版
    • 1.4.1 版
    • 1.4.2 版
    • 1.4.3 版
    • 1.4.4 版
    • 1.5 版
    • 1.5.1 版
    • 1.6 版
    • 1.7 版
    • 1.8 版
    • 1.9 版
    • 1.11 & 2.1 版
    • 1.12 & 2.2 版
    • 3.0 版
    • 3.1 版
    • 3.2 版
    • 3.3 版
    • 3.4 版
    • 3.5 版
    • 3.6 版
    • 3.7 版
    • 4.0 版

图书

  • Learning jQuery 4th Edition by Karl Swedberg and Jonathan Chaffer 《Learning jQuery》第四版 Karl Swedberg 和 Jonathan Chaffer 著
  • jQuery in Action by Bear Bibeault, Yehuda Katz, and Aurelio De Rosa 《jQuery 实战》 Bear Bibeault, Yehuda Katz, 和 Aurelio De Rosa 著
  • jQuery Succinctly by Cody Lindley 《jQuery 简明教程》 Cody Lindley 著
  • 学习中心 (Learning Center)
  • 聊天 (Chat)
  • Twitter
  • GitHub

Copyright 2026 OpenJS Foundation 和 jQuery 贡献者。保留所有权利。更多信息请参见 jQuery 许可证。 OpenJS Foundation 拥有注册商标并使用商标。OpenJS Foundation 的商标列表请参见我们的 商标政策 和 商标列表。未在 OpenJS Foundation 商标列表 中标明的商标和徽标是其各自所有者的商标™ 或注册® 商标。使用它们并不暗示与它们有任何关联或得到其认可。OpenJS Foundation 的 使用条款、隐私政策、行为准则 和 Cookie 政策也适用。

Web 托管由 Digital Ocean 提供 | CDN 由 Fastly 提供 | 由 WordPress 强力驱动