更新记录

2.0.1(2024-08-22) 下载此版本

  • 修复 uni-app-x v-model 没有更新传入值的 bug

2.0.0(2023-12-14) 下载此版本

  • 新增 支持 uni-app-x

1.1.2(2023-04-11) 下载此版本

  • 修复 更改 modelValue 报错的 bug
  • 修复 v-for 未使用 key 值控制台 warning
查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue app-nvue ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
× × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

DataPicker 级联选择

组件名:uni-data-picker 代码块: uDataPicker 关联组件:uni-data-pickerviewuni-load-more

<uni-data-picker> 是一个选择类datacom组件

支持单列、和多列级联选择。列数没有限制,如果屏幕显示不全,顶部tab区域会左右滚动。

候选数据支持一次性加载完毕,也支持懒加载,比如示例图中,选择了“北京”后,动态加载北京的区县数据。

<uni-data-picker> 组件尤其适用于地址选择、分类选择等选择类。

<uni-data-picker> 支持本地数据、云端静态数据(json),uniCloud云数据库数据。

<uni-data-picker> 可以通过JQL直连uniCloud云数据库,配套DB Schema,可在schema2code中自动生成前端页面,还支持服务器端校验。

在uniCloud数据表中新建表“uni-id-address”和“opendb-city-china”,这2个表的schema自带foreignKey关联。在“uni-id-address”表的表结构页面使用schema2code生成前端页面,会自动生成地址管理的维护页面,自动从“opendb-city-china”表包含的中国所有省市区信息里选择地址。

查看文档

如使用过程中有任何问题,或者您对uni-ui有一些好的建议,欢迎加入 uni-ui 交流群:871950839

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

uni-data-picker 数据驱动的picker选择器(以下简称软件)源码使用许可协议

2022年10月

本许可协议,是数字天堂(北京)网络技术有限公司(以下简称DCloud)对其所拥有著作权的“软件”,提供的使用许可协议。

您对“软件”的复制、使用、修改及分发受本许可协议的条款的约束,如您不接受本协议,则不能使用、复制、修改本软件。

授权许可范围

a) 授予您永久性的、全球性的、免费的、非独占的、不可撤销的本软件的源码使用许可,您可以使用这些源码制作自己的应用。

b) 您只能在DCloud产品体系内使用本软件及其源码。您不能将源码修改后运行在DCloud产品体系之外的环境,比如客户端脱离uni-app,或服务端脱离uniCloud(如涉及uniCloud)。

c) DCloud未向您授权商标使用许可。您在根据本软件源码制作自己的应用时,需以自己的名义发布软件,而不是以DCloud名义发布。

d) 本协议不构成代理关系。

DCloud的责任限制 “软件”在提供时不带任何明示或默示的担保。在任何情况下,DCloud不对任何人因使用“软件”而引发的任何直接或间接损失承担责任,不论因何种原因导致或者基于何种法律理论,即使其曾被建议有此种损失的可能性。

您的责任限制

a) 您需要在授权许可范围内使用软件。

b) 您在分发自己的应用时,不得侵犯DCloud商标和名誉权利。

c) 您不得进行破解、反编译、套壳等侵害DCloud知识产权的行为。您不得利用DCloud系统漏洞谋利或侵害DCloud利益,如您发现DCloud系统漏洞应第一时间通知DCloud。您不得进行攻击DCloud的服务器、网络等妨碍DCloud运营的行为。未经书面许可,您不得利用DCloud的产品进行与DCloud争夺开发者的行为。

d) 如您违反本许可协议,需承担因此给DCloud造成的损失。

本协议签订地点为中华人民共和国北京市海淀区。

根据发展,DCloud可能会对本协议进行修改。修改时,DCloud会在产品或者网页中显著的位置发布相关信息以便及时通知到用户。如果您选择继续使用本框架,即表示您同意接受这些修改。

条款结束

397***@qq.com

2025-03-08

有一天发现打包代码大小莫名多了很多,定位半天后发现是这个插件,有很多云函数什么鬼的方法。我用的是本地数据,没用云数据,看下源代码,把getCommand方法,db对象置空,再打包小了将近200kb的代码。

540***@qq.com

2025-03-07

请问可以多选吗?

bt语言

2025-02-24

经过多次测试,uni-app x中不支持回显,v-model 不生效,并且官网示例:https://uniapp.dcloud.net.cn/component/uniui/uni-data-picker.html 的示例代码直接运行也是一样没有回显!

296***@qq.com

2025-01-13

在使用支付宝云时,引用数据库表opendb-city-china.schema.json的其他schema,通过schema2code生成的代码使用uni-data-picker这个组件选址城市信息时报错。

119***@qq.com

2025-01-06

希望能有个确认按钮来支持选择任意的数据列

梧桐树

2024-12-18

竟然仅支持text value children啊

seaton

2024-12-05

uni-cms中field无法转换_id,导致默认选中了全部

无敌布偶

2024-11-19

作者大大,下级id和上级id相同存在取值问题

xie***@qq.com

2024-10-18

三级联动的情况下,我想只选择到二级,这种情况没有办法实现啊

逍遥哥哥

2024-10-14

很差,无论是文档还是使用体验比uview差很多

2024-11-09

当我修改v-model="pickerValue" 时,点击打开picker不能正常显示value对应的选择项1-2-1这样

2024-08-20

```javascript uni-data-picker self-field="code" parent-field="parent_code" v-model="formData.discharge_place" collection...

2024-07-11

未创建uniCloud目录,程序其他地方也没有使用到uniCloud,使用该插件后,打包会报错,请问如何解决?

2024-07-01

我在使用UNI-APP X +VUE3 + 该组件 当我点击一级菜单 比如 “一年级” 时报错 17:07:35.605 [Vue warn]: Invalid prop: type check ...

2024-06-25

可以添加搜索功能吗?数据量一多,查找选择项是个大问题,很难找啊

2024-04-30

你的这个实例,数据多的情况下,在微信开发者工具的iphone12/13 pro的模式下显示,会出现闪屏

2024-02-16

使用云端数据,选择数据后自动刷新数据,把选择好的数据刷没了 [attach]127397[/attach]

2024-01-17

需要点开一层,请求一次接口,大量数据总不能一次全返回吧

2023-12-28

1、HX版本3.99数据是接口返回的,数据返回的时间比较久。见下图附件。 2、还有分步查询怎么使用,在官方文档里出个demo,写的配置都写上了,根本分步根本不生效。

2023-12-12

在 app 端提示 没有 ref show 方法