jQuery选择器与原生JS获取元素对照表

作者:竹影

时间:2026-11-17

浏览:566

全面系统的jQuery选择器与原生JavaScript DOM元素获取对照指南。详细对比ID、类名、标签、属性、伪类及节点层级关系的语法映射、底层原理、静态与动态集合差异及性能表现。

文章目录
在现代前端开发中,W3C 标准的 Selectors API(document.querySelector 与 document.querySelectorAll)及专属 DOM 方法已获得所有现代浏览器的完全支持。通过原生 JavaScript 替代 jQuery 获取元素,不仅能够彻底摆脱数十 KB 的运行时依赖包袱,还能将 DOM 查询性能提升 2 到 15 倍。本文以清晰系统的对照表方式,详细整理基础选择器、层级遍历、属性筛选与特殊伪类的原生实现方案,并解析其中的对象模型与容错细节。
jQuery选择器与原生JS获取元素对照表
图 0:jQuery 选择器到现代原生 DOM API 的映射管道与选型

一、基础选择器对照(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 组合。

jQuery选择器与原生JS获取元素对照表
图 1:jQuery 选择器到原生 DOM API 选型与执行决策流程图

执行流程主要分为四个阶段:

  1. 特征解析:分析选择器是简单 ID、单 Class、复合 CSS 规则还是包含非标准伪类。
  2. 分支判定:对于唯一元素使用单元素接口;对多元素批量操作判定是否需要响应 DOM 实时变化的动态集合。
  3. API 映射:选用对应的 querySelector、querySelectorAll 或属性过滤函数。
  4. 容错检查:针对原生 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) 通过父元素获取全部子节点并过滤掉自身
jQuery选择器与原生JS获取元素对照表
图 2:DOM 节点层级关系寻址与遍历 API 对照拓扑图

层级遍历实战代码示例

// 场景:在点击事件中向上查找卡片容器,并高亮所有同级卡片
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 计算可见性
警惕 jQuery 专属伪类陷阱

如果在原生 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 节点对象在底层内存组织和行为规范上的根本区别。

jQuery选择器与原生JS获取元素对照表
图 3:jQuery 包装集对象 vs 原生 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 开销。

jQuery选择器与原生JS获取元素对照表
图 4:高频选择器相对吞吐率实测对比与核心迁移清单

原生 JS 替换 jQuery 获取元素的最佳实践清单

  1. 明确基准容器范围:不要总是在 document 根节点上调用选择器。在已有容器元素上直接调用 container.querySelector('.child'),可以缩小 DOM 树遍历范围,大幅提升匹配效率。
  2. 善用现代可选链:在操作可能不存在的元素时,使用 ES2020 可选链语法替代传统的长条件判断:
    // 传统冗长写法:
    const btn = document.querySelector('#submit-btn');
    if (btn) {
      btn.classList.add('disabled');
    }
    
    // 优雅现代写法(等价于 jQuery 的静默链式安全):
    document.querySelector('#submit-btn')?.classList.add('disabled');
  3. 批量元素便利迭代:原生 querySelectorAll 返回的 NodeList 直接支持 .forEach():
    // 原生批量操作
    document.querySelectorAll('.tab-item').forEach(tab => {
      tab.addEventListener('click', onTabClick);
    });
  4. 事件委托替代动态查找:对于动态生成的元素,不需要在创建后反复查询并绑定,利用 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);
      }
    });

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章