Vue / 系统课时
设计复杂表单模型
设计复杂表单模型
复杂表单最容易失控的地方,不是字段数量,而是把业务数据、界面状态和提交参数混在同一个对象里。本课将建立分层模型,让初始化、编辑回填、校验与提交都围绕清晰的数据边界展开。
学习目标
- 区分领域数据、表单数据与视图状态
- 用工厂函数生成稳定、可复用的初始值
- 在提交前构造干净且符合接口约定的载荷
先划分三类状态
复杂表单通常同时包含三类信息。领域字段是后端真正需要保存的数据,例如名称、部门、联系方式;表单辅助字段用于输入过程,例如日期范围、临时标签;视图状态只服务页面交互,例如当前步骤、展开面板、上传进度和按钮加载状态。
不要把这些内容全部塞进 form。否则提交时需要不断删除临时字段,编辑回填时也容易把加载状态、文件列表等界面信息带入接口。

用类型和工厂函数定义模型
下面的示例把可提交字段与界面状态分开,并用函数生成全新的初始对象。工厂函数比直接复用常量安全,因为数组和嵌套对象不会在多次打开弹窗时共享引用。
import { reactive, toRaw } from 'vue'
type Contact = {
email: string
phone: string
}
type UserForm = {
name: string
departmentId: number | null
roles: string[]
contact: Contact
enabled: boolean
}
type FormViewState = {
activeStep: number
submitting: boolean
expandedSections: string[]
}
const createInitialForm = (): UserForm => ({
name: '',
departmentId: null,
roles: [],
contact: {
email: '',
phone: ''
},
enabled: true
})
const form = reactive<UserForm>(createInitialForm())
const viewState = reactive<FormViewState>({
activeStep: 0,
submitting: false,
expandedSections: ['basic']
})
form.name = 'Alice'
form.departmentId = 12
form.roles.push('editor')
form.contact.email = 'alice@example.com'
const buildPayload = () => {
const raw = toRaw(form)
return {
name: raw.name.trim(),
departmentId: raw.departmentId,
roleCodes: [...raw.roles],
contact: { ...raw.contact },
enabled: raw.enabled
}
}
console.log(JSON.stringify(buildPayload(), null, 2))预期输出:
{
"name": "Alice",
"departmentId": 12,
"roleCodes": [
"editor"
],
"contact": {
"email": "alice@example.com",
"phone": ""
},
"enabled": true
}buildPayload 是明确的转换边界。即使页面以后增加 activeStep、上传列表或校验提示,也不会污染接口参数。
统一处理新建与编辑初始化
新建时直接使用工厂函数。编辑时不要把接口对象整体赋给表单,而应显式映射字段,并为缺失值提供默认值。这样可以抵抗后端字段新增、旧数据为空和字段命名不一致。
type UserDetail = Partial<UserForm> & {
roleCodes?: string[]
}
const fillForm = (detail?: UserDetail) => {
const initial = createInitialForm()
const source = detail ?? {}
Object.assign(form, {
...initial,
name: source.name ?? initial.name,
departmentId: source.departmentId ?? initial.departmentId,
roles: [...(source.roleCodes ?? source.roles ?? initial.roles)],
contact: {
...initial.contact,
...(source.contact ?? {})
},
enabled: source.enabled ?? initial.enabled
})
Object.assign(viewState, {
activeStep: 0,
submitting: false,
expandedSections: ['basic']
})
}这是片段示例,依赖前一个代码块中的类型、form、viewState 和 createInitialForm。执行 fillForm() 会恢复新建状态;执行 fillForm(detail) 会完成编辑回填,同时重置页面交互状态。
按字段分组组织组件
字段分组应反映业务含义,而不是单纯按页面位置切割。常见分组可以是基础信息、权限配置、联系信息和高级设置。父组件持有完整表单模型,子组件通过 v-model 或明确的字段事件修改所属分组,避免每个子组件维护一份重复副本。
当某个分组需要独立校验时,可以暴露 validate() 方法,但最终提交仍由父组件统一触发。这样既能拆分界面,也不会失去单一数据源。
验收模型设计
完成后检查三个结果:关闭并重新打开表单时数组和嵌套对象已恢复;编辑回填不会把未知字段带入页面;提交参数中不存在步骤、加载状态、上传进度等视图字段。只要这三点成立,模型就具备继续扩展的基础。