当前位置：首页 > VUE

Vue实现地址级联

2026-01-20 22:41:10VUE

Vue实现地址级联的方法

地址级联通常指省、市、区三级联动选择，以下是几种常见的实现方式：

使用Element UI的Cascader组件

安装Element UI后，直接使用el-cascader组件实现级联选择：

<template>
  <el-cascader
    v-model="selectedOptions"
    :options="options"
    @change="handleChange">
  </el-cascader>
</template>

<script>
export default {
  data() {
    return {
      selectedOptions: [],
      options: [{
        value: 'zhejiang',
        label: '浙江省',
        children: [{
          value: 'hangzhou',
          label: '杭州市',
          children: [{
            value: 'xihu',
            label: '西湖区'
          }]
        }]
      }]
    }
  },
  methods: {
    handleChange(value) {
      console.log(value)
    }
  }
}
</script>

自定义递归组件实现

创建递归组件AddressCascader.vue：

<template>
  <div>
    <select v-model="selectedProvince" @change="loadCities">
      <option v-for="province in provinces" :value="province.id">{{ province.name }}</option>
    </select>

    <select v-model="selectedCity" @change="loadDistricts" v-if="cities.length">
      <option v-for="city in cities" :value="city.id">{{ city.name }}</option>
    </select>

    <select v-model="selectedDistrict" v-if="districts.length">
      <option v-for="district in districts" :value="district.id">{{ district.name }}</option>
    </select>
  </div>
</template>

<script>
export default {
  props: ['provinces'],
  data() {
    return {
      selectedProvince: '',
      selectedCity: '',
      selectedDistrict: '',
      cities: [],
      districts: []
    }
  },
  methods: {
    loadCities() {
      // 根据省份ID获取城市数据
      this.cities = [...]
      this.selectedCity = ''
      this.districts = []
    },
    loadDistricts() {
      // 根据城市ID获取区县数据
      this.districts = [...]
      this.selectedDistrict = ''
    }
  }
}
</script>

使用第三方地址数据

安装china-area-data等地区数据包：

npm install china-area-data

在组件中使用：

import { province, city, district } from 'china-area-data'

export default {
  data() {
    return {
      provinces: province,
      cities: [],
      districts: [],
      selectedProvince: '',
      selectedCity: '',
      selectedDistrict: ''
    }
  },
  methods: {
    handleProvinceChange(val) {
      this.cities = city[val]
      this.selectedCity = ''
      this.districts = []
    },
    handleCityChange(val) {
      this.districts = district[val]
      this.selectedDistrict = ''
    }
  }
}

使用Vuex管理状态

对于大型应用，建议使用Vuex管理地址数据：

Vue实现地址级联

// store/modules/address.js
const state = {
  provinces: [],
  cities: [],
  districts: []
}

const mutations = {
  SET_PROVINCES(state, data) {
    state.provinces = data
  },
  SET_CITIES(state, data) {
    state.cities = data
  },
  SET_DISTRICTS(state, data) {
    state.districts = data
  }
}

const actions = {
  async fetchProvinces({ commit }) {
    const res = await getProvinces()
    commit('SET_PROVINCES', res.data)
  },
  async fetchCities({ commit }, provinceId) {
    const res = await getCities(provinceId)
    commit('SET_CITIES', res.data)
  },
  async fetchDistricts({ commit }, cityId) {
    const res = await getDistricts(cityId)
    commit('SET_DISTRICTS', res.data)
  }
}