Checkbox 多选
示例
import {
Header, ScrollView, TopView, Form, FormItem, Card,
Divider, DividerGroup,
Checkbox, CheckboxGroup,
Button
} from '@/duxuiExample'
const UserButton = ({
label,
checked,
onCheck
}) => {
return <Button onClick={onCheck} type='primary' plain={!checked}>{label}</Button>
}
export default function CheckboxExample() {
return <TopView>
<Header title='Checkbox' />
<Form onSubmit={console.log}>
<ScrollView>
<Card margin verticalPadding={false}>
<DividerGroup>
<FormItem label='多选' field='checkbox1'>
<CheckboxGroup>
<Checkbox label='选项1' value={1} />
<Checkbox label='选项2' value={2} />
<Checkbox label='选项3' value={3} />
<Checkbox label='选项4' value={4} />
</CheckboxGroup>
</FormItem>
<FormItem label='竖向排列' field='checkbox2'>
<CheckboxGroup direction='vertical'>
<Checkbox label='选项1' value={1} />
<Checkbox label='选项2' value={2} />
<Checkbox label='选项3' value={3} />
<Checkbox label='选项4' value={4} />
</CheckboxGroup>
</FormItem>
<FormItem label='自定义样式' field='checkbox3'>
<CheckboxGroup>
<Checkbox label='选项1' value={1} >{UserButton}</Checkbox>
<Checkbox label='选项2' value={2} >{UserButton}</Checkbox>
<Checkbox label='选项3' value={3} >{UserButton}</Checkbox>
<Checkbox label='选项4' value={4} >{UserButton}</Checkbox>
</CheckboxGroup>
</FormItem>
<FormItem label='自定义控制' field='checkbox4'>
<Checkbox label='选中' checked />
<Checkbox label='部分选中' half />
<Checkbox label='未选中' />
</FormItem>
</DividerGroup>
</Card>
</ScrollView>
</Form>
</TopView>
}
Props
继承自SpaceProps
value
选中值
类型 | 必填 | 默认值 |
---|---|---|
any[] | 是 |
defaultValue
默认值
类型 | 必填 | 默认值 |
---|---|---|
any[] | 是 |
label
当前选项的标签文字
类型 | 必填 | 默认值 |
---|---|---|
any[] | 否 |
checked
如果单独使用 Checkbox 可以用这个属性控制是否选中
类型 | 必填 | 默认值 |
---|---|---|
boolean | 否 | false |
half
半选中状态,checked为false的时候生效
类型 | 必填 | 默认值 |
---|---|---|
boolean | 否 | false |
disabled
是否禁用这个选项
类型 | 必填 | 默认值 |
---|---|---|
boolean | 否 | false |
CheckboxGroup Props
将Checkbox选项放在 CheckboxGroup
中,将他们组成一个表单项
继承自SpaceProps
value
当前选中的值
类型 | 必填 | 默认值 |
---|---|---|
any | 否 |
onChange
值改变时的回调函数
类型 | 必填 | 默认值 |
---|---|---|
(value: any) => void | 否 |
vertical
是否垂直布局
类型 | 必填 | 默认值 |
---|---|---|
boolean | 否 | false |
virtual
虚拟节点,为true时,这个组件不会创建任何实体节点,可以更有效的进行布局
类型 | 必填 | 默认值 |
---|---|---|
boolean | 否 | false |
disabled
禁用选择
类型 | 必填 | 默认值 |
---|---|---|
boolean | 否 | false |