Components/Form components

EInputTag Input tag

import EUI 1.0

Examples

Input tag

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 EInputTag { max: 5 delimiter: "," clearable: true draggable: true value: ["Qt", "QML", "Desktop"] prefixComponent: Component { EIcon { iconSize: 16 iconSource: EIcons.TAG } } } }

Preview

Run the code to try the component

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

Code runs in this browser Licenses

Tag input

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EInputTag { max: 5 width: 520 value: exampleData.models.InitialTags }

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

clearablebool

Show a clear action; ratings may be cleared by clicking the current score again.

Defaultfalse

closablebool

Show a close or remove button.

Defaulttrue

collapseTagsbool

Collapse excess selected tags.

Defaultfalse

delimiterstring

Delimiter splitting input into multiple tags.

Default""

draggablebool

Enable dragging of the object defined by the current component.

Defaulttrue

enabledbool

Allow interaction; false disables the control.

Defaulttrue

heightreal

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

DefaultimplicitHeight

maxint

Maximum tag count.

0: unlimited
Positive number: limit

Default0

maxCollapseTagsint

Maximum directly visible tags when collapsing.

Default1

placeholderTextstring

Placeholder shown when the value is empty.

Default""

prefixComponentComponent

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

Defaultnull

sizeint

Control size; inherits the nearest EConfigProvider by default.

EStyle.Small
EStyle.Medium
EStyle.Large

DefaultInherited; EStyle.Medium by default

suffixComponentComponent

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

Defaultnull

tagDelegateComponent

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

Defaultnull

triggerint

Keyboard key that submits a new tag.

Qt.Key_*
e.g. Qt.Key_Return
Qt.Key_Enter / Qt.Key_Space

DefaultQt.Key_Return

validateEventbool

Request enclosing-form validation when the value changes.

Defaulttrue

validationMessagestring

Validation message or externally supplied error text.

Default""

validationStateint

Input validation state.

EValidationState.None
EValidationState.Success
EValidationState.Warning
EValidationState.Error

DefaultEValidationState.None

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

rowHeightintRead only

Menu item, data row or header row height in pixels.

DefaultComputed at runtime

Signals

SignaturePurpose

cleared()

Emitted after the contents are cleared with the clear action.

added(string tag)

Emitted after adding a tag; tag is its text.

removed(string tag)

Emitted after removing a tag; tag is its text.

reordered(int from, int to)

Emitted after reordering tags; from and to are the old and new indices.

Methods

SignaturePurpose

clear()

Clear the current contents or selection.

addTag(text)

Add a tag containing text; duplicates and invalid values are not added.

removeTag(index)

Remove the tag at index.

moveTag(from, to)

Move a tag from index from to index to; indices are zero-based.