Skip to content

Checkbox 复选

基础用法

  • 分为三个组件:sn-checkbox-group , sn-chekbox , sn-checkbox-tag
  • 每一个选项(sn-checkboxsn-checkbox-tag)必须是sn-checkbox-group的子代。
vue
<template>
	<sn-checkbox-group>
    	<sn-checkbox text="苹果"></sn-checkbox>
  		<sn-checkbox text="香蕉"></sn-checkbox>
  		<sn-checkbox text="菠萝"></sn-checkbox>
	</sn-checkbox-group>
</template>

更多演示请下载 demo 查看

属性

sn-checkbox

参数说明类型默认值可选值
textbox复选组件右侧文本内容String--
iconbox复选组件左侧方框内的图标String--
disabled是否禁用Booleanfalsetrue | false
customContainStyle自定义box复选组件容器样式(仅针对单组件生效)UTSJSONObject{}-
customStyle自定义box复选组件样式(仅针对单组件生效)UTSJSONObject{}-

sn-checkbox-tag

参数说明类型默认值可选值
texttag复选组件内部文本内容String--
typetag复选组件主题样式类型Stringprimaryinfo |primary |success |error |warning
leveltag复选组件等级Stringsecondfirst |second |third |least
disabled是否禁用Booleanfalsetrue | false
customStyle自定义tag复选组件样式(仅针对单组件生效)UTSJSONObject{}-

sn-checkbox-group

参数说明类型默认值可选值
vModel当前选中项的索引数组Array<Number>[]-
vertical是否纵向排列Booleanfalsetrue | false
boxSizebox复选组件左侧方框边长String$3+6-
boxBorderRadiusbox复选组件左侧方框的圆角大小String5px-
boxBorderWidthbox复选组件左侧方框的边框宽度String2px-
boxTextSizebox复选组件右侧文本大小String$3-
boxTextColorbox复选组件右侧文本颜色String$text-
disabledBoxTextColor禁用状态下box复选组件右侧文本颜色String$disabledText-
boxIconbox复选组件左侧方框内的图标Stringcheck-fill-
boxIconSizebox复选组件左侧方框内的图标大小String$3-
boxIconColorbox复选组件左侧方框内的图标颜色String#fff-
disabledBoxIconColor禁用状态下box复选组件左侧方框内的图标颜色String#fff-
boxBorderColorbox复选组件左侧方框的边框颜色String$line-
disabledBoxBorderColor禁用状态下box复选组件左侧方框的边框颜色String$disabled-
boxActiveBorderColorbox复选组件选中时左侧方框的边框颜色String$primary-
disabledBoxActiveBorderColor禁用状态下box复选组件选中时左侧方框的边框颜色String$disabledText-
boxBgColorbox复选组件左侧方框的背景颜色String$transparent-
disabledBoxBgColor禁用状态下box复选组件左侧方框的背景颜色String$disabled-
boxActiveBgColorbox复选组件选中时左侧方框的背景颜色String$primary-
disabledBoxActiveBgColorbox复选组件选中时左侧方框的背景颜色String$disabledText-
tagTypetag复选组件的主题类型(下列自定义颜色默认为空,主题默认颜色与自定义颜色冲突时,以自定义颜色为主)Stringprimaryinfo |primary |success |error |warning
tagleveltag复选组件的等级(下列自定义颜色默认为空,主题默认颜色与自定义颜色冲突时,以自定义颜色为主)Stringsecondfirst |second |third |least
tagBgColortag复选组件未选中时背景颜色String--
disabledTagBgColor禁用状态下tag复选组件未选中时背景颜色String--
tagActiveBgColortag复选组件选中时背景颜色String--
disabledTagActiveBgColor禁用状态下tag复选组件选中时背景颜色String--
tagTextColortag复选组件未选中时内部文本颜色String--
disabledTagTextColor禁用状态下tag复选组件未选中时内部文本颜色String--
tagActiveTextColortag复选组件选中时内部文本颜色String--
disabledTagActiveTextColor禁用状态下tag复选组件选中时内部文本颜色String--
tagTextSizetag复选组件内部文本大小String--
tagBorderRadiustag复选组件圆角大小String10px-
tagPaddingtag复选组件内边距String5px 8px
customBoxContainStyle自定义box复选组件容器样式UTSJSONObject{}-
customBoxStyle自定义box复选组件左侧方框样式UTSJSONObject{}-
customBoxIconStyle自定义box复选组件左侧方框内部图标样式UTSJSONObject{}-
customTagStyle自定义tag复选组件样式UTSJSONObject{}-
customTextStyle自定义复选组件文本样式UTSJSONObject{}-

事件

sn-checkbox-group

事件名类型说明
change(value: number[])=>void当前选中项变化时触发

插槽

sn-checkbox

名称说明
default替换box复选组件内部文本,可以是任意内容

sn-checkbox-group

名称说明
default这里放置子组件 sn-checkboxsn-checkbox-tag

使用 MIT 协议