0

0

layui form表单清空 layui如何重置form表单数据

煙雲

煙雲

发布时间:2026-03-17 13:49:41

|

316人浏览过

|

来源于php中文网

原创

layui form.reset() 不生效是因为未传入正确DOM节点或未调用form.render(),且对layui组件无效,需结合form.val()手动重置各组件状态并重新渲染。

layui form.reset() 不生效的常见原因

直接调用 form.reset() 没反应,大概率是因为没传入正确的表单 dom 节点,或者表单还没被 form.render() 过。

layui 的 form.reset() 不是全局方法,它只重置你传进去的那个 <form> 元素内部的原生控件(inputselecttextarea),对 layui 渲染后的下拉框、开关、日期等组件**完全无效**——这些组件的状态得单独处理。

  • 必须传入表单的 DOM 对象,比如 document.getElementById('myForm'),不能传 jQuery 对象或选择器字符串
  • 如果表单里有 lay-selectlay-datelay-switch,它们的 UI 状态不会随 form.reset() 改变
  • 表单若通过 form.render() 初始化过,重置后建议再调一次 form.render(),否则部分组件可能显示异常(比如 select 仍显示旧选项)

清空 layui 渲染组件的正确组合操作

要真正“清空”一个含 layui 组件的表单,得手动补全原生重置 + 组件状态重置。核心思路:先用 form.reset() 清原生值,再逐个调用组件的赋值 API 把 UI 设为空。

  • select 下拉框:用 form.val('filter', { 'fieldName': '' }),然后 form.render('select', 'filter')
  • checkbox / radio:设为 null 或空数组(多选):form.val('filter', { 'agree': null })
  • switch 开关:必须设为 false,设 ''null 无效:form.val('filter', { 'isPublish': false })
  • date / datetime:设为空字符串 '',不是 nullform.val('filter', { 'publishTime': '' })
  • 所有操作完后,建议统一调一次 form.render(),避免渲染残留

封装一个可靠的 resetForm 函数

重复写一堆 form.val() 很容易漏字段,也难维护。推荐封装一个函数,自动遍历表单内所有带 name 的控件,并按类型设默认空值。

function resetForm(filter, formElem) {
  // 原生重置
  if (formElem && formElem.reset) formElem.reset();
  
  // 清空 layui 组件值
  const emptyVals = {};
  const $elems = $(formElem).find('[name]').add(formElem.querySelectorAll('[name]'));
  $elems.each(function() {
    const name = this.name;
    const type = this.type || '';
    if (!name) return;

    if (['checkbox', 'radio'].includes(type)) {
      emptyVals[name] = null;
    } else if (type === 'select-one' || type === 'select-multiple') {
      emptyVals[name] = '';
    } else if (['date', 'datetime-local', 'month'].includes(type)) {
      emptyVals[name] = '';
    } else {
      emptyVals[name] = '';
    }
  });

  form.val(filter, emptyVals);
  form.render(null, filter); // 重渲染全部组件
}

调用时只需传入你的表单 filter 名和 DOM 元素:resetForm('userForm', document.getElementById('userForm'))

ProcessOn
ProcessOn

免费在线流程图思维导图,专业强大的作图工具,支持多人实时在线协作

下载

注意 hidden 字段和动态添加字段的陷阱

hidden 输入框常被忽略,但它有 name,会被 form.val() 读取和设置——如果你没在 emptyVals 里显式覆盖它,它的值可能保持不变,导致提交时带上脏数据。

动态插入的字段(比如点击“添加一行”后追加的 input)如果没在初始 form.render() 时纳入,它们既不会被 form.reset() 清,也不会被 form.val() 操作到。

  • hidden 字段务必显式设空:emptyVals['token'] = ''
  • 动态字段需在插入后立即调用 form.render('select') 等对应类型渲染,且重置前要确保它们已存在于 DOM 中
  • 如果表单结构复杂,比手动清空更稳的方式是:销毁整个表单 DOM 并重建(适合 modal 表单场景)

真正的难点不在“怎么清”,而在“清哪些”和“清完是否真干净”。尤其当表单混用原生控件、layui 组件、第三方插件时,别迷信一键重置——逐项验证才是最省时间的做法。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
jquery插件有哪些
jquery插件有哪些

jquery插件有jQuery UI、jQuery Validate、jQuery DataTables、jQuery Slick、jQuery LazyLoad、jQuery Countdown、jQuery Lightbox、jQuery FullCalendar、jQuery Chosen和jQuery EasyUI等。本专题为大家提供jquery插件相关的文章、下载、课程内容,供大家免费下载体验。

156

2023.09.12

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

jquery删除元素的方法
jquery删除元素的方法

jquery可以通过.remove() 方法、 .detach() 方法、.empty() 方法、.unwrap() 方法、.replaceWith() 方法、.html('') 方法和.hide() 方法来删除元素。更多关于jquery相关的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

407

2023.11.10

jQuery hover()方法的使用
jQuery hover()方法的使用

hover()是jQuery中一个常用的方法,它用于绑定两个事件处理函数,这两个函数将在鼠标指针进入和离开匹配的元素时执行。想了解更多hover()的相关内容,可以阅读本专题下面的文章。

516

2023.12.04

jquery实现分页方法
jquery实现分页方法

在jQuery中实现分页可以使用插件或者自定义实现。想了解更多jquery分页的相关内容,可以阅读本专题下面的文章。

312

2023.12.06

jquery中隐藏元素是什么
jquery中隐藏元素是什么

jquery中隐藏元素是非常重要的一个概念,在使用jquery隐藏元素之前,需要先了解css样式中关于元素隐藏的属性,比如display、visibility、opacity等属性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

129

2024.02.23

jquery中什么是高亮显示
jquery中什么是高亮显示

jquery中高亮显示是指对页面搜索关键词时进行高亮显示,其实现办法:1、先获取要高亮显示的行,获取搜索的内容,再遍历整行内容,最后添加高亮颜色;2、使用“jquery highlight”高亮插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2024.02.23

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

51

2026.01.13

c++ 字符处理
c++ 字符处理

本专题整合了c++字符处理教程、字符串处理函数相关内容,阅读专题下面的文章了解更多详细内容。

0

2026.03.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号