Components/EUI extensions

ECheckBoxGroup Checkbox group

import EUI 1.0

Examples

Checkbox group

QML sourceQML

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("Desktop")}, {id: 2, name: qsTr("Web")}, {id: 3, name: qsTr("Mobile"), locked: true}] } }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Select up to two

QML sourceQML

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 }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Properties

PropertyDescriptionValues and default

buttonStylebool

Use button-style options.

Defaultfalse

enabledbool

Allow interaction; false disables the control.

Defaulttrue

heightreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitHeight

maxint

Maximum selected options.

0: unlimited
Positive number: limit

Default0

minint

Minimum number of selected options.

Default0

optionDelegateComponent

Component slot for custom option; null uses the default content. See this page’s examples for delegate context.

Defaultnull

optionsvar

Option array; props maps custom field names.

Strings, or object fields:
label, value, disabled

Default[]

propsvar

Mapping of data field names.

label, value, disabled

Default({value: "value", label: "label", disabled: "disabled"})

sizeint

Control size; inherits the nearest EConfigProvider by default.

EStyle.Small
EStyle.Medium
EStyle.Large

DefaultInherited; EStyle.Medium by default

validateEventbool

Request enclosing-form validation when the value changes.

Defaulttrue

valuevar

Current value; read or write through property bindings, with arrays for multiple or range selection.

Default[]

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitWidth

effectiveOptionsvarRead only

Options after field mapping.

DefaultComputed at runtime

Signals

SignaturePurpose

changed(var value)

Emitted when the selection changes; value is the new value.

Methods

SignaturePurpose

toggle(key, selected)

Toggle the expanded or selected state; pass the target identifier when required.