工具方法与表单数据操作文档#
4.5 窗口尺寸监听#
在 src/utils/use-body-resize.js 中封装了监听主体区尺寸改变的方法，使用方式如下：侧栏的展开折叠、浏览器窗口尺寸改变（window.onresize）等场景都 会触发该方法，适用于更新 echarts 尺寸等需求。若仅需监听移动端小屏幕与 PC 尺寸的切换，可使用 src/utils/use-mobile.js 中封装的方法（v1.1.0 新增），使用示例：补充示例：el-descriptions 组件列数响应式设置（该组件不支持 md、sm 等响应式属性，可通过此方法实现）4.6 常用工具方法#
4.6.1 src/utils/common.js 工具方法（v1.1.4 新增）#
v1.1.8 新增：toURLSearch 和 toFormData 支持数组、对象格式参数：4.6.2 ele-admin-plus 组件库工具方法#
4.7 格式校验方法#
ele-admin-plus 提供常用格式校验方法及正则表达式，适用于表单验证等场景。4.7.1 常用校验方法/正则#
4.7.2 结合表单验证使用#
useFormData 是专为 Vue 3 开发的自定义 Hook，用于简化表单数据状态管理，支持初始化、重置、批量赋值、单字段赋值（含嵌套）等功能。引入方式#
API 说明#
| 参数名 | 类型 | 是否必填 | 说明 |
|---|
| initValue | object | 否 | 表单初始值对象，默认值为 {} |
返回值#
返回值支持数组解构和对象解构，数组解构更便于在同一组件中使用多个表单实例：| 索引 | 属性名 | 类型 | 说明 |
|---|
| 0 | form | reactive | 响应式表单对象 |
| 1 | resetFields | function | 表单重置方法 |
| 2 | assignFields | function | 表单批量赋值方法 |
| 3 | setFieldValue | function | 单字段赋值方法（支持嵌套路径） |
基础用法#
方法详解#
1. resetFields：表单重置#
将表单数据恢复到初始状态，支持全量重置、指定字段重置、排除字段重置：2. assignFields：批量赋值#
快速同步外部数据到表单，支持受限赋值、排除赋值、覆盖式赋值：3. setFieldValue：单字段赋值#
精准修改单个字段值，支持深层嵌套路径（如 a.b.c、a[0].b），不受初始字段约束：进阶技巧#
1. 兼容旧版对象解构#
2. 同一组件多表单实例#
数组解构支持自定义命名，便于同时管理多个表单（如查询表单、编辑表单）：修改于 2025-12-20 03:37:01
