Vue / 系统课时

动态表单与联动字段

动态表单与联动字段

动态表单真正难的不是“显示哪个输入框”,而是让字段可见性、级联值、禁用状态和提交数据始终一致。本节用 Vue 3 + TypeScript 实现客户类型与地区联动,重点处理隐藏字段残值和父级变化后的子级重置。

学习目标

  • 用类型化状态表达动态字段的可见、禁用和级联关系。
  • 在业务条件变化时清理失效值,避免提交脏数据。
  • 把联动规则集中到计算属性与监听逻辑,而不是散落在模板事件中。

先把联动关系建成状态规则

动态表单通常同时包含三类规则:字段是否存在、字段能否编辑、字段值是否仍然有效。比如客户类型为“企业”时才显示公司名称;省份未选择时城市必须禁用;省份变化后原城市值必须清空。

动态表单字段联动关系

关键原则是:隐藏字段不等于无效字段自动消失。只用 v-if 移除控件时,响应式对象里的旧值仍然存在,因此业务条件改变时要同时修正数据状态。

实现可见性、级联和禁用

下面是一个可直接放进 Vue 3 项目的单文件组件。模板负责渲染,计算属性决定是否显示企业字段,watch 负责清理因条件变化而失效的数据。

vue
<script setup lang="ts">
import { computed, ref, watch } from 'vue'

type CustomerType = 'person' | 'company'
type Province = '' | 'beijing' | 'guangdong'

interface FormModel {
  customerType: CustomerType
  companyName: string
  province: Province
  city: string
}

const cityOptions: Record<Exclude<Province, ''>, string[]> = {
  beijing: ['北京'],
  guangdong: ['广州', '深圳'],
}

const form = ref<FormModel>({
  customerType: 'person',
  companyName: '',
  province: '',
  city: '',
})

const showCompanyName = computed(
  () => form.value.customerType === 'company',
)

const cities = computed(() => {
  const province = form.value.province
  return province ? cityOptions[province] : []
})

watch(
  () => form.value.customerType,
  (type) => {
    // 隐藏企业字段时同步清空旧值,避免脏数据进入提交参数。
    if (type === 'person') form.value.companyName = ''
  },
)

watch(
  () => form.value.province,
  () => {
    // 父级选项改变后,原城市不再可信,必须重新选择。
    form.value.city = ''
  },
)

function submit() {
  const payload = {
    customerType: form.value.customerType,
    province: form.value.province,
    city: form.value.city,
    ...(showCompanyName.value
      ? { companyName: form.value.companyName.trim() }
      : {}),
  }

  console.log(payload)
}
</script>

<template>
  <form @submit.prevent="submit">
    <label>
      客户类型
      <select v-model="form.customerType">
        <option value="person">个人</option>
        <option value="company">企业</option>
      </select>
    </label>

    <label v-if="showCompanyName">
      公司名称
      <input v-model.trim="form.companyName" />
    </label>

    <label>
      省份
      <select v-model="form.province">
        <option value="">请选择</option>
        <option value="beijing">北京</option>
        <option value="guangdong">广东</option>
      </select>
    </label>

    <label>
      城市
      <select v-model="form.city" :disabled="!form.province">
        <option value="">请选择</option>
        <option v-for="city in cities" :key="city" :value="city">
          {{ city }}
        </option>
      </select>
    </label>

    <button type="submit">提交</button>
  </form>
</template>

预期结果

text
初始状态:公司名称隐藏,城市下拉框禁用。
选择“企业”:公司名称出现。
选择“广东”:城市可选“广州”或“深圳”。
将省份从“广东”改为“北京”:原城市值被清空,只能重新选择“北京”。
从“企业”切回“个人”:companyName 被清空,提交参数中不再包含该字段。

实际页面样式取决于项目 CSS,但字段显隐、禁用和清理行为应与上述结果一致。

处理异步级联时防止旧请求覆盖新状态

真实项目里的城市、组织或商品分类往往来自接口。此时父级字段连续变化会产生并发请求,较慢的旧请求可能最后返回并覆盖新选项。常见做法是为每次请求绑定 AbortController,父级再次变化时取消上一请求;也可以保存请求序号,只接收最后一次结果。

无论采用哪种方式,都应先清空子级值,再进入加载状态,最后根据当前父级值落选项。这样“界面上看起来可选”和“模型里实际可提交”不会发生时间差。

把校验和提交边界对齐

动态字段的校验条件必须与显示条件一致。公司名称只在 showCompanyName 为真时参与必填校验;城市只有在已经选择省份且业务要求必须选择时才校验。不要让被隐藏或禁用的字段继续阻塞提交。

提交前再做一次数据归一化同样重要:只组装当前业务分支需要的字段,不把整个 form 原样发送给后端。动态表单的稳定性来自同一条约束:条件变化时,UI 状态、模型状态、校验状态和提交参数必须一起变化。

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

目录与阅读设置

阅读设置

17

记录一个想法

动态表单与联动字段

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

登录哪都通