HuajisheTools/HuajisheCheckChaoXing/miniprogram_npm/tdesign-miniprogram/checkbox/README.en-US.md

:: BASE_DOC ::

API

Checkbox Props

name	type	default	description	required
style	Object	-	CSS(Cascading Style Sheets)	N
custom-style	Object	-	CSS(Cascading Style Sheets)，used to set style on virtual component	N
block	Boolean	true	-	N
borderless	Boolean	false	-	N
check-all	Boolean	false	-	N
checked	Boolean	false	-	N
default-checked	Boolean	undefined	uncontrolled property	N
content	String / Slot	-	see more ts definition	N
content-disabled	Boolean	-	-	N
disabled	Boolean	undefined	-	N
icon	String / Array	'circle'	Typescript：'circle' | 'line' | 'rectangle' | string[]	N
indeterminate	Boolean	false	-	N
label	String / Slot	-	see more ts definition	N
max-content-row	Number	5	-	N
max-label-row	Number	3	-	N
name	String	-	-	N
placement	String	left	options: left/right	N
readonly	Boolean	false	-	N
value	String / Number / Boolean	-	value of checkbox。Typescript：string | number | boolean	N

Checkbox Events

name	params	description
change	(checked: boolean, context: { value: boolean|number|string, label: boolean|number|string })	-

Checkbox External Classes

className	Description
t-class	-
t-class-border	-
t-class-content	-
t-class-icon	-
t-class-label	-

CheckboxGroup Props

name	type	default	description	required
style	Object	-	CSS(Cascading Style Sheets)	N
custom-style	Object	-	CSS(Cascading Style Sheets)，used to set style on virtual component	N
borderless	Boolean	false	-	N
disabled	Boolean	undefined	-	N
keys	Object	-	Typescript：KeysType。see more ts definition	N
max	Number	undefined	-	N
name	String	-	-	N
options	Array	[]	Typescript：Array<CheckboxOption> type CheckboxOption = string | number | CheckboxOptionObj interface CheckboxOptionObj { label?: string; value?: string | number; disabled?: boolean; checkAll?: true }。see more ts definition	N
value	Array	[]	Typescript：T type CheckboxGroupValue = Array<string | number | boolean>。see more ts definition	N
default-value	Array	undefined	uncontrolled property。Typescript：T type CheckboxGroupValue = Array<string | number | boolean>。see more ts definition	N

CheckboxGroup Events

name	params	description
change	(value: CheckboxGroupValue, context: { value: boolean|number|string, label: boolean|number|string })	-

CSS Variables

The component provides the following CSS variables, which can be used to customize styles.

Name	Default Value	Description
--td-checkbox-bg-color	@bg-color-container	-
--td-checkbox-border-color	@component-stroke	-
--td-checkbox-description-color	@text-color-secondary	-
--td-checkbox-description-disabled-color	@text-color-disabled	-
--td-checkbox-description-line-height	44rpx	-
--td-checkbox-font-size	32rpx	-
--td-checkbox-icon-checked-color	@brand-color	-
--td-checkbox-icon-color	@component-border	-
--td-checkbox-icon-disabled-bg-color	@bg-color-component-disabled	-
--td-checkbox-icon-disabled-color	@brand-color-disabled	-
--td-checkbox-icon-size	48rpx	-
--td-checkbox-tag-active-bg-color	@brand-color-light	-
--td-checkbox-tag-active-color	@brand-color	-
--td-checkbox-title-color	@text-color-primary	-
--td-checkbox-title-disabled-color	@text-color-disabled	-
--td-checkbox-title-line-height	48rpx	-
--td-checkbox-vertical-padding	32rpx	-