进阶 docs.budibase.com 2026-11-12 08:33:37 · 20 阅读
第60章 使用 Data provider 为组件提供数据
第60章 Data provider
使用 Data provider 为屏幕上的组件提供数据。
组件无需嵌套在 Data provider 内部即可使用它,只需在组件的数据设置中选择该 provider 即可。
选择数据源
在屏幕上添加一个 Data provider,然后在 Data 下拉框中选择数据源。可选数据源包括:
- Budibase DB 表
- SQL 数据源
- 自定义查询
- REST 查询
- 屏幕上已有的其他 Data provider
当多个组件需要相同数据时,复用已有的 provider 会很方便。
配置结果
通过 Data provider 可以:
- 设置排序字段和排序方式
- 限制返回的行数
- 对结果进行分页
- 添加过滤器
limit 用于设置每页返回的最大行数。当数据源支持分页时,provider 会显示翻页控件。
服务端与客户端操作
对于表类数据源(包括 Budibase DB 表和 SQL 表),过滤、排序、行数限制和分页都在服务端完成。
自定义查询和 REST 查询只有在底层查询本身配置了分页时才支持分页。针对这些查询返回的行,Data provider 的过滤和排序是在浏览器中完成的。对于已分页的查询,这意味着过滤和排序只作用于当前页。数据量较大时,建议在底层查询中添加过滤和排序参数。
过滤
使用 Define filters 来限制返回的行。
过滤支持:
- 静态值
- Bindings
- Match all 和 Match any 分组
如果过滤器使用了 binding 且该 binding 为空,可以选择返回全部行或不返回任何行。更多过滤模式参见 Adding filtering。
刷新数据
使用 Auto-refresh 可以按设定间隔自动重新执行 provider。Auto-refresh 是付费功能。
若要在用户交互后刷新数据,可使用 Refresh Data Provider 动作,并选择刷新当前 provider 或所有 provider。
使用 provider 绑定
Data provider 在屏幕上暴露以下绑定值:
- Rows - 当前页返回的行
- Rows Length - 当前返回的行数
- Schema - 所选数据源的字段信息
- Page Number - 当前页码,从 1 开始
更新于 9 天前 下一步:Repeater 这个页面对你有帮助吗?