vue地区选择组件

AddressMap

a vue.js componentjavascript

概述

主要用于全国地区数据的操做,包括省,市,区三级联动,地区数据的添加和删除; 在操做地区数据时,之前也用过树形的地区选择组件,但因其在再操做大量的地区数据时,渲染缓慢,因此咱们就换了另外一种数据展现形式和交互形式,从而就有了这个组件。html

注意:该组件是vue.js组件vue

demo

抢鲜体验请点击这里demojava

API

Props

参数 类型 说明
area Array 传入组件的地区的数据

Events

事件名 参数 说明
selected area 组件中选中的地区

详细说明

Props

area

area 参数是必选项,表示组件初始化时的地区数据,能够为空。 area 是一个包含多个对象的数组,其中每一个对象的数据结构以下:git

...
area: [
    {Name: '北京',  ID: '01'},
    {Name: '南京', ID: '0401'},
    {Name: '西湖区', ID: '060105'}
],
...
复制代码

由于后来在实际的使用中,发现有时候,后台只会返回一个地区的ID值,因此这里作了优化,能够只传入ID的值,好比这样:github

...
area: [
    {ID: '01'},
    {ID: '0401'},
    {ID: '060105'}
],
...
复制代码

selected

selected是由组件内部发布的一个事件,你能够在组件外面订阅这个事件,从而获得它返回的值,这个值就是组件当前选中的全部的地区,返回的这个值是由多个包含地区数据的对象组成的数组,数据结构和 area参数同样npm

简单的例子

<div>
     <addressmap :area="area" @selected="selected"></addressmap>
</div>
复制代码

安装和使用

npm install adc-addressmap
复制代码
  • 若做为全局组件使用
//在项目入口文件
import Vue from 'vue'
import Addressmap from 'adc-addressmap'
Vue.component('Addressmap', Addressmap)
复制代码
  • 若做为局部组件
//在某个组件中
import Addressmap from 'adc-addressmap'
export default {
...
  components: { Addressmap},
...
}
复制代码

该组件后续功能的预告

  • 结合百度的ECharts增长数据可视化的功能

最后欢迎Star

github地址数组

相关文章
相关标签/搜索