组件/导航组件

ESteps 步骤条

import EUI 1.0

示例与代码

步骤条

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ESteps { active: 1 model: ["创建", "配置", "完成"] }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

activeint

当前步骤的索引，从 0 开始。

默认值0

alignCenterbool

是否采用居中布局或居中文字。

默认值false

clickablebool

是否允许点击步骤项。

默认值false

directionint

组件的排列方向。

EOrientation.Horizontal
EOrientation.Vertical

默认值EOrientation.Horizontal

enabledbool

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

默认值true

finishStatusstring

已完成步骤使用的状态。

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

默认值"finish"

heightreal

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

默认值implicitHeight

modelvar

组件的数据源；数组项结构以当前示例及组件说明为准。

默认值[]

processStatusstring

当前步骤使用的状态。

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

默认值"process"

simplebool

使用简洁步骤样式。

默认值false

spacevar

步骤项间距；0 表示根据可用宽度分配。

0：自动分配
像素数值 / 百分比字符串

默认值0

visiblebool

是否显示组件。

默认值true

widthreal

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

默认值implicitWidth

countint只读

骨架实例数量或当前项目数量，具体含义由组件决定。

默认值由运行时计算

itemsvar只读

经过规范化或转换的项目列表。

默认值由运行时计算

relativeSpacebool只读

步骤项计算出的实际间距。

默认值由运行时计算

resolvedSpacereal只读

步骤项计算出的实际间距。

默认值由运行时计算

stepHeightreal只读

步骤项计算后的实际高度或宽度。

默认值由运行时计算

stepWidthreal只读

步骤项计算后的实际高度或宽度。

默认值由运行时计算

verticalbool只读

实际布局是否采用水平或垂直方向。

默认值由运行时计算

信号

签名作用

changed(int active)

当前步骤变化时触发，active 为当前步骤索引。

stepClicked(int index, var item)

点击步骤时触发，index 为步骤索引，item 为步骤数据。

方法

签名作用

advance()

进入下一步骤。

select(index)

选择给定索引或标识对应的项目。