进阶 docs.budibase.com 2026-11-12 08:33:37 · 18 阅读
第32章 Checkbox 复选框组件详解
# 第32章 Checkbox
Checkbox 组件允许用户勾选或不勾选一个复选框。
## 添加 Checkbox
Checkbox 组件可以添加到 Form 组件中,也可以作为独立组件使用。
要在页面中添加 Checkbox 组件,请点击 Form > Checkbox。
## 自定义 Checkbox
要自定义 Checkbox,可以在 Settings Panel 中使用多个设置项。
值得注意的是,Checkbox 与布尔类型深度集成,可以用来表示表中某列的值是 true 还是 false。
## 示例:筛选
Checkbox 组件也可以作为独立组件使用(不包裹在 Form 中),这在实现 Table 的筛选/排序功能时非常有用。
下面这个例子中,我使用 Budibase 示例数据表 "Employees"。我修改了部分行的 "End Date",表示这些员工已经离职。
然后我在页面中添加了一个 Checkbox 组件,以及一个设置为显示 Employees 表的 Table 组件。Checkbox 组件的字段设置为 "is_employed",标签为 "Current Employees Only"。
在 Table 组件的 Conditions 中添加一个新条件。
条件应设置为:Update Setting >> Filtering TO 1 filter set IF {{ [New Checkbox].Value }} Equals Boolean True
设置 Filter 时,筛选条件应为 End Date is empty——这假设有离职日期的员工已不在职,这样 "Current Employees Only" 复选框就能更新表格筛选条件,只显示仍在职的员工记录。
更新于 6 个月前 此页面是否有帮助?
| Setting | Description | Default Value |
|---|---|---|
| Accepts true or false as values to have it checked or unchecked respectively | ||
| Text | 复选框右侧显示的文字,这段文字本身也可以点击,与复选框联动。 | |
| Size | 文字和复选框的大小,从小到大有多种预设尺寸。 | |
| Disabled / Read only | 勾选后,用户将无法更改该值。 |