Vue + ElementUI 实现全国各个省份相对应城市的联动选择
此文章是本人在前端开发工作中遇到的问题,然后对解决问题的方案进行一次做笔记记录下来。需求
一、需求
做的是一个后台管理系统,这次的项目需求其中一小个是,
对商家门店信息进行添加或者修改编辑时,能选择所在地,包括省份和城市(没有涉及到区县),然后要选择了省份才能选择城市,省份没有选择时不展示城市的选择框,
且选择城市的列表是根据省份来展示相对应的,当更改省份选择时,清空之前选择的城市能进行重新选择城市。
二、效果图
三、具体实现
首先,需要做一些前提准备,在 Vue 项目中通过 npm 安装 ElementUI 组件和 vue-resource 库(实现异步加载时需要使用到的库)
npm i element-ui -S
npm install vue-resource --save-dev
在 main.js 文件中引入
/* 引入 Vue 框架 */
import Vue from 'vue'
/* 引入 ElementUI 组件 */
import ElementUI from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css'
import App from './App.vue'
/* 引入资源请求插件 */
import VueResource from 'vue-resource'
Vue.use(ElementUI)
/* 使用VueResource插件 */
Vue.use(VueResource)
接下来,在 Vue 组件化页面进行开发,使用 ElementUI 组件的 Select 选择器(可清空单选),
这里使用 el-dialog 对话框包含 el-form 表单的结构写法(这不是本次问题的重点,同时省略去掉与此次问题无关的其他表单项),
具体用法参考使用文档:Element - The world's most popular Vue UI framework
<el-dialog
:title="isEdit?'编辑商家门店信息':'添加商家门店信息'"
:visible.sync="modal1"
width="50%">
<el-form :model="merchant"
ref="merchant"
:rules="rules"
label-width="150px">
<el-form-item label="所属省市:" prop="province">
<el-select v-model="merchant.province" placeholder="请选择省份(直辖市)" @change="renderCity" clearable>
<el-option
v-for="item in provinceListAll"
:key="item.name"
:value="item.name">
</el-option>
</el-select>
<el-select v-model="merchant.city" placeholder="请选择城市" v-if="citySelectAble" clearable>
<el-option
v-for="item in cityListAll"
:key="item.name"
:value="item.name">
</el-option>
</el-select>
</el-form-item>
</el-form>
<span slot="footer">
<el-button @click="modal1 = false">取 消</el-button>
<el-button type="primary" @click="handleDialogConfirm('merchant')">确 定</el-button>
</span>
</el-dialog>
定义相对应的数据字段 defaultMerchant (这里同理,与此次问题无关的字段不写入),同时初始化 Vue 实例的数据对象
<script>
const defaultMerchant = {
id: null,
storeName: '', // 门店名称
province: '', // 所属省(直辖市)
city: '', // 所属市
};
export default {
data(){
return{
merchant: Object.assign({}, defaultMerchant),
modal1: false,
isEdit: false,
rules:{ // 用于表单验证的规则
storeName:[{ required: true, message: '请输入商家的门店名称', trigger: 'blur' }],
province:[{ required: true, message: '请输入所属省份(或者直辖市)', trigger: 'blur' }],
},
provinceListAll: [], // 全国34个省份(包括直辖市)列表
cityListAll: [], // 全国各个城市列表
citySelectAble: false, // 城市是否可选
}
},
watch: {},
created() {},
methods: {}
}
</script>
然后要做一个省份列表和城市列表,我看很多小伙伴是把这部分相关数据以 JSON 形式写在页面里或者存在数据库里,这样个人感觉有两点不足吧?一是数据量很大,占用文件很多行数,降低性能和代码的可读性。二是数据不能进行实时更新(假如哪天新多出个城市或者城市改名什么的要去更改内容也麻烦)。这里我的做法是直接调用高德地图的 API 获取省份和城市列表,开发文档可以参考:概述-Web服务 API | 高德地图API
或者参考我的另一篇文章的类似实例 —— vue-resource 的入门学习笔记:vue-resource 的入门学习笔记_无解的菜鸟晖 的博客-CSDN博客
当然开放的平台也有不足,就是需要发送请求,这个每个开发者的 Key 每天有限制请求次数,具体限制查看:流量限制说明-实用工具-开发指南-Web服务 API | 高德地图API
但是,这样请求到的数据比较实时、全面、准确,相比上面的做法会好很多,我们要做的就是减少对 API 的请求,所以可以用数组过滤器来减少请求(提升性能的同时又保证数据的准确性)
methods: {
getAllProvinceAndCityList() { // 获取全国所有省份和城市的列表
var that = this;
this.$http.get('https://restapi.amap.com/v3/config/district',{ // 高德地图的API
params:{
key: this.mapApiKey, // 这个是申请的 Key,读者自行写入
keywords: '中国',
subdistrict: 3,
extensions: 'base'
}
}).then((response) => {
that.provinceListAll = response.data.districts[0].districts;
for (let i = 0; i < response.data.districts[0].districts.length; i++) {
for (let j = 0; j < response.data.districts[0].districts[i].districts.length; j++) {
that.cityListAll.push(response.data.districts[0].districts[i].districts[j]);
}
}
console.log('省份',that.provinceListAll);
console.log('城市',that.cityListAll);
});
},
renderCity() { // 根据选择的省份,展示该省份相对应的城市列表,未选择省份时,不能选择城市
if(this.merchant.province.length > 0) {
this.cityListAll = this.provinceListAll.filter(item => item.name == this.merchant.province)[0].districts;
this.citySelectAble = true;
} else if(!this.merchant.province) {
this.citySelectAble = false;
this.merchant.city = ''; // 清空省份选择时,清空之前选择的城市能进行重新选择城市
}
},
}
这里建议用 console.log() 在控制台输出检查下获取的数据是否正确,然后选择省份组件的值改变时触发 renderCity 函数。当有省份的值时,城市列表用 filter 过滤器选取该省份对应的城市列表,且让城市选择框出现,否则城市选择框不出现。
在页面加载时就要调用请求高德地图 API 的函数,写在 created() 里。同时 watch 监听省份选择,当城市选择后,再次换省份时,能清空已选择的城市。
watch: { // watch 监听 merchant.province,当城市选择后,再次换省份时,能清空已选择的城市
'merchant.province': function (newValue, oldValue) {
this.merchant.city = '';
}
},
created() { // 页面加载时调用的函数
this.getAllProvinceAndCityList();
},
最后,在每次编辑和添加表单数据时,触发的函数都得调用 renderCity 函数来进行判断,这些函数写在 methods: {} 里:
handleAdd() { // 添加
this.modal1 = true;
this.isEdit = false;
this.merchant = Object.assign({}, defaultMerchant);
this.renderCity();
},
handleUpdate(index, row) { // 编辑
this.modal1 = true;
this.isEdit = true;
this.merchant = Object.assign({},row);
this.renderCity();
},
这是我本人在工作学习中遇到的问题,并对解决问题的方案进行了一次记录,跟小伙伴们分享出来哈 ~ 供参考学习,有什么建议也欢迎评论留言,转载请注明出处哈,感谢支持!
更多推荐
所有评论(0)