首页 > 文章列表 > Vue组件开发:多级联动选择器实现

Vue组件开发:多级联动选择器实现

vue组件 多级联动 选择器实现
210 2023-11-24

Vue组件开发:多级联动选择器实现

在前端开发中,多级联动选择器是一个常见的需求,比如省市区选择、年月日选择等。本文将介绍如何使用Vue组件实现多级联动选择器,并附有具体的代码实现示例。

如何实现多级联动选择器?

实现多级联动选择器需要用到Vue的组件化开发思想,将一个大的选择器拆分为若干个子组件,分别负责渲染每一个级别的选项。在每次级别的选择变化时,都要更新后续级别的选项,这就需要用到Vue组件之间的通信机制。

另外,选择器需要从外部接收初始值,并在选择发生变化时向外部发出事件通知。这可以使用props和$emit实现。

下面我们来逐步实现这个多级联动选择器组件。

第一步:定义子组件

我们先定义每个级别的选择器子组件。以下是一个简单的省份选择器的子组件的代码:

<template>
  <select v-model="selected">
    <option value="">请选择</option>
    <option v-for="item in options" :value="item">{{ item }}</option>
  </select>
</template>

<script>
export default {
  props: {
    options: {
      type: Array,
      required: true
    },
    value: {
      type: String,
      default: ''
    }
  },
  data() {
    return {
      selected: this.value
    }
  },
  watch: {
    selected(newValue) {
      this.$emit('change', newValue)
    }
  }
}
</script>

代码解释:

  • 使用select标签渲染下拉选项框,并使用v-model绑定当前选项的值;
  • 使用v-for遍历父组件传入的options,动态生成option列表;
  • 使用props接收父组件传入的options和value(当前选中项的值),并通过data()初始化selected值;
  • 使用watch监听selected值变化,当选项变化时发出change事件,向父组件通知新的选择值。

第二步:定义父组件

接下来,我们定义多级联动选择器的父组件。该组件负责渲染所有子组件,并在选项变化时更新后续子组件的选项。

以下是一个简单的两级联动选择器的代码:

<template>
  <div>
    <CitySelect :options="provinces" v-model="selectedProvince"/>
    <CitySelect :options="cities" v-model="selectedCity"/>
  </div>
</template>

<script>
import CitySelect from './CitySelect.vue'

export default {
  components: {
    CitySelect
  },
  data() {
    return {
      provinces: ['广东', '江苏', '浙江'],
      cities: {
        '广东': ['广州', '深圳'],
        '江苏': ['南京', '苏州'],
        '浙江': ['杭州', '宁波']
      },
      selectedProvince: '',
      selectedCity: ''
    }
  },
  watch: {
    selectedProvince(newValue) {
      this.selectedCity = ''
      if (newValue) {
        this.cities = this.$data.cities[newValue]
      } else {
        this.cities = []
      }
    }
  }
}
</script>

代码解释:

  • 在template中使用两个CitySelect子组件,分别渲染省和市的选择框,通过v-model绑定当前选中的省份和城市;
  • 在data函数中定义provinces和cities两个数组,provinces数组储存所有的省份,cities对象储存所有的城市,使用selectedProvince和selectedCity记录当前选中的省份和城市;
  • 在watch中监听selectedProvince的变化,当省份变化时更新cities数组,用于渲染下一级城市选择框。

第三步:组合所有子组件

我们已经定义好所有的子组件和父组件后,只需将所有子组件组合起来,就可以形成一个完整的多级联动选择器了。

以下是一个简单的三级联动选择器的代码:

<template>
  <div>
    <RegionSelect :options="provinces" v-model="selectedProvince"/>
    <RegionSelect :options="cities" v-model="selectedCity"/>
    <RegionSelect :options="districts" v-model="selectedDistrict"/>
  </div>
</template>

<script>
import RegionSelect from './RegionSelect.vue'

export default {
  components: {
    RegionSelect
  },
  data() {
    return {
      provinces: ['广东', '江苏', '浙江'],
      cities: {
        '广东': ['广州', '深圳'],
        '江苏': ['南京', '苏州'],
        '浙江': ['杭州', '宁波']
      },
      districts: {
        '广州': ['天河区', '海珠区'],
        '深圳': ['福田区', '南山区'],
        '南京': ['玄武区', '鼓楼区'],
        '苏州': ['姑苏区', '相城区'],
        '杭州': ['上城区', '下城区'],
        '宁波': ['江东区', '江北区']
      },
      selectedProvince: '',
      selectedCity: '',
      selectedDistrict: ''
    }
  },
  watch: {
    selectedProvince(newValue) {
      if (newValue) {
        this.cities = this.$data.cities[newValue]
        this.selectedCity = ''
        this.districts = []
      } else {
        this.cities = []
        this.districts = []
      }
    },
    selectedCity(newValue) {
      if (newValue) {
        this.districts = this.$data.districts[newValue]
        this.selectedDistrict = ''
      } else {
        this.districts = []
      }
    }
  }
}
</script>

代码解释:

  • 在template中使用三个RegionSelect子组件,分别渲染省、市和区的选择框,通过v-model绑定当前选中的省、市和区;
  • 在data函数中定义provinces、cities和districts三个对象,provinces数组储存所有的省份,cities对象储存所有的城市,districts对象储存所有的区,使用selectedProvince、selectedCity和selectedDistrict记录当前选中的省、市和区;
  • 在watch中监听selectedProvince和selectedCity的变化,当省份或城市变化时更新后续选择框的选项和选中值。

三级联动选择器已经完成了!你可以在Vue组件模板中引用该组件,如下所示:

<template>
  <div>
    <RegionSelect v-model="selectedRegion"/>
  </div>
</template>

<script>
import RegionSelect from './RegionSelect.vue'

export default {
  components: {
    RegionSelect
  },
  data() {
    return {
      selectedRegion: ['广东', '深圳', '南山区']
    }
  }
}
</script>

总结

本文介绍了如何使用Vue组件实现多级联动选择器,包括定义子组件和父组件,以及组合所有子组件的过程。通过这个例子,我们可以了解到Vue组件化开发的基本思想,以及组件之间的通信机制。当然,实际开发中还需要考虑更多的细节,例如异步数据获取、修改子组件自身的样式等问题,这些内容并没有在本文中涉及。