textarea 必须有 name 属性才能被 form.val() 读取，且 name 不能含特殊字符、不可重复；动态添加需调用 layui.form.render('textarea')；取值应统一使用 form.val('filtername') 而非原生 dom 操作。

textarea 必须有 name 属性才能被 form.val() 读取

Layui 的 form.val() 不识别没有 name 的 textarea，哪怕它在 layui-form 容器里也不行。这是最常被忽略的硬性前提。

• 检查你的 textarea 标签是否写了 name，比如 <textarea name="content"></textarea>
• 如果用了 lay-ignore，form.val() 会跳过该元素，即使有 name 也无效
• name 值不能含点号（.）、中括号（[]）等特殊字符，否则 form.val() 解析失败，返回 undefined
• 多个 textarea 不能共用同一个 name —— Layui 不支持同名多文本域，只会取最后一个的值

用 form.val('filterName') 取值，不是直接读 value

别用 document.querySelector('textarea[name="content"]').value，Layui 表单渲染后可能已替换 DOM 结构，原生读取容易拿到空值或旧值。正确方式是依赖 form.val() 接口。

深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

• 确保 form 元素设置了 lay-filter="contentForm"
• 调用 layui.form.val('contentForm')，返回对象如 { content: "用户输入的文字" }
• 如果返回对象里没有 content 键，先确认 name 拼写是否和 val() 的参数一致，再检查是否漏了 name 或被 lay-ignore
• 提交回调里的 data.field 是等价于 form.val() 的快捷访问，但只在 submit 事件中可用

换行符丢失？那是 textarea 值本身没被正确采集

提交后发现换行变成空格或消失，问题不在后端解析，而是在前端就没拿到带换行的原始字符串 —— 这往往是因为 form.val() 没生效，导致你误用了其他取值方式。

• 手动用 querySelector 读 value 时，若 textarea 被 Layui 包裹进 layui-form-text 容器，原生 DOM 可能已被移除或隐藏，读到的是空字符串
• form.val() 返回的值天然保留换行符（\n），无需额外处理
• 如果用了 layer.open 弹窗里的表单，确保弹窗 DOM 已插入 document 且 form.render() 已执行（动态添加的表单需手动渲染）

动态插入的 textarea 怎么让 form.val() 识别

JS 动态追加的 textarea，即使写了 name，form.val() 默认也读不到 —— Layui 初始化时没扫描到它。

• 插入后必须显式调用 layui.form.render('textarea')，通知模块重新绑定
• 不要只调 form.render()（无参），它不保证扫描新增的 textarea；明确传入 'textarea' 类型更稳妥
• 如果同时新增了 input、select 等，可调 form.render('all')，但性能略低
• 渲染后，再调 form.val() 才能拿到新字段的值

实际取值逻辑很简单：name 写对、form.filter 对应、动态内容 render 到位，剩下的就是 form.val('xxx').yourName 直接拿。最容易卡住的地方，永远是第一个 name 属性漏写了。