组件/EUI 扩展

ECheckBoxGroup 多选框组

import EUI 1.0

示例与代码

多选框组

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { width: Math.min(640, parent.width) spacing: 16 ECheckBoxGroup { max: 2 min: 1 value: [1] buttonStyle: true props: ({value: "id", label: "name", disabled: "locked"}) options: [{id: 1, name: qsTr("桌面端")}, {id: 2, name: qsTr("网页端")}, {id: 3, name: qsTr("移动端"), locked: true}] } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

最多选择两个

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ECheckBoxGroup { max: 2 options: exampleData.models.Languages value: exampleData.models.InitialCheckedTags }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

buttonStylebool

使用按钮式选项外观。

默认值false

enabledbool

是否允许交互；false 时控件禁用。

默认值true

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

maxint

最多选中的选项数量。

0：不限制
正数：限制值

默认值0

minint

至少选中的选项数量。

默认值0

optionDelegateComponent

自定义选项的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。

默认值null

optionsvar

选项数组；props 可映射字段。

字符串，或对象字段：
label、value、disabled

默认值[]

propsvar

数据字段名称映射。

label、value、disabled

默认值({value: "value", label: "label", disabled: "disabled"})

sizeint

控件尺寸；默认继承最近的 EConfigProvider。

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider，默认 EStyle.Medium

validateEventbool

值变化时是否向所属表单派发校验请求。

默认值true

valuevar

当前值；通过属性绑定读写，数组形式用于多选或范围选择。

默认值[]

visiblebool

是否显示组件。

默认值true

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

effectiveOptionsvar只读

经过字段映射后的选项列表。

默认值由运行时计算

信号

签名作用

changed(var value)

所选值变化时触发，value 为新的值。

方法

签名作用

toggle(key, selected)

切换当前展开或选中状态；需要标识时传入目标项的标识。