---
order: 5
navTitle: 勾选框
---
# SuperPage组件-勾选框/单选框

勾选框与单选框的使用方法一致，只是样式不同。本文以勾选框为例介绍勾选框、单选框的用法。

![勾选框示例](./images/gxk.gif)

示例地址：[勾选框](https://demo.succbi.com/v5/DEMO/app/ap.app?id=%E5%8B%BE%E9%80%89%E6%A1%86)

## 使用勾选框组件提交数据{#submit}

勾选框输入组件的**提交数据**和其它输入组件**提交数据**操作方式一致，勾选**提交数据**属性并设置**绑定字段**属性，可以将输入信息提交到数据库中，具体可参考[文本输入组件](./textinput.md#submit)。

## 使用勾选框组件过滤数据{#filter}

勾选框和单选框本身不具备自动过滤的功能，当需要使用该组件过滤其它组件数据时，例如根据勾选框是否发生股权转让过滤列表数据，可以如下方式实现：

- 在数据下选中需要过滤数据的模型，**右键**>**设置**>**过滤条件**，点击**添加**选择**表达式**，输入表达式`[企业年报].[是否发生股权转让]=[是否发生股权转让].[值]`

![使用组件](./images/gxkgl.gif)

:::tip
过滤数据需要在添加的数据模型上设置过滤条件，即可作用在所有引用了该数据模型的组件，可参考文档[为仪表板添加数据-数据模型设置](../../../../data-viz/dash/design/datasource.md#filter)
:::

## 设置勾选框的返回值{#value}

在**勾选框**>**高级**属性里可以指定勾选框的返回值，即当勾选框勾选时与未勾选时返回的值：

- 勾选值：默认是1，勾选时提交的数据值
- 未勾选值：默认值是0，不勾选时提交的数据值

例如是否已婚的勾选框，勾选后返回值是1，表示已婚；未勾选返回值是0，表示未婚。

![返回值](./images/2020-12-15-17-47-40.png)