进阶 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 这个页面对你有帮助吗?

评论 (0)