Vue / 系统课时

实现字段联动

实现字段联动

字段联动不只是控制显示与隐藏,还必须同步维护数据有效性。本课将实现级联选择和条件字段切换,并在上游条件变化时主动清理已经失效的下游值。

学习目标

  • 设计单向、可追踪的字段依赖关系
  • 在上游字段变化时清空失效值
  • 避免初始化回填与用户交互互相干扰

明确联动规则

先把依赖关系写成规则,再写组件代码。省份决定城市选项;账号类型决定企业名称是否可见;当省份变化时,原城市可能已经无效;当账号类型从企业切换为个人时,企业名称必须从模型中清空。

字段联动与清理流程

联动方向应尽量单向:上游字段决定下游字段,而不是两个字段互相监听。双向监听很容易产生重复更新、循环触发和难以复现的边界问题。

用事件处理器集中修改

对于由用户选择触发的联动,优先使用明确的事件处理器,而不是给每个字段都添加 watch。这样编辑回填可以一次性赋值,不会因为监听器先后执行而把合法数据清空。

vue
<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>

预期结果:

text
选择“浙江 → 杭州”后再把省份改为“江苏”,城市字段立即清空。
选择“企业”并填写企业名称后切换为“个人”,企业名称立即清空。
提交时控制台只输出当前条件下仍然有效的字段值。

该组件可直接放入已配置 Vue 3 与 TypeScript 的项目中。页面样式可由现有组件库接管,联动逻辑不依赖特定 UI 框架。

处理编辑回填

编辑场景应通过专用函数一次性写入完整数据,不要逐个调用用户交互处理器。回填完成后再校验一次依赖关系,只有确实不匹配时才清空下游字段。

ts
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;城市必须属于当前省份的可选集合。界面联动负责即时反馈,提交映射负责最后一道数据边界。

对于必须填写的条件字段,校验规则也要随条件变化。企业类型下校验企业名称,个人类型下应移除该错误,否则用户会看到一个无法编辑却阻止提交的隐藏字段。

验收联动行为

至少验证四条路径:先选城市再切省份;填写企业名称后切个人;编辑回填合法城市;编辑回填不匹配城市。每条路径都应同时检查页面显示、表单模型和最终提交参数,不能只看界面是否隐藏。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现字段联动

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

登录哪都通