--- nav: path: /components group: title: 信息输入 order: 10 toc: 'content' --- # Checklist 可勾选列表 列表的勾选操作。 ## 何时使用 - 在一组列表项中选择一个或多个。 - 可勾选列表的使用需要默认至少勾选一项,方便用户了解列表是可以勾选的。 ## 代码示例 ## API | 属性 | 说明 | 类型 | 默认值 | | ---------- | ---------------------------------------------------------------- | --------------------------- | ------ | | className | 类名 | string | - | | content | CheckListItem 自定义内容区作用域插槽,接收 item 参数 | slot | - | | defaultValue | 默认选中数据 | string \| number \| (string \| number)[] | - | | icon | 自定义选中 Icon 插槽 | slot | - | | multiple | 是否支持多选 | boolean | false | | options | 配置每一列的选项 | [ChecklistItem](#checklistitem)[] | [] | | style | 样式 | string | - | | value | 选中数据 | string \| number \| (string \| number)[] | - | | onChange | 选中项发生变化时,触发回调 | (value: string \| number \| (string \| number)[], column: [ChecklistItem](#checklistitem) \| [ChecklistItem](#checklistitem)[], event: [Event](https://opendocs.alipay.com/mini/framework/event-object)) => void | ### ChecklistItem | 参数 | 说明 | 类型 | 默认值 | | ----------- | -------- | ------- | ------ | | description | 描述 | string | - | | disabled | 是否禁用 | boolean | false | | image | 图片 | string | - | | readonly | 是否只读 | boolean | false | | title | 标题 | string | - | | value | 值 | string | - |