---
title: Checkbox - 复选框
nav:
  title: RN 组件
  path: /react-native
group:
  title: 表单组件
  path: /form
  order: 7
---

# Checkbox 复选框

## 效果演示

### 1. 默认效果

```tsx | pure
<Checkbox
  options={[
    { label: 'Apple', value: 'Apple' },
    { label: 'Pear', value: 'Pear' },
    { label: 'Orange', value: 'Orange' },
  ]}
/>
```

<center>
  <figure>
    <img
      alt="card-ios1"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1643097541850634284.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 2. 默认选中一个复选框

```tsx | pure
<Checkbox
  options={[
    { label: 'Apple', value: 'Apple' },
    { label: 'Pear', value: 'Pear' },
    { label: 'Orange', value: 'Orange' },
  ]}
  defaultValue={['Pear']}
/>
```

<center>
  <figure>
    <img
      alt="card-ios1"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1643097612076589222.png"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 3. 不显示全选

```tsx | pure
<Checkbox
  options={[
    { label: 'Apple', value: 'Apple' },
    { label: 'Pear', value: 'Pear' },
    { label: 'Orange', value: 'Orange' },
  ]}
  showCheckAll={false}
/>
```

<center>
  <figure>
    <img
      alt="card-ios1"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1643097712505780986.png"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 4. 禁用某个复选框

```tsx | pure
<Checkbox
  options={[
    { label: 'Apple', value: 'Apple' },
    { label: 'Pear', value: 'Pear' },
    { label: 'Orange', value: 'Orange' },
  ]}
  showCheckAll={false}
/>
```

<center>
  <figure>
    <img
      alt="card-ios1"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1643097869657649774.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 5. 复选框列表

```tsx | pure
<CheckboxList
  options={[
    { label: 'Apple', value: 'Apple' },
    { label: 'Pear', value: 'Pear' },
    { label: 'Orange', value: 'Orange' },
  ]}
/>
```

<center>
  <figure>
    <img
      alt="card-ios1"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1643097786018078990.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

## API

### Checkbox / CheckboxList

| 属性           | 必填    | 说明                     | 类型                           | 默认值 |
| -------------- | ------- | ------------------------ | ------------------------------ | ------ |
| options        | `true`  | 指定可选项               | `RadioOption[]`                |        |
| value          | `false` | 选中的项                 | `ReactText[]`                  |        |
| onChange       | `false` | 选中单选框触发的回调函数 | `(value: ReactText[]) => void` |        |
| defaultValue   | `false` | 默认选中的项             | `ReactText[]`                  |        |
| size           | `false` | 图标大小                 | `number`                       |        |
| disabledValue  | `false` | 设置禁用的项             | `ReactText[]`                  |        |
| containerStyle | `false` | 自定义容器样式           | `ViewStyle`                    |        |
| itemStyle      | `false` | 自定义单个单选框样式     | `ViewStyle`                    |        |
| labelStyle     | `false` | 自定义文本样式           | `TextStyle`                    |        |
| showCheckAll   | `false` | 是否显示全选框           | `boolean`                      | `true` |
| activeOpacity  | `false` | 未禁用时的不透明度       | `number`                       | `0.6`  |

### CheckboxItem

| 属性       | 必填    | 说明                            | 类型                                              | 默认值 |
| ---------- | ------- | ------------------------------- | ------------------------------------------------- | ------ |
| itemStyle  | `false` | 自定义单个单选框样式            | `ViewStyle`                                       |        |
| labelStyle | `false` | 自定义文本样式                  | `TextStyle`                                       |        |
| size       | `false` | 图标大小                        | `number`                                          |        |
| label      | `true`  | 单选框文本                      | `ReactNode`                                       |        |
| value      | `true`  | 单选框的值                      | `ReactText`                                       |        |
| status     | `true`  | 单选框选中状态                  | `'checked' \| 'unchecked' \| 'halfchecked'`       |        |
| disabled   | `true`  | 单选框禁用状态                  | `boolean`                                         |        |
| mode       | `false` | 单选框模式，list 表示以列表展示 | `'list' \| 'row'`                                 |        |
| onChange   | `false` | 选中单选框触发的回调函数        | `(value: ReactText, status: RadioStatus) => void` |        |