Vue / 系统课时

设计复杂表单模型

设计复杂表单模型

复杂表单最容易失控的地方,不是字段数量,而是把业务数据、界面状态和提交参数混在同一个对象里。本课将建立分层模型,让初始化、编辑回填、校验与提交都围绕清晰的数据边界展开。

学习目标

  • 区分领域数据、表单数据与视图状态
  • 用工厂函数生成稳定、可复用的初始值
  • 在提交前构造干净且符合接口约定的载荷

先划分三类状态

复杂表单通常同时包含三类信息。领域字段是后端真正需要保存的数据,例如名称、部门、联系方式;表单辅助字段用于输入过程,例如日期范围、临时标签;视图状态只服务页面交互,例如当前步骤、展开面板、上传进度和按钮加载状态。

不要把这些内容全部塞进 form。否则提交时需要不断删除临时字段,编辑回填时也容易把加载状态、文件列表等界面信息带入接口。

复杂表单三层模型

用类型和工厂函数定义模型

下面的示例把可提交字段与界面状态分开,并用函数生成全新的初始对象。工厂函数比直接复用常量安全,因为数组和嵌套对象不会在多次打开弹窗时共享引用。

ts
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))

预期输出:

json
{
  "name": "Alice",
  "departmentId": 12,
  "roleCodes": [
    "editor"
  ],
  "contact": {
    "email": "alice@example.com",
    "phone": ""
  },
  "enabled": true
}

buildPayload 是明确的转换边界。即使页面以后增加 activeStep、上传列表或校验提示,也不会污染接口参数。

统一处理新建与编辑初始化

新建时直接使用工厂函数。编辑时不要把接口对象整体赋给表单,而应显式映射字段,并为缺失值提供默认值。这样可以抵抗后端字段新增、旧数据为空和字段命名不一致。

ts
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() 方法,但最终提交仍由父组件统一触发。这样既能拆分界面,也不会失去单一数据源。

验收模型设计

完成后检查三个结果:关闭并重新打开表单时数组和嵌套对象已恢复;编辑回填不会把未知字段带入页面;提交参数中不存在步骤、加载状态、上传进度等视图字段。只要这三点成立,模型就具备继续扩展的基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计复杂表单模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通