Checkbox 复选框

复选框,可设置其状态、传入特殊 class 以及复选框图标位置。

示例

基本用法

  1. <cube-checkbox v-model="checked">
  2. Checkbox
  3. </cube-checkbox>

如果选中了,则 checked 的值就为 true。

复选框图标样式

  1. <cube-checkbox v-model="checked" position="right" shape="square" :hollow-style="true">
  2. Styled Checkbox
  3. </cube-checkbox>

设置 position 为 ‘right’ 则复选框图标位置在右边,且可以通过 shape 配置图标形状以及设置 hollow-style 为 true 代表显示的是镂空样式的(即使 shape 不是 square 表现的也是方形的)。

改变 model 的值

  1. <cube-checkbox v-model="checked" :option="option">
  1. export default {
  2. data() {
  3. return {
  4. checked: false,
  5. option: {
  6. label: 'Option Checkbox',
  7. value: 'optionValue',
  8. disabled: false
  9. }
  10. }
  11. }
  12. }

设置 option,当复选框选中的时候,checked 的值就是 'optionValue',当未选中的时候,checked 的值就是 false;所以其实在单个复选框的场景下,最好不要设置 option

禁用状态

  1. <cube-checkbox v-model="checked" :option="{disabled: true}">
  2. Disabled Checkbox
  3. </cube-checkbox>

Props 配置

参数 说明 类型 可选值 默认值
option 配置项 Boolean/String/Object - -
position 位置 String left/right left
shape 图标形状 String circle/square circle
hollowStyle 是否是镂空样式的 Boolean true/false false
  • option 子配置项
参数 说明 类型
label 复选框显示文字 String
value 复选框的值 String/Number
disabled 复选框是否被禁用 Boolean

原文:

https://didi.github.io/cube-ui/#/zh-CN/docs/checkbox