组件/数据展示

ESegmented 分段控制

import EUI 1.0

示例与代码

值绑定、禁用选项和键盘导航

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { spacing: 12 width: parent.width ESegmented { id: segmented width: 360 block: true value: "day" model: [{ label: qsTr("日"), value: "day" }, { label: qsTr("周"), value: "week" }, { label: qsTr("月"), value: "month" }, { label: qsTr("年"), value: "year", disabled: true }] } EText { text: qsTr("当前值：") + segmented.currentValue } }

效果

运行代码，体验组件交互

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

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

分段控制

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ESegmented { model: [qsTr("日"), qsTr("周"), qsTr("月")] onSelected: function(value, index) { console.log(value) } }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

blockbool

让分段控件占满可用宽度。

默认值false

currentIndexint

当前选中或显示项的索引。

-1：未选择
0 起：条目索引

默认值0

directionstring

组件的排列方向。

"horizontal" / "vertical"

默认值"horizontal"

enabledbool

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

默认值true

heightreal

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

默认值implicitHeight

modelvar

文字、数值或选项对象组成的数组。

字段：
label, value, disabled

默认值[]

optionDelegateComponent

自定义选项的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。

默认值null

propsvar

数据字段映射及节点行为配置对象。

字段：
label, value, disabled

默认值({})

sizeint

控件尺寸；默认继承最近的 EConfigProvider。

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider，默认 EStyle.Medium

validateEventbool

值变化时是否向所属表单派发校验请求。

默认值true

valuevar

当前值；通过属性绑定读写，数组形式用于多选或范围选择。

默认值undefined

visiblebool

是否显示组件。

默认值true

widthreal

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

默认值implicitWidth

currentItemvar只读

当前分段选项对应的数据对象。

默认值由运行时计算

currentValuevar只读

当前选项对应的实际值。

默认值由运行时计算

信号

签名作用

selected(var value, int index)

选择分段项时触发，value 为选中值，index 为选项索引。

方法

签名作用

selectValue(key)

按 value 值选择选项。

select(index)

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