全面系统的jQuery选择器与原生JavaScript DOM元素获取对照指南。详细对比ID、类名、标签、属性、伪类及节点层级关系的语法映射、底层原理、静态与动态集合差异及性能表现。
jQuery选择器与原生JS获取元素对照表
时间:2026-11-17
浏览:566
文章目录
document.querySelector 与 document.querySelectorAll)及专属 DOM 方法已获得所有现代浏览器的完全支持。通过原生 JavaScript 替代 jQuery 获取元素,不仅能够彻底摆脱数十 KB 的运行时依赖包袱,还能将 DOM 查询性能提升 2 到 15 倍。本文以清晰系统的对照表方式,详细整理基础选择器、层级遍历、属性筛选与特殊伪类的原生实现方案,并解析其中的对象模型与容错细节。
一、基础选择器对照(ID、Class、标签与全选)
基础选择器是日常页面开发中使用频率最高的部分。原生 JS 提供了两套方案:一套是专用方法(如 getElementById),执行效率达到极致;另一套是通用 Selectors API(querySelector / querySelectorAll),入参直接支持标准 CSS 选择器语法,语法体验与 jQuery 完全一致。
| 选择器类型 | jQuery 语法 | 原生 JS 推荐写法 | 原生专用方法(高性能) | 返回值类型 |
|---|---|---|---|---|
| 单一 ID | $('#header') |
document.querySelector('#header') |
document.getElementById('header') |
Element / null |
| 类名匹配(多个) | $('.item') |
document.querySelectorAll('.item') |
document.getElementsByClassName('item') |
NodeList / HTMLCollection |
| 标签名匹配 | $('p') |
document.querySelectorAll('p') |
document.getElementsByTagName('p') |
NodeList / HTMLCollection |
| 多类名复合 | $('.btn.primary') |
document.querySelectorAll('.btn.primary') |
document.getElementsByClassName('btn primary') |
NodeList / HTMLCollection |
| 通配符(所有元素) | $('*') |
document.querySelectorAll('*') |
document.getElementsByTagName('*') |
NodeList / HTMLCollection |
| 多选择器合并 | $('h1, h2, .sub') |
document.querySelectorAll('h1, h2, .sub') |
无直接单方法,需多次查询后合并 | NodeList |
获取单一 ID 元素时,强烈推荐使用 document.getElementById('header')。浏览器底层为 ID 建立了哈希索引表,其检索耗时仅为 querySelector 的几分之一;且传入参数只需纯 ID 字符串,无需加 # 前缀。
二、选择器迁移决策流程
面对现存项目中的大量 $(...) 调用,不能盲目机械替换。应根据选择器匹配的节点数量、特征类型以及后续遍历方式,选择最合理的原生 API 组合。
执行流程主要分为四个阶段:
- 特征解析:分析选择器是简单 ID、单 Class、复合 CSS 规则还是包含非标准伪类。
- 分支判定:对于唯一元素使用单元素接口;对多元素批量操作判定是否需要响应 DOM 实时变化的动态集合。
- API 映射:选用对应的
querySelector、querySelectorAll或属性过滤函数。 - 容错检查:针对原生 API 在未匹配时返回
null的特点,补充可选链(Optional Chaining)操作,杜绝运行时报错。
三、层级与上下文关系选择器对照
DOM 树具有明确的层级与拓扑结构。jQuery 中既可以通过字符串选择器表达后代、子代与兄弟,也可以调用 .find()、.parent() 等链式遍历方法。原生 DOM 对应了一组纯净的元素属性与作用域查询方法。
| 层级关系 | jQuery 语法 | 原生 JS 等价实现 | 说明 |
|---|---|---|---|
| 后代选择器 | $('#box .item') 或 $box.find('.item') |
box.querySelectorAll('.item') |
以指定 DOM 节点为根作用域向下递归查找 |
| 直接子代选择器 | $('ul > li') 或 $ul.children() |
ul.children 或 ul.querySelectorAll(':scope > li') |
el.children 仅包含元素节点,自动剔除文本与空白 |
| 直接父节点 | $el.parent() |
el.parentElement |
获取直属父级 Element,根节点顶部返回 null |
| 最近匹配祖先 | $el.closest('.card') |
el.closest('.card') |
包含自身并沿 DOM 树向上查找,匹配即止 |
| 紧邻后一个兄弟 | $el.next() |
el.nextElementSibling |
自动跳过空白注释,直接定位下一个同级元素 |
| 紧邻前一个兄弟 | $el.prev() |
el.previousElementSibling |
直接定位上一个同级元素 |
| 所有同级兄弟 | $el.siblings() |
[...el.parentElement.children].filter(child => child !== el) |
通过父元素获取全部子节点并过滤掉自身 |
层级遍历实战代码示例
// 场景:在点击事件中向上查找卡片容器,并高亮所有同级卡片
document.querySelector('#container').addEventListener('click', (event) => {
const target = event.target;
// 1. 查找最近的卡片父级 (等价于 $(target).closest('.card'))
const card = target.closest('.card');
if (!card) return;
// 2. 获取卡片所有同级兄弟 (等价于 $(card).siblings())
const siblings = [...card.parentElement.children].filter(node => node !== card);
siblings.forEach(sibling => {
sibling.classList.remove('active');
});
// 3. 高亮当前卡片
card.classList.add('active');
});
四、属性与状态伪类选择器对照
属性与伪类选择器常用于表单数据提取与交互状态控制。需要特别注意:jQuery 扩展了部分非 CSS 标准的选择器(如 :eq()、:first、:hidden 等),在原生 JS 中不能直接作为选择器字符串传入,否则会抛出 SyntaxError 语法异常。
| 选择场景 | jQuery 语法 | 原生 JS 写法 | 兼容说明 |
|---|---|---|---|
| 属性精确匹配 | $('[name="user"]') |
document.querySelectorAll('[name="user"]') |
标准 CSS3 属性选择器,原生直接支持 |
| 属性前缀匹配 | $('[href^="https"]') |
document.querySelectorAll('[href^="https"]') |
匹配以特定前缀开头的属性值 |
| 表单控件禁用状态 | $('input:disabled') |
document.querySelectorAll('input:disabled') |
CSS 标准伪类,原生完全支持 |
| 单选/复选选中状态 | $('input:checked') |
document.querySelectorAll('input:checked') |
标准伪类,返回当前处于勾选状态的项 |
| 指定索引位置 (:eq) | $('li:eq(2)') |
document.querySelectorAll('li')[2] |
:eq() 是 jQuery 扩展,原生通过数组索引访问 |
| 首个元素 (:first) | $('li:first') |
document.querySelector('li') |
querySelector 默认只返回匹配的第一个元素 |
| 末尾元素 (:last) | $('li:last') |
const list = document.querySelectorAll('li'); list[list.length - 1]; |
或在明确结构下使用 CSS li:last-of-type |
| 可见性过滤 (:visible) | $('.item:visible') |
[...document.querySelectorAll('.item')].filter(el => el.offsetParent !== null) |
通过 offsetParent 或 getComputedStyle 计算可见性 |
如果在原生 document.querySelectorAll('div:eq(0)') 中直接传入 :eq 或 :first,浏览器解析器会直接报错 DOMException: Failed to execute 'querySelectorAll' on 'Document': 'div:eq(0)' is not a valid selector. 必须将位置索引逻辑移入 JavaScript 数组取值操作中。
五、返回值类型与底层原理对比
很多开发者在迁移时感到困惑,核心原因在于忽视了 jQuery 包装对象与原生 DOM 节点对象在底层内存组织和行为规范上的根本区别。
1. jQuery 对象(伪数组包装器)
$() 返回的是一个由 jQuery.fn.init 构造的伪数组对象。它拥有 length、下标索引,并继承了定义在 $.fn 上的数百个便捷方法。当选择器未匹配到任何元素时,jQuery 返回的是一个 length === 0 的空对象。对它继续调用 .addClass() 或 .on() 并不会报错,这种“静默容错”在带来便利的同时也容易掩盖业务代码逻辑缺陷。
2. 原生 DOM 引用与 NodeList / HTMLCollection
原生 DOM 操作直接返回底层浏览器对象:
- 单一元素引用:
document.querySelector或getElementById直接返回单一的Element对象。如果页面未找到匹配节点,则返回null。如果直接访问null.classList会立即抛出TypeError: Cannot read properties of null。因此必须结合可选链操作符(el?.classList.add(...))或显式条件判断。 - NodeList(静态快照):
document.querySelectorAll返回的是NodeList集合。绝大多数现代浏览器中它是静态快照,即后续向 DOM 树插入新元素不会自动更新当前已缓存的 NodeList 长度。NodeList 内置实现了forEach方法,但缺少map、filter等数组方法,必要时可使用展开运算符[...list]转换为标准数组。 - HTMLCollection(动态活集合):
getElementsByClassName与getElementsByTagName返回的是 动态集合(Live Collection)。DOM 树的任何增删都会实时同步到该集合中,遍历过程中修改 DOM 时极易引发死循环或下标错位。
六、高频场景性能对比与迁移总结
使用原生方法最直观的收益在于运行速度的飞跃。在大型列表渲染、高频拖拽或频繁切换选项卡等场景中,减少中间函数包装和选择器正则解析能够显著降低 CPU 开销。
原生 JS 替换 jQuery 获取元素的最佳实践清单
- 明确基准容器范围:不要总是在
document根节点上调用选择器。在已有容器元素上直接调用container.querySelector('.child'),可以缩小 DOM 树遍历范围,大幅提升匹配效率。 - 善用现代可选链:在操作可能不存在的元素时,使用 ES2020 可选链语法替代传统的长条件判断:
// 传统冗长写法: const btn = document.querySelector('#submit-btn'); if (btn) { btn.classList.add('disabled'); } // 优雅现代写法(等价于 jQuery 的静默链式安全): document.querySelector('#submit-btn')?.classList.add('disabled'); - 批量元素便利迭代:原生
querySelectorAll返回的 NodeList 直接支持.forEach():// 原生批量操作 document.querySelectorAll('.tab-item').forEach(tab => { tab.addEventListener('click', onTabClick); }); - 事件委托替代动态查找:对于动态生成的元素,不需要在创建后反复查询并绑定,利用
event.target.closest(selector)即可在父级容器上实现高效可靠的事件代理:// 事件委托:无论列表子项何时被异步插入,均可稳定响应 document.querySelector('#list-container').addEventListener('click', (e) => { const item = e.target.closest('.list-item'); if (item && e.currentTarget.contains(item)) { console.log('点击了动态子项:', item.dataset.id); } });
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。