ac-city-select
react ac-city-select component for tinper-bee
地区级联
使用方法
import ReactDom from 'react-dom';
import CitySelect from 'ac-city-select';
ReactDom.render(<CitySelect />,document.getElementById('app'));
API
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
className | 类名 | string | - |
defaultValue | 默认值,格式为{ province:'北京',city:'北京',area:'东城区'}
|
array | { province:'北京',city:'北京',area:'东城区'} |
onChange | 改变时的回调,参数为当前值,格式为{ province:'北京',city:'北京',area:'东城区'}
|
function | - |
provinceData | 预制地区数据,格式为 [{ "name": "北京", "city":[{"name":"北京", "area":["东城区","西城区","崇文区","宣武区","朝阳区","丰台区","石景山区","海淀区","门头沟区","房山区","通州区","顺义区","昌平区","大兴区","平谷区","怀柔区","密云县","延庆县"]}]}, { "name": "天津", "city":[{"name":"天津", "area":["和平区","河东区","河西区","南开区","河北区","红桥区","塘沽区","汉沽区","大港区","东丽区","西青区","津南区","北辰区","武清区","宝坻区","宁河县","静海县","蓟 县"]}]}] ,使用此props必须设置 defaultValue
|
array | - |
lang | 组件预制三种语言。zh_CN 中文简体(默认)、zh_TW 中文繁体、en_US 英文 | string | zh_CN |
disabled | 组件控制是否被禁用。组件预置默认值为false,设置组件为禁用状态, 设置属性为disabled:true | bool | false |
disabledProvinceArr | 设置不可用省份,格式为['天津', '河北'] (注意: 设置的不可用字段要和lang设置的语言类型相对应,不然设置了会不生效) |
array | - |
disabledCityArr | 设置不可用地级市,格式为["天津", "长春", "四平", "大连"] (注意: 设置的不可用字段要和lang设置的语言类型相对应,不然设置了会不生效) |
array | - |
disabledAreaObj | 设置不可用区域,格式为{"鞍山": ["铁东区", "铁西区", "立山区"],"抚顺": ["新抚区", "东洲区", "望花区", "抚顺县"], "北京": ["崇文区", "宣武区", "朝阳区"]} (注意: 设置不可用区域的时候要加上区域所在的地级市(父级),地级市作为json的key值, 这样可以避免设置区域被重复禁用) |
Object | - |
allowClear | 组件控制是否可以被清空。组件预置默认值为false,设置属性为allowClear:true时,组件设置可以被清空, | bool | false |
开发调试
$ npm install -g bee-tools
$ git clone https://github.com/tinper-bee/ac-city-select
$ cd ac-city-select
$ npm install
$ npm run dev