Vue / 系统课时
实现字段联动
实现字段联动
字段联动不只是控制显示与隐藏,还必须同步维护数据有效性。本课将实现级联选择和条件字段切换,并在上游条件变化时主动清理已经失效的下游值。
学习目标
- 设计单向、可追踪的字段依赖关系
- 在上游字段变化时清空失效值
- 避免初始化回填与用户交互互相干扰
明确联动规则
先把依赖关系写成规则,再写组件代码。省份决定城市选项;账号类型决定企业名称是否可见;当省份变化时,原城市可能已经无效;当账号类型从企业切换为个人时,企业名称必须从模型中清空。

联动方向应尽量单向:上游字段决定下游字段,而不是两个字段互相监听。双向监听很容易产生重复更新、循环触发和难以复现的边界问题。
用事件处理器集中修改
对于由用户选择触发的联动,优先使用明确的事件处理器,而不是给每个字段都添加 watch。这样编辑回填可以一次性赋值,不会因为监听器先后执行而把合法数据清空。
<script setup lang="ts">
import { computed, reactive } from 'vue'
type AccountType = 'personal' | 'company'
type CityOption = {
label: string
value: string
}
const cityMap: Record<string, CityOption[]> = {
zhejiang: [
{ label: '杭州', value: 'hangzhou' },
{ label: '宁波', value: 'ningbo' }
],
jiangsu: [
{ label: '南京', value: 'nanjing' },
{ label: '苏州', value: 'suzhou' }
]
}
const form = reactive({
province: '',
city: '',
accountType: 'personal' as AccountType,
companyName: ''
})
const cityOptions = computed(() => cityMap[form.province] ?? [])
const showCompanyName = computed(() => form.accountType === 'company')
const handleProvinceChange = (province: string) => {
form.province = province
// 上游变化后,旧城市不再可信,必须立即清空
form.city = ''
}
const handleAccountTypeChange = (type: AccountType) => {
form.accountType = type
// 隐藏字段时同步删除无效业务数据
if (type !== 'company') {
form.companyName = ''
}
}
const submit = () => {
console.log(JSON.stringify(form))
}
</script>
<template>
<form @submit.prevent="submit">
<select
:value="form.province"
@change="handleProvinceChange(($event.target as HTMLSelectElement).value)"
>
<option value="">请选择省份</option>
<option value="zhejiang">浙江</option>
<option value="jiangsu">江苏</option>
</select>
<select v-model="form.city" :disabled="cityOptions.length === 0">
<option value="">请选择城市</option>
<option
v-for="item in cityOptions"
:key="item.value"
:value="item.value"
>
{{ item.label }}
</option>
</select>
<select
:value="form.accountType"
@change="handleAccountTypeChange(($event.target as HTMLSelectElement).value as AccountType)"
>
<option value="personal">个人</option>
<option value="company">企业</option>
</select>
<input
v-if="showCompanyName"
v-model.trim="form.companyName"
placeholder="请输入企业名称"
>
<button type="submit">提交</button>
</form>
</template>预期结果:
选择“浙江 → 杭州”后再把省份改为“江苏”,城市字段立即清空。
选择“企业”并填写企业名称后切换为“个人”,企业名称立即清空。
提交时控制台只输出当前条件下仍然有效的字段值。该组件可直接放入已配置 Vue 3 与 TypeScript 的项目中。页面样式可由现有组件库接管,联动逻辑不依赖特定 UI 框架。
处理编辑回填
编辑场景应通过专用函数一次性写入完整数据,不要逐个调用用户交互处理器。回填完成后再校验一次依赖关系,只有确实不匹配时才清空下游字段。
type UserDetail = {
province?: string
city?: string
accountType?: AccountType
companyName?: string
}
const fillForm = (detail: UserDetail) => {
form.province = detail.province ?? ''
form.city = detail.city ?? ''
form.accountType = detail.accountType ?? 'personal'
form.companyName = detail.companyName ?? ''
const validCities = cityMap[form.province] ?? []
const cityStillValid = validCities.some(item => item.value === form.city)
if (!cityStillValid) {
form.city = ''
}
if (form.accountType !== 'company') {
form.companyName = ''
}
}这是片段示例,依赖前一个代码块中的 form、cityMap 和 AccountType。它保留合法的历史值,同时清除与当前条件不一致的数据。
提交前再做一次兜底
界面隐藏不等于数据消失。提交前应按当前条件构造参数,并再次过滤无效字段。例如个人账号的载荷中不应包含 companyName;城市必须属于当前省份的可选集合。界面联动负责即时反馈,提交映射负责最后一道数据边界。
对于必须填写的条件字段,校验规则也要随条件变化。企业类型下校验企业名称,个人类型下应移除该错误,否则用户会看到一个无法编辑却阻止提交的隐藏字段。
验收联动行为
至少验证四条路径:先选城市再切省份;填写企业名称后切个人;编辑回填合法城市;编辑回填不匹配城市。每条路径都应同时检查页面显示、表单模型和最终提交参数,不能只看界面是否隐藏。