原生JS与jQuery获取input值的写法对比

作者:页面旅途

时间:2026-11-22

浏览:124

深入对比原生JavaScript与jQuery获取input输入框值的核心语法、底层运行机制、单选复选控件差异、空值安全容错及开发选型建议。

文章目录
主题:Web前端技术对比 适用范围:HTML5表单交互、DOM API、jQuery 1.x-3.x 核心要点:语法差异、内部机制、复合控件、异常处理
原生JS与jQuery获取input值的写法对比

在前端开发中获取表单输入框(input)的值是最频繁的交互操作之一。核心结论是:原生 JavaScript 是直接读取目标 DOM 节点的内置属性 .value,而 jQuery 是通过选择器构建一个类数组包装集后调用原型方法 .val()。两者在语法形式、底层对象结构、空节点容错策略以及单选/复选等复杂控件的处理流程上存在明显差别。

一、基础文本框(text/password/number)的获取对比

对于单行文本输入框、密码框及数字框,用户输入的内容在 DOM 层面统一维护在控件的属性对象中。两种写法在定位元素和提取数据时的写法形式如下:

1. HTML 基础表单结构

<!-- 示例表单项 -->
<input type="text" id="username" name="user_account" value="Alice" />
<input type="number" id="userAge" value="28" />

2. 原生 JavaScript 获取方式

原生 JS 提供了多种 DOM 查询 API,获取到对应的 HTMLInputElement 实例后,直接读取 .value 字符串属性:

// 方式一:通过唯一 ID 精准获取
const nameInput = document.getElementById('username');
const nameVal = nameInput.value; // "Alice"

// 方式二:通过 CSS 选择器获取
const ageInput = document.querySelector('#userAge');
const ageVal = ageInput ? ageInput.value : ''; // "28"(注意返回值为字符串)

3. jQuery 获取方式

jQuery 使用统一的 $() 函数包裹选择器,并直接链式调用 .val():

// 通过 ID 选择器并调用 .val()
const jqName = $('#username').val(); // "Alice"
const jqAge = $('#userAge').val();   // "28"
原生JS与jQuery获取input值的写法对比
图 1:原生 JS 与 jQuery 获取文本输入框值的执行链路与步骤拆解

二、底层机制与对象模型差异

表面上看 .value 与 .val() 仅是属性与函数的差别,但背后代表着两套截然不同的内存与对象模型设计:

  • 原生 DOM 属性读写:document.getElementById 返回的是宿主环境直接提供的 HTMLInputElement 对象,该对象映射着浏览器排版引擎中的实际节点。读取 .value 属于直接触发 JavaScript 引擎与底层 C++ 绑定的 Getter 访问器,开销仅为单次属性寻址,执行性能极高。
  • jQuery 包装集封装机制:$('#username') 执行后返回的是一个 jQuery 原型对象(类数组结构),内部包含匹配到的 DOM 元素数组索引(如 this[0])、选择器上下文和集合长度。调用 .val() 时,jQuery 会提取内部索引为 0 的元素,并经过内部的 valHooks 钩子函数抹平历史浏览器及特殊控件类型的差异,最后才返回处理后的值。
原生JS与jQuery获取input值的写法对比
图 2:原生 DOM 对象与 jQuery 包装集结构及互转链路
相互转换规则:在需要混合使用的场景下,可随时在二者间切换:
• DOM 转 jQuery:使用 $(domNode).val()
• jQuery 转 DOM:使用 $('#username')[0].value 或 $('#username').get(0).value

三、单选框(Radio)与多选框(Checkbox)取值对比

单选框与复选框通常存在一组同名(name 相同)但取值不同的 input 控件。此时仅凭简单 ID 选择器无法满足业务需求,需要结合状态选择器(:checked)进行精准过滤。

1. 单选框(Radio)取值

<!-- 单选按钮组 -->
<input type="radio" name="gender" value="male" /> 男
<input type="radio" name="gender" value="female" checked /> 女

原生 JS 写法:利用 CSS3 的伪类选择器 :checked 抓取被选中的单项:

// 原生 JS 推荐使用可选链(?.)避免未选中时报错
const checkedRadio = document.querySelector('input[name="gender"]:checked');
const genderVal = checkedRadio?.value ?? ''; // "female"

jQuery 写法:同样的伪类选择器,配合 .val() 自动提取首项值:

const jqGender = $('input[name="gender"]:checked').val(); // "female"

2. 复选框(Checkbox)多项取值

<!-- 复选框组 -->
<input type="checkbox" name="skill" value="JS" checked /> JavaScript
<input type="checkbox" name="skill" value="CSS" checked /> CSS
<input type="checkbox" name="skill" value="HTML" /> HTML

在复选框场景下,用户可能选中多项,因此必须收集由字符串构成的数组,而不能仅读取单个控件的值。

原生 JS 集合映射:使用 document.querySelectorAll 获取选中的 NodeList,通过 Array.from() 快速映射为值数组:

const checkedNodes = document.querySelectorAll('input[name="skill"]:checked');
const skills = Array.from(checkedNodes, node => node.value);
// 结果:["JS", "CSS"]

jQuery 集合管道:如果直接对复选框集合调用 .val(),jQuery 默认只会返回匹配集合中第一个元素的值。要获取全部已选项,必须链式使用 .map() 并在尾部追加 .get():

const jqSkills = $('input[name="skill"]:checked')
  .map(function() {
    return $(this).val();
  })
  .get(); // 必须调用 .get() 还原为原生 Array,否则是 jQuery 包装对象
// 结果:["JS", "CSS"]
原生JS与jQuery获取input值的写法对比
图 3:单选与复选控件在原生 JS 与 jQuery 中的状态过滤与数据提取流程

四、空元素安全与赋值写入对比

在实际页面运行过程中,可能因为 DOM 异步渲染延迟、条件渲染未完成或选择器书写失误,导致目标 input 并不存在于页面中。此时两者的错误表现和处理方式完全不同。

1. 空匹配(元素不存在)时的容错表现

  • 原生 JS 的抛错风险:若执行 document.getElementById('not_exist').value,由于 getElementById 返回 null,紧接着访问 .value 会触发运行时致命异常:TypeError: Cannot read properties of null (reading 'value'),导致后续脚本逻辑中断。在 ES2020 之前必须手动写 if (el) 防御,现代写法建议统一采用可选链 el?.value。
  • jQuery 的静默空安全:若执行 $('#not_exist').val(),jQuery 选择器返回的是一个 length 为 0 的空包装集。调用 .val() 时内部发现 this[0] 为空,直接安全返回 undefined,不会抛出异常中断执行。

2. 赋值(写入新值)时的写法对比

表单交互不仅涉及“读”,还经常需要“写”。

// 原生 JS 赋值:直接给属性赋值
const inputElem = document.getElementById('username');
if (inputElem) {
  inputElem.value = 'Bob';
}

// jQuery 赋值:调用同一方法传入实参,具备链式调用能力
$('#username').val('Bob').css('border-color', '#345E82');

五、综合对比与选型指南

在现代工程项目中,选择原生 API 还是 jQuery 取决于项目的架构环境、体积要求和兼容性目标。

对比指标 原生 JavaScript (ES6+) jQuery 库
核心语法 element.value $(selector).val()
网络与打包体积 0 KB(浏览器原生内置) ~30 KB(压缩后生产包体积)
执行效率 极快,原生 C++ 底层调用,无封装层损耗 微小封装开销(包含实例化与钩子检查)
空值访问安全性 若未判空会抛出 TypeError,建议 el?.value 自动静默处理,空匹配返回 undefined
多选批量提取 Array.from(nodeList, e => e.value) $('...:checked').map(...).get()
链式调用 不支持,需独立拆分语句 原生支持连贯方法链
原生JS与jQuery获取input值的写法对比
图 4:原生 JS 与 jQuery 表单输入值操作方法与决策速查指南

六、总结与实践建议

原生 JS 的 .value 具有零依赖、高性能和原生标准化的天然优势。随着现代浏览器对 ECMAScript 新特性的普及(如可选链 ?. 和空值合并运算符 ??),原生语法以往存在的空指针问题已被极大简化。因此在 Vue、React、原生微前端或无需引入重量级库的轻量项目中,优先使用原生 document.querySelector 与 .value 属性是更为稳健的标准实践。

而对于依然依赖 jQuery 的传统企业级系统、旧版 CMS 模板二次开发或追求极致编写速度的小型脚本,jQuery 的 .val() 依然凭借其隐式迭代、容错性和跨浏览器兼容层发挥着稳定的作用。根据项目现有的技术栈合理选用,能有效保证开发效率与运行稳定。

实用工具推荐

电子包浆

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

使用 ›
图片压缩

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

使用 ›
相关文章