进阶 docs.budibase.com 2026-11-12 08:33:37 · 20 阅读
第37章 Budibase 第37章:Filter(筛选)组件详解
Filter
Filter 组件可用于允许用户在浏览你提供的内容时,对数据进行检索和细化。
筛选表格
在表格中使用 Filter 组件非常便捷。只需将 Filter 组件添加到任何包含表格的屏幕上,并在“目标组件”中选择对应的表格。配置完成后,你可以使用设置面板来选取需要筛选的列。
交互
当用户在已发布的应用中操作 Filter 时,其输入框会自动获得焦点,以提升输入效率。输入期望数值后,只需点击“应用”按钮或按回车键即可应用筛选条件。
筛选数据提供者
包含图表的数据提供者
本示例将使用 Budibase 示例数据库中的 Jobs 表。
1. 使用 Budibase 示例数据,前往 Jobs 表并创建一个名为“jobs-by-date”的新视图。除了“Job ID”、“Quote Date”和“Quote Price”外,将所有其他列设置为隐藏。
2. 接着进入 Design 区域,在你的屏幕中添加一个 Data Provider、一个嵌套在 Data Provider 内的 Pie Chart 以及一个 Filter 组件。
3. 在 Data Provider 的设置中,选中你刚刚创建的视图。
4. 在 Filter 组件的设置中,将其目标指向步骤 2 中添加的 Data Provider,并选中“Quote Date”和“Quote Price”。这些列将作为用户筛选 Data Provider(进而筛选 Pie Chart)的维度。
5. (可选)勾选“Persist filters”后,系统将保存用户设置的筛选条件,以便其返回该页面时自动恢复。这与在设置 App State 时使用“Persist this value”类似。勾选“Clear Filters”则会给用户提供一个按钮,以便一键清除所有列上的现有筛选条件。这在处理复杂筛选场景时非常有用。
设置 Setting:目标组件(Target Component)——选择屏幕上的任意 Table 或 Data provider,对其应用筛选。 默认筛选类型(Default filter type)——用户新增筛选时的初始筛选条件类型。 持久化筛选(Persist Filters)——类似 App State,用户离开页面后返回时,已应用的筛选条件依然保留。 清除筛选(Clear Filters)——显示“清除筛选”按钮,方便用户一键重置所有生效的筛选。 尺寸(Size)——控制筛选输入框/按钮的视觉大小。 ⚙️ >> Label:文本输入框,用于重命名筛选(默认为列名)。 更新于 4 个月前。这个页面对你有帮助吗?
设置 Setting:目标组件(Target Component)——选择屏幕上的任意 Table 或 Data provider,对其应用筛选。 默认筛选类型(Default filter type)——用户新增筛选时的初始筛选条件类型。 持久化筛选(Persist Filters)——类似 App State,用户离开页面后返回时,已应用的筛选条件依然保留。 清除筛选(Clear Filters)——显示“清除筛选”按钮,方便用户一键重置所有生效的筛选。 尺寸(Size)——控制筛选输入框/按钮的视觉大小。 ⚙️ >> Label:文本输入框,用于重命名筛选(默认为列名)。 更新于 4 个月前。这个页面对你有帮助吗?