0.0.18 • Published 6 years ago

@alicd/crui-address-multi-field v0.0.18

Weekly downloads
1
License
-
Repository
-
Last release
6 years ago

category: Components type: UI Views component: Form chinese: 地址多选框

english: AddressMultiField

地址多选组件。

API

成员说明类型默认值
value当前组件中的地址值,以 JSON 对象的数组的形式表示,每一个元素包含 countryprovincecityareatown 等字段object[]N/A
onChange用户的选择等交互使地址值变化时所调用的函数参数:value: object 改变后的地址数组,可直接设置到 value 属性上nodes: object[]value 各值对应的地址详细信息,可用来取地名等(value: object[], nodes: object[]) => voidN/A
root多选框选择弹层的根地址节点,用于指定地址选择的区域,地址组件只能选择区域内的地址object{ "country": 1 }(默认选择国内地址)
className自定义类名stringN/A
style自定义组件内联样式objectN/A
size选择框大小"small""medium""large""medium"
level选择到几级地址,1 为只选择省,4 为从省到街道全部选择(国家选择请使用 root 属性控制)number4 (省、市、区、街道四级全部启用)
placeholder选择框占位符stringN/A
disabled是否禁止用户编辑地址booleanfalse
container指定渲染地址选择弹层的容器,一般不需要设置该属性any默认为地址组件本身
popupProps弹层的属性,参见 SelectField 组件objectN/A
popupClassName弹层的类名stringN/A
requestAddressUrl国家、省、市、区四级数据的接口地址,默认拉取最新数据string"//division-data.alicdn.com/simple/addr_4_1111_1_0.js"
requestTownUrl用于街道一级数据的接口地址string"//lsp.wuliu.taobao.com/locationservice/addr/output_address_town.do"
requestAddressLevelUrl用于街道一级数据的接口地址string"//lsp.wuliu.taobao.com/locationservice/addr/outputParentDivisons.do"
hiddenData数据中不做展示的地址 ID 数组,用于去除部分数据。注意不要将该属性误写为 "hidden","hidden" 属性将会将组件隐藏string[][]
ignored数据中忽略的地址 ID 数组,用于去除部分数据。注意 hiddenData 与本属性的区别,ignored 会将地址节点从数据中彻底剔除(用户无法选择,且使用被忽略掉的地址进行 setValue() 不被识别),hiddenData 仅仅在展示时隐藏地址节点(用户无法选择),且 ignoreddataOverridepreprocessor 等属性仅在地址数据加载时有效,之后对这些属性的更新均无效。一般推荐使用 hiddenData 属性string[][]
dataOverride需要临时复写、增加新的地址数据时使用{ [addressID: number]: string[] }{}
preprocessor需要对地址数据定制更细致的预处理工作时使用的回调接口,一般优先使用 hiddenData, ignored, dataOverride 等属性,需求无法满足时再考虑使用本属性(dataRaw: { [addressID: number]: string[] }) => { [addressID: number]: string[] }默认直接返回第一个参数(不进行任何操作)