You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
huazhiyu/uni_modules/data-picker/readme.md

35 lines
2.4 KiB

1 year ago
# data-picker
**具体使用示例请导入示例项目查看**
1、该组件在uview的基础上研发,使用前需要先引入uview,[点击查看组件引入教程](http://t.csdn.cn/9uFhh)
2、sourceData如果不传的话,会默认取区域数据作为数据源
3、支持三种模式传递默认值,如下
```
indexs: [0, 0, 7],
defaultIds: [1, 110000, 110111],
defaultNames: ['北京市', '北京市', '房山区']
```
4、三种默认任选其一即可,如果传了多个,则选择其中一种生效,权重从大到小为indexs、defaultNames、defaultIds
5、自动识别需要的层级,如数组长度为1,显示一列,长度为3,显示3列
6、默认显示底部按钮,如果需要切换为顶部按钮,则需要传递参数showToolbar=true和showBottombar=false
### DataPicker Props
| 属性名 | 类型 | 可选值 | 默认 | 说明 |
| :-----------: | :-----: | :--------: | :------------: | :----------------------------------------------------------: |
| indexs | Array | - | - | 默认选择数据下标 |
| defaultNames | Array | - | - | 默认选择数据的name |
| defaultIds | Array | - | - | 默认选择数据的id |
| sourceData | Array | - | 省市县区域数据 | 源数据。不传则默认读取省市县区域数据 |
| showToolbar | Boolean | true/false | false | 显示顶部操作按钮 |
| showBottombar | Boolean | true/false | true | 显示底部操作按钮 |
| labelName | String | - | name | 默认sourceData中对象属性名为name,如果不是name,<br />可以自定义名称,具体可以看示例项目 |
| initBack | Boolean | true/false | true | 是否返回根据默认值加载的数据,相当于初始化后手动点了一次确认,<br />获取数据同样在confirm里面 |
注意:由于本组件是基于uview中的picker开发的,u-picker组件中所有的属性在本组件都支持,不再重复罗列, [点击查看u-picker组件属性](https://www.uviewui.com/components/picker.html)