1.2.2 • Published 5 years ago

ct-adc-area-selector v1.2.2

Weekly downloads
36
License
-
Repository
-
Last release
5 years ago

ct-adc-area-selector

地区选择组件, select联动

组件示例图

img

在线demo

在线demo

功能点

  1. selector联动选择地区
  2. 数据源使用公司统一AREA库
  3. 可以选择全国或指定地区

使用

从npm安装ct-adc-area-selector

npm install ct-adc-area-selector --save

在代码中使用

import AreaSelector from 'ct-adc-area-selector';

Vue.component(AreaSelector.name,AreaSelector);
或
new Vue({
    el: '#app',
    components: {
        AreaSelector
    }
}

props

参数说明类型默认值可选值描述
initialArea初始选中的地区String''''或合法的地区名称/编码以-分割如'浙江-杭州-西湖区'或0601(浙江-杭州),为全国时,等于(===)codeForNation
sep地区分隔符String'-'地区名称中的分隔符
showNation是否显示全国选项Booleanfalsetrue/false若不显示全国选项,selector只有三个
codeForNation表示"全国"的codeString'00'任何数字或数字组成的字符串其他的地区都是有编码的,但"全国"没有。请配置和后端约定的地区编码
min精确到的地区类型String'region''province' / 'city' / 'region'例如只想选择省,就把该值配置为'province'
areaList地区源数据Function返回全部地区数据返回地区数据的方法,地区源数据格式见下方说明

areaList

该方法返回如下结构的数据:

{
    "province": [{"ID": "04", "Name": "江苏"}, {"ID": "06", "Name": "浙江"}, {"ID": "09", "Name": "江西"}],
    "city": {
        "北京": [],
        "天津": [],
        "上海": [],
        "江苏": [{"ID": "0401", "Name": "南京"}.....],
        .....
    },  
    "region": {
        "北京": [],
        "天津": [],
        "上海": [],
        "南京": [{"ID": "040101", "Name": "玄武区"}.....],
        ......
    }
}

方法

getArea

获得选择的结果

参数列表

参数说明类型默认值可选值描述
readable结果是中文还是编码Booleantruetrue / false如果为true返回中文,false则返回地区编码

返回值

类型: {String}

说明: 当前选择的地区

事件

change事件

当选择select框且引发了数据改变时,发生该事件。参数为带有分割符(由sep属性指定)的字符串,如'浙江-杭州-西湖区'。

事件名称 | 说明 | 回调参数 | 描述 selected | 选中事件 | value1:说明1; value2: 说明2 | 描述

更新日志

更新日志

外部资源依赖列表

  • area.js(1.0.0+)
1.2.2

5 years ago

1.2.1

5 years ago

1.2.0

6 years ago

1.1.0

6 years ago

1.0.3

6 years ago

1.0.2

7 years ago

1.0.1

7 years ago

1.0.0

7 years ago

0.1.0

7 years ago

0.0.3

7 years ago

0.0.2

7 years ago

0.0.1

7 years ago