Vue / 系统课时
动态表单与联动字段
动态表单与联动字段
动态表单真正难的不是“显示哪个输入框”,而是让字段可见性、级联值、禁用状态和提交数据始终一致。本节用 Vue 3 + TypeScript 实现客户类型与地区联动,重点处理隐藏字段残值和父级变化后的子级重置。
学习目标
- 用类型化状态表达动态字段的可见、禁用和级联关系。
- 在业务条件变化时清理失效值,避免提交脏数据。
- 把联动规则集中到计算属性与监听逻辑,而不是散落在模板事件中。
先把联动关系建成状态规则
动态表单通常同时包含三类规则:字段是否存在、字段能否编辑、字段值是否仍然有效。比如客户类型为“企业”时才显示公司名称;省份未选择时城市必须禁用;省份变化后原城市值必须清空。

关键原则是:隐藏字段不等于无效字段自动消失。只用 v-if 移除控件时,响应式对象里的旧值仍然存在,因此业务条件改变时要同时修正数据状态。
实现可见性、级联和禁用
下面是一个可直接放进 Vue 3 项目的单文件组件。模板负责渲染,计算属性决定是否显示企业字段,watch 负责清理因条件变化而失效的数据。
<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>预期结果
初始状态:公司名称隐藏,城市下拉框禁用。
选择“企业”:公司名称出现。
选择“广东”:城市可选“广州”或“深圳”。
将省份从“广东”改为“北京”:原城市值被清空,只能重新选择“北京”。
从“企业”切回“个人”:companyName 被清空,提交参数中不再包含该字段。实际页面样式取决于项目 CSS,但字段显隐、禁用和清理行为应与上述结果一致。
处理异步级联时防止旧请求覆盖新状态
真实项目里的城市、组织或商品分类往往来自接口。此时父级字段连续变化会产生并发请求,较慢的旧请求可能最后返回并覆盖新选项。常见做法是为每次请求绑定 AbortController,父级再次变化时取消上一请求;也可以保存请求序号,只接收最后一次结果。
无论采用哪种方式,都应先清空子级值,再进入加载状态,最后根据当前父级值落选项。这样“界面上看起来可选”和“模型里实际可提交”不会发生时间差。
把校验和提交边界对齐
动态字段的校验条件必须与显示条件一致。公司名称只在 showCompanyName 为真时参与必填校验;城市只有在已经选择省份且业务要求必须选择时才校验。不要让被隐藏或禁用的字段继续阻塞提交。
提交前再做一次数据归一化同样重要:只组装当前业务分支需要的字段,不把整个 form 原样发送给后端。动态表单的稳定性来自同一条约束:条件变化时,UI 状态、模型状态、校验状态和提交参数必须一起变化。