讲师中心 微信公众号
AI工具推荐 视频效率加速

Vue 自定义表单组件怎么实现省市区级联选择表单控件

星伟姑娘_5616

星伟姑娘_5616

发布时间:2026-11-01 09:59:29

|

529人浏览过

|

来源于php中文网

原创

Vue省市区三级联动组件通过数据驱动实现:省级变化重置市、区,市级变化重置区;封装为支持v-model双向绑定的自定义组件,依赖预处理的层级映射数据源,用watch响应式更新选项并emit完整选中对象。

vue 自定义表单组件怎么实现省市区级联选择表单控件

Vue 中实现省市区三级联动表单组件,核心是数据驱动 + 依赖更新:省级变化时重置市、区选项,市级变化时重置区选项,所有选项都从统一地区数据源(如 JSON)中筛选。推荐封装为可复用的自定义组件,支持 v-model 双向绑定和外部传入初始值。

1. 准备地区数据源

使用标准的中国省市区 JSON 数据(如 china-division 或 area-data npm 包),结构类似:

  • 每个省有 code(如 110000)、name(如 "北京市")
  • 每个市属于某省,code 前四位与省 code 一致(如 110100)
  • 每个区属于某市,code 前六位与市 code 一致(如 110101)

建议将数据按层级预处理成对象映射,提升查找效率:

// 示例:{ '110000': [...], '110100': [...] }
const citiesMap = {};
const areasMap = {};

2. 创建自定义组件(支持 v-model)

组件接收 modelValue(v-model 绑定值),触发 update:modelValue 事件同步选中值。内部维护三个 select 的 value:

立即学习“前端免费学习笔记(深入)”;

蓝湖代码转vue2.0+element-ui
蓝湖代码转vue2.0+element-ui

将静态 Vue 页面(index.vue)改造为动态页面(Custom.vue);稿源仅限 index.vue、其引用的 CSS 与资源路径,禁止参考仓库内其他文件。Invoke when user wants to transform a static Vue page into a dynamic data-driven page with Element UI components.

下载
  • provinceCode:当前选中的省编码
  • cityCode:当前选中的市编码(依赖 provinceCode)
  • areaCode:当前选中的区编码(依赖 cityCode)

关键逻辑用 watch 实现响应式联动:

watch(() => props.modelValue, (val) => {
  if (val && typeof val === 'object') {
    provinceCode.value = val.province || '';
    cityCode.value = val.city || '';
    areaCode.value = val.area || '';
  }
}, { immediate: true });

watch(provinceCode, (newP) => {
  cityCode.value = '';
  areaCode.value = '';
  if (newP) {
    cityOptions.value = citiesMap[newP] || [];
  } else {
    cityOptions.value = [];
    areaOptions.value = [];
  }
});

watch(cityCode, (newC) => {
  areaCode.value = '';
  if (newC) {
    areaOptions.value = areasMap[newC] || [];
  } else {
    areaOptions.value = [];
  }
});

3. 模板结构与双向绑定

使用三个 <select></select> 元素,分别绑定 provinceCode / cityCode / areaCode,并监听 change 事件更新对应值。最终通过 emit('update:modelValue', {...}) 向外同步完整对象:

<select v-model="provinceCode" @change="onProvinceChange">
  <option value="">请选择省份</option>
  <option v-for="p in provinceOptions" :key="p.code" :value="p.code">{{ p.name }}</option>
</select>

<select v-model="cityCode" :disabled="!provinceCode" @change="onCityChange">
  <option value="">请选择城市</option>
  <option v-for="c in cityOptions" :key="c.code" :value="c.code">{{ c.name }}</option>
</select>

<select v-model="areaCode" :disabled="!cityCode">
  <option value="">请选择区县</option>
  <option v-for="a in areaOptions" :key="a.code" :value="a.code">{{ a.name }}</option>
</select>

每次任一值变更,都 emit 完整结构:

function syncValue() {
  emit('update:modelValue', {
    province: provinceCode.value,
    city: cityCode.value,
    area: areaCode.value
  });
}

4. 使用方式(简洁清晰)

父组件直接用 v-model 绑定一个对象即可,支持初始化、重置、校验等:

<AreaSelect v-model="form.area" />

// data
form: {
  area: {
    province: '310000', // 上海市
    city: '310100',     // 上海市(直辖市)
    area: '310115'      // 浦东新区
  }
}

如需支持「仅省+市」或「允许不选区」,可在组件内加 prop 控制是否渲染第三个 select,或让 areaCode 可为空。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2763

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

6023

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6950

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6738

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

963

2024.05.22

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

1734

2023.07.17

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

12382

2024.02.23

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

336

2026.02.10

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

100

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 17.3万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn