Components/Navigation

ESteps Steps

import EUI 1.0

Examples

Steps

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ESteps { active: 1 model: ["Create", "Configuration", "Done"] }

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

activeint

Current step index, starting at 0.

Default0

alignCenterbool

Center the layout or text.

Defaultfalse

clickablebool

Allow clicking step items.

Defaultfalse

directionint

Component layout direction.

EOrientation.Horizontal
EOrientation.Vertical

DefaultEOrientation.Horizontal

enabledbool

Allow interaction; false disables the control.

Defaulttrue

finishStatusstring

State used for completed steps.

"finish" / "process"
"success" / "error"
"wait"

Default"finish"

heightreal

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

DefaultimplicitHeight

modelvar

Component data source; item structure follows the current example and component contract.

Default[]

processStatusstring

State used for the current step.

"finish" / "process"
"success" / "error"
"wait"

Default"process"

simplebool

Use simplified step styling.

Defaultfalse

spacevar

Step spacing; 0 distributes items according to available width.

0: automatic
Pixel number / percentage string

Default0

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

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

DefaultimplicitWidth

countintRead only

Skeleton instance count or current item count, depending on the component.

DefaultComputed at runtime

itemsvarRead only

Normalized or transformed item list.

DefaultComputed at runtime

relativeSpaceboolRead only

Resolved spacing between step items.

DefaultComputed at runtime

resolvedSpacerealRead only

Resolved spacing between step items.

DefaultComputed at runtime

stepHeightrealRead only

Resolved height or width of step items.

DefaultComputed at runtime

stepWidthrealRead only

Resolved height or width of step items.

DefaultComputed at runtime

verticalboolRead only

Whether the resolved layout is horizontal or vertical.

DefaultComputed at runtime

Signals

SignaturePurpose

changed(int active)

Emitted when the current step changes; active is its index.

stepClicked(int index, var item)

Emitted when a step is clicked; index is its index and item is its data.

Methods

SignaturePurpose

advance()

Advance to the next step.

select(index)

Select the item identified by the given index or key.