当前位置:首页 > jquery

jquery.val

2026-03-17 06:27:30jquery

jQuery .val() 方法详解

jQuery 的 .val() 方法是用于获取或设置表单元素值的核心方法,支持输入框、下拉框、单选按钮等多种表单元素。以下是具体用法和示例:

获取表单元素的值

调用无参数的 .val() 会返回匹配的第一个元素的值:

// 获取输入框的值
const username = $('#username').val();

// 获取单选按钮的值(需选中状态)
const gender = $('input[name="gender"]:checked').val();

// 获取下拉框选中项的值
const country = $('#country').val();

设置表单元素的值

传递参数会设置所有匹配元素的值:

// 设置输入框的值
$('#username').val('默认用户');

// 设置单选按钮/复选框的选中状态
$('input[name="subscribe"]').val(['yes']); // 勾选值为"yes"的选项

// 设置下拉框选中项
$('#country').val('CN'); // 选中value="CN"的选项

特殊表单元素处理

多选下拉框:返回数组形式的值

// 获取所有选中的选项值(数组)
const selected = $('#multi-select').val(); 

// 设置多个选中项
$('#multi-select').val(['opt1', 'opt3']);

文本域(textarea):与输入框用法一致

// 获取/设置文本内容
const content = $('#comment').val();
$('#comment').val('请输入内容');

链式调用示例

.val() 可与其他 jQuery 方法链式组合:

jquery.val

// 清空输入框并聚焦
$('#search')
  .val('')
  .focus();

注意事项

  • 对普通非表单元素(如 divspan)使用 .val() 会返回 undefined
  • 设置下拉框时若值不存在,则不会选中任何选项。
  • jQuery 3.0+ 版本中,.val() 对隐藏元素返回空字符串(早期版本可能返回 undefined)。

标签: jqueryval
分享给朋友:

相关文章

jquery教程

jquery教程

jQuery 简介 jQuery 是一个快速、简洁的 JavaScript 库,简化了 HTML 文档遍历、事件处理、动画设计和 Ajax 交互。其核心特点是“写得更少,做得更多”(Write Les…

jquery插件库

jquery插件库

jQuery插件库推荐 jQuery插件库提供了丰富的扩展功能,帮助开发者快速实现常见的前端交互效果。以下是一些常用的jQuery插件库和资源: 1. 官方jQuery插件注册中心jQuery Pl…

jquery手册

jquery手册

jQuery手册概览 jQuery是一个快速、简洁的JavaScript库,简化了HTML文档遍历、事件处理、动画和Ajax交互。以下是核心功能和常用方法的分类整理。 核心方法 $(selector…

jquery判断

jquery判断

jQuery 判断元素存在与属性方法 使用 jQuery 判断元素是否存在可通过检查选择器返回的 jQuery 对象长度: if ($('#elementId').length > 0) {…

jquery对象

jquery对象

jQuery 对象简介 jQuery 对象是通过 jQuery 选择器或方法创建的封装了 DOM 元素集合的对象。它提供了一系列便捷的方法来操作 DOM、处理事件、实现动画等。与原生 DOM 对象不同…

jquery 加载

jquery 加载

jQuery 加载方法 使用jQuery需要先将其库文件加载到网页中。以下是几种常见的加载方式: 通过CDN加载 推荐使用官方或公共CDN(内容分发网络)加载jQuery,速度快且可能被浏览器缓存:…