Components/Form components

ESwitch Switch

import EUI 1.0

Examples

Switch

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 ESwitch { value: "off" activeValue: "on" inactiveValue: "off" activeColor: "#67c23a" activeIcon: EIcons.CHECK inactiveColor: "#909399" inactiveIcon: EIcons.XMARK activeText: qsTr("Enabled") inactiveText: qsTr("Disabled") beforeChange: function() { return Promise.resolve(true) } } }

Preview

Run the code to try the component

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

Code runs in this browser Licenses

Switch

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { spacing: 16 width: parent.width ESwitch { text: qsTr("Default") } ESwitch { checked: true text: qsTr("Enabled") } }

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

accessibleNamestring

Name read by assistive technologies; provide a readable name for controls without text.

Defaulttext

activeColorcolor

Active or selected color.

DefaultDynamic binding

activeIconint

Icon used by the component.

EIcons.*
0 (no icon)

Default0

activeTextstring

Text for the active or inactive state.

Default""

activeValuevar

Value associated with checked or active state.

Defaulttrue

beforeChangevar

Guard before changing switch state, returning a boolean or Promise.

Defaultnull

checkedbool

Whether the control is checked or active.

Defaultfalse

durationint

Animation or display duration in milliseconds; the component binding identifies its use.

Default300

enabledbool

Allow interaction; false disables the control.

Defaulttrue

fontfont

Font settings for the family, size and text style.

Common fields:
family, pixelSize, pointSize
bold, italic, weight
underline, strikeout
letterSpacing, wordSpacing

Defaultapplication font

heightreal

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

DefaultimplicitHeight

inactiveColorcolor

Inactive color.

DefaultDynamic binding

inactiveIconint

Icon used by the component.

EIcons.*
0 (no icon)

Default0

inactiveTextstring

Text for the active or inactive state.

Default""

inactiveValuevar

Value associated with unchecked or inactive state.

Defaultfalse

loadingbool

Whether the component is loading.

Defaultfalse

sizeint

Control size; inherits the nearest EConfigProvider by default.

EStyle.Small
EStyle.Medium
EStyle.Large

DefaultInherited; EStyle.Medium by default

textstring

Displayed text.

Defaultchecked ? activeText : inactiveText

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.

Defaultundefined

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

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

DefaultimplicitWidth

Signals

SignaturePurpose

changeRejected(string message)

Emitted when a state change is rejected; message explains why.