我们知道省市区县都有名称和对应的数字唯一编号,使用编号可以更方便查询以及程序处理,我们今天来了解一下使用vue2来实现常见的省市区下拉联动选择效果。
准备数据源
我们的省市区县的数据源来自本站文章《基于Vue2的简易的省市区县三级联动组件》中的districts.js,感谢v-distpicker作者。districts.js中的数据格式大概是这样的:
export default {
100000: {
110000: '北京市',
120000: '天津市',
130000: '河北省',
140000: '山西省',
...
},
130000: {
130100: '石家庄市',
130200: '唐山市',
130300: '秦皇岛市',
130400: '邯郸市',
...
},
130100: {
130102: '长安区',
130104: '桥西区',
130105: '新华区',
130107: '井陉矿区',
...
},
...
}
知识兔很显然,districts.js导出的是一个key:value形式的json数据串,那么在js中我们就可以很方便的处理json数据串中的关系。
构建项目
我们使用vue-cli构建项目,需要安装node和vue环境。然后命令行运行:vue init webpack distpicker
构建好项目工程。具体如何操作的请参照vue官网,这些基础的本文不细讲。
现在我们直接编辑App.vue文件。
<template>
<div id="app" class="container">
<div class="demo form-inline">
<select name="province" class="form-control" v-model="province.code" @change="getCitys">
<option value="">选择省份</option>
<option v-for="(item, index) in provinceList"
:value="index"
:key="index">
{{ item }}
</option>
</select>
<select name="city" class="form-control" v-show="showcitys" v-model="city.code" @change="getAreas">
<option value="">选择城市</option>
<option v-for="(item, index) in cityList"
:value="index"
:key="index">
{{ item }}
</option>
</select>
<select name="area" class="form-control" v-show="showareas" v-model="area.code" @change="getDistValue">
<option value="">选择区县</option>
<option v-for="(item, index) in areaList"
:value="index"
:key="index">
{{ item }}
</option>
</select>
<button class="btn btn-info" @click="getSelectVal">获取选中值</button>
<div style="margin-top:20px;color:red">{{selected}}</div>
</div>
</div>
</template>
知识兔这是一个简单三个下拉选择器模板,使用v-model
可以设置默认值,@change
当下拉选择选项后触发的事件。然后每个select
下的option
是读取districts.js对应的数据。
JS代码
我们现在来看JS部分,首先使用import导入省市区县数据,注意我们把districts.js文件放在项目的src目录下,然后定义默认编号100000,因为我们第一个(省级)选择框默认要下拉显示所有的省/自治区/直辖市。然后在created()
和methods
部分的代码加上,完整的代码如下:
import DISTRICTS from './districts';
const DEFAULT_CODE = 100000;
export default {
name: 'App',
data() {
return {
showcitys: false,
showareas: false,
selected: '',
defaultProvince: '湖南省',
defaultCity: '长沙市',
defaultArea: '岳麓区',
province: {},
city: {},
area: {},
provinceList: [],
cityList: [],
areaList: []
}
},
created() {
this.provinceList = this.getDistricts();
this.getDefault();
},
methods: {
getDefault() {
if (this.defaultProvince !== '') {
this.showcitys = true;
let provinceCode = this.getAreaCode(this.defaultProvince);
this.cityList = this.getDistricts(provinceCode);
this.province = {
code: provinceCode,
value: this.defaultProvince
}
}
if (this.defaultCity !== '') {
this.showareas = true;
let cityCode = this.getAreaCode(this.defaultCity);
this.areaList = this.getDistricts(cityCode);
this.city = {
code: cityCode,
value: this.defaultCity
}
}
if (this.defaultArea !== '') {
let areaCode = this.getAreaCode(this.defaultArea);
this.area = {
code: areaCode,
value: this.defaultArea
}
}
},
getSelectVal() {
this.selected = this.province.value + this.city.value + this.area.value;
console.log(this.province.code + '-'+ this.city.code + '-' + this.area.code);
},
//名称转代码
nameToCode(name) {
for(let x in DISTRICTS) {
for(let y in DISTRICTS[x]) {
if(name === DISTRICTS[x][y]) {
return y
}
}
}
},
//获取区域代码
getAreaCode(value) {
if(typeof value === 'string') {
return this.nameToCode(value);
}
return value;
},
getCodeValue(code, level=1) {
if (level == 1) { //省级
return DISTRICTS[DEFAULT_CODE][code];
} else if (level == 2) {
let provinceCode = this.province.code;
return DISTRICTS[provinceCode][code];
} else { //
let cityCode = this.city.code;
return DISTRICTS[cityCode][code];
}
},
getDistricts(code = DEFAULT_CODE) {
return DISTRICTS[code] || []
},
cleanList(name) {
this[name] = []
},
getCitys(e) {
this.cityList = this.getDistricts(e.target.value);
this.cleanList('areas')
this.province = this.setData(e.target.value, 1);
this.areaList = [];
this.showareas = false;
this.showcitys = true;
},
getAreas (e) {
this.areaList = this.getDistricts(e.target.value);
this.city = this.setData(e.target.value, 2);
this.showareas = true;
},
getDistValue (e) {
this.area = this.setData(e.target.value, 3);
},
setData(code, level = 1) {
code = parseInt(code);
return {
code: code,
value: this.getCodeValue(code, level),
}
},
}
}
知识兔运行
我们需要实现的效果是:默认显示省级下拉选择框,下拉选项中应该默认载入省级名称,然后当选择省级下拉框中的省份列表(省级)选项时,显示选中省份的城市列表(市级),然后选择市级城市选项,显示选择城市的区县列表(县级)。在选择完每个选项时,我们应该即时记录选项对应的编号和名称。如果在data()
部分设置了省市区县的默认值,则三个下拉框都要显示。
运行npm run dev
,在浏览器中输入http://localhost:8080查看效果。
效果是实现了,但是如果要在一个页面调用多个三级联动效果则就比较尴尬了,下节我给大家讲述如何把这个三级联动效果封装成vue组件,造好轮子,方便在更多地方调用,敬请关注。