Justineo 32632e796e docs: update docs

Change-Id: I76d0f72679cd75085f5ffd42f641daa198cafe11

docs: update docs for alert/autocomplete/carousel, etc.

Change-Id: Ib7507f4979024f53c127e4b64b88560b93999db7

fix: update for autocomplete filter

Change-Id: Ie54556715fa52838aeb6caaa19b4f9a9f14b490f

docs: add docs for calendar/transfer/cascader

Change-Id: I655b3cb3d25dd0649de9ae7e224e7063a40dd079

fix: add more demos for input/textarea

Change-Id: Iada527ca82643a435a4775110b332155512d62a7

docs: add docs for uploader,select,table, etc.

Change-Id: Ib034fd5cc9d9a420d4e002956ae925175783c5f3

docs: adjust formatting and punc.

docs: adjust docs for uploader, etc.

Change-Id: If06c8c1102eafce43f5802a333676fc9e62cd474

docs: add docs for nav

Change-Id: If56a653ec53f19239606128fd30cae80f8e10025

docs: improve anchor demos

Change-Id: I6ac1c08cc8905924d0062def1f8921fe1f302f15

docs: refine wording and format

docs: update docs for check-button-group desc

Change-Id: Ica7d6d0692250f0be6bd330b1ad4cc41938afd46

2021-10-25 20:10:29 +08:00

2.9 KiB

Raw Blame History

CheckButtonGroup 复选按钮组

示例

尺寸

可选的 ui 属性值：s / m。

简单样式

设置 ui 属性值：simple 来指定简单样式。

单复选共存

可以使用 exclusive 选项与 empty-value 实现一些单复选共存的场景。

额外描述

在数据源的项目中设置 desc 字段或者通过 desc 插槽来指定额外描述。额外描述会在悬浮时显示。

最小宽度

通过设置 ui 属性值 stable 来开启项目的最小宽度。

API

属性

名称	类型	默认值	描述
`ui`	`string=`	-	[^ui]
`items`	`Array<Object>`	`[]`	[^items]
`value`	`Array`	`[]`	[^value]
`disabled`	`boolean=`	`false`	是否为禁用状态。
`readonly`	`boolean=`	`false`	是否为只读状态。
`empty-value`	`*`	-	当取消所有选择时组件需要默认选中的值，通常用于存在 `exclusive` 选项的场景。

^^^ui 预设样式。

+++枚举值

值	描述
`s`	小尺寸样式。
`m`	中尺寸样式。
^^^

^^^items 复选按钮组数据源，项目类型为 { label, value, disabled, exclusive, desc, ... }。

+++字段详情

名称	类型	描述
`label`	`string`	选项的文字说明。
`value`	`*`	选项对应的值。
`disabled`	`boolean=`	选项是否为禁用。
`exclusive`	`boolean=`	选项是否为排它项。当选项为排它项时，选中该项将取消选中其它所有选项。
`desc`	`string`	选项的额外描述信息。
+++
^^^

^^^value :::badges v-model :::

items 中已选项的 value 列表。 ^^^

插槽

名称	描述
`item`	[^slot-item]
`desc`	按钮的额外描述信息，作用域参数同 `item` 插槽。

^^^slot-item 按钮内文本区域。

默认内容：label 属性值。

+++作用域参数

名称	类型	描述
`label`	`string`	选项文本。
`value`	`*`	选项值。
`index`	`number`	选项在 `items` 中的序号。
`disabled`	`boolean=`	选项是否禁用。
+++

另外，items 内数据项中除了上面描述的字段之外的其它字段也会自动通过 v-bind 进行绑定到作用域参数上。 ^^^

事件

名称	描述
`change`	[^event-change]

^^^event-change :::badges v-model :::

选中状态变化后触发，回调参数为 (value: Array)。value 为当前按钮组已选项内 value 字段组成的数组。 ^^^

图标

名称	描述
`check`	已选标志。

2.9 KiB Raw Blame History