复选框组件 Checkbox-Group
复选框 Checkbox
单选项目,与原生组件
Checkbox
用法类似,内部可传入slot。与Checkbox-Group
搭配使用。
单项选择器内部由多个l-checkbox
组成,linchange
事件能监听到选中项的变化。
current: ['中国', '美国'],
items: [
{ value: '美国' },
{ value: '中国' },
{ value: '巴西' },
{ value: '日本' },
{ value: '英国' },
{ value: '法国' },
}
单个Checkbox布局方式
根据具体需求,选择最佳的标签对齐方式(选中图标和内容部分)。
placement
默认值是 left
,即Checkbox的选中图标居左显示。值为 right
时,图标居右显示。
多个Checkbox布局方式
placement
默认值是 column
,可选项为 row/column
。
示例代码
当我们需要将某一个Checkbox
设置为当前选中项时,需要将当前checkbox
的value
值添加到 Checkbox-Group
的属性当中,current
接收一个数组。
注意事项
Checkbox-Group
的current
属性的类型是数组。
<l-checkbox-group current="['中国']" bind:linchange="onChangeTap" >
<l-checkbox value="中国" />
<l-checkbox value="美国" />
</l-checkbox-group>
设置选中项的颜色
示例代码
设置禁用
当我们需要将某一个选项禁用时,设置 disabled
为 true
即可。
<l-checkbox value="中国" disabled="{{true}}" />
通过 <slot>
的方式可以自定义Checkbox
组件的右边部分,在此之前需要将custom
设置为true
示例代码
注意事项
插入slot的时候,也需要设置value,这个value不会显示,但是会在你更改选中项的时候,用过linchange事件返回。用来通知开发者当前选中的是什么。