@beisen-phoenix/mobile-area-selector

地区选择基础交互组件

Usage no npm install needed!

<script type="module">
  import beisenPhoenixMobileAreaSelector from 'https://cdn.skypack.dev/@beisen-phoenix/mobile-area-selector';
</script>

README

概述

地区选择基础交互组件

使用方式

    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",["国内"], "" , ""]
        ...
    ]
}