1.0.18 • Published 5 years ago
@beisen-phoenix/mobile-area-selector v1.0.18
概述
地区选择基础交互组件
使用方式
npm install --save @beisen-phoenix/mobile-area-selector
API说明
参数 | 说明 | 类型 | 默认值 | 必须 |
---|---|---|---|---|
isMulti | 单选/多选 | boolean | false | Yes |
required | 多选保存时,是否校验选中数据为空 | boolean | true | No |
selectData | 默认选中的值 | Array id: 地区id, label: 地区显示名称 | 无 | Yes |
getDataUrl | 数据常量请求链接 | String | "//const.italent.cn/resource/Areas-chs-74-100000.js" | No |
clearText | 清空显示文字 | String | "清空" | No |
cancelText | 头部取消显示文字 | String | "取消" | No |
submitText | 头部确定显示文字 | String | "完成" | No |
selectPlaceholderText | 多选情况下,选中数据为空时,显示的文字 | String | "请在下方选择地区" | No |
useDefaultAreaData | 是否使用默认数据 | Boolean | true | No |
areaData | 地区的值 | Object | 无 | No |
onSubmit | 确定方法 | Function | 无 | Yes |
onCancel | 取消方法 | Function | 无 | Yes |
show | 是否显示 | Boolean | 无 | Yes |
数据格式注意
- getDataUrl 现在是纯中文版本,如果是其他语言版本需要自己拼接链接,数据返回的内容格式如下:
ConstAreas([
["1",["全国"],"",0],
["2",["国外"],"",1],
....
])
数据解释及含义
["1",["全国"],"",0]
数组的第一个元素代表地区的id, 第二个代表显示的文字, 第三个代表数据的父级元素、 第四个元素代表是否含有子地区地区数据的全国和国外id为1、2,parentId为空,都应该是含有子节点的
- areaData的数据单项格式
["1",["国内"], "" , 0]
数据含义的解释如上
样式属性
const propsData = {
isMuiti: false,
selectData: [{
id: "1001",
label: "顺义区"
}],
areaData: [
["1",["国内"], "" , ""]
...
]
}