组件/表单组件

ETimeSelect 时间下拉

import EUI 1.0

示例与代码

固定间隔、格式和结束时间

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { width: Math.min(760, parent.width) height: 640 Column { width: parent.width - 48 spacing: 16 anchors.centerIn: parent ETimeSelect { id: webDatesTimeSelect editable: true start: "09:00" end: "18:10" step: "00:30" format: "hh:mm A" includeEndTime: true width: Math.min(260, parent.width) objectName: "webDatesTimeSelect" } EText { width: parent.width wrapMode: Text.WordWrap text: qsTr("当前时间：") + String(webDatesTimeSelect.value || "") } } }

效果

运行代码，体验组件交互

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

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

半小时一个时段

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ETimeSelect { step: 30 end: "18:00" start: "09:00" }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

allowCreatebool

允许把没有匹配结果的输入创建为新选项。

默认值false

clearablebool

显示清除操作；评分中允许再次点击当前分数清零。

默认值false

collapseTagsbool

折叠过多的已选标签。

默认值false

currentIndexint

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

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

默认值-1

debounceint

等待、节流或自动关闭时间，单位为毫秒；0 表示不延迟或不启用定时关闭。

默认值300

editablebool

允许编辑输入或同时开启标签页新增和关闭操作。

默认值false

emptyValuesvar

判定为空值的数组；默认包含 undefined、null 和空字符串。

默认值继承 Provider，默认 [undefined, null, ""]

enabledbool

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

默认值true

endstring

时间下拉的开始和结束时刻，格式 HH:mm。

默认值EValueUtils.formatTime(18, 30, 0, false)

filterMethodvar

自定义过滤函数；参数和返回值遵循当前组件的过滤调用。

默认值null

filterablebool

是否允许输入关键词过滤。

默认值false

formatstring

显示格式；日期时间使用格式串，进度可使用函数，倒计时使用时间占位符。

默认值"HH:mm"

heightreal

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

默认值implicitHeight

includeEndTimebool

时间步进不能整除范围时仍包含结束时刻。

默认值false

indentRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值""

loadingbool

是否处于加载状态。

默认值false

loadingTextstring

加载状态提示文字。

默认值随当前语言变化

maxCollapseTagsint

折叠标签时直接显示的最大数量。

默认值1

maxTimestring

可选时间上下限，采用 HH:mm 或 HH:mm:ss；空字符串不限制。

默认值""

minTimestring

可选时间上下限，采用 HH:mm 或 HH:mm:ss；空字符串不限制。

默认值""

modelvar

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

默认值formattedOptions()

multiplebool

是否允许多选。

默认值false

multipleLimitint

多选数量上限。

0：不限制
正数：限制值

默认值0

noDataTextstring

没有数据时的提示文字。

默认值随当前语言变化

noMatchTextstring

过滤后没有匹配项时的提示文字。

默认值随当前语言变化

optionDelegateComponent

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

默认值null

placeholderTextstring

空值时显示的占位文字。

默认值随当前语言变化

popupFooterComponent

自定义侧栏底部或弹层头尾的 Component 插槽。 委托上下文见本页示例。

默认值null

popupHeaderComponent

自定义侧栏底部或弹层头尾的 Component 插槽。 委托上下文见本页示例。

默认值null

prefixIconint

组件使用的图标。

EIcons.*
0（无图标）

默认值EIcons.CLOCK

querystring

当前过滤或搜索关键词。

默认值""

remotebool

使用远程搜索，跳过本地过滤。

默认值false

remoteMethodvar

远程查询函数，接收关键词并返回选项数组或 Promise。

默认值null

reserveKeywordbool

选择选项后保留输入关键词。

默认值true

sizeint

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

EStyle.Small
EStyle.Medium
EStyle.Large

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

startstring

时间下拉的开始和结束时刻，格式 HH:mm。

默认值EValueUtils.formatTime(8, 30, 0, false)

stepvar

增量步长；滑块可覆盖 stepSize，时间下拉使用分钟数或 HH:mm。

分钟数值 / "HH:mm"

默认值30

tagDelegateComponent

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

默认值null

textRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值"label"

validateEventbool

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

默认值true

validationMessagestring

校验结果说明或外部错误文字。

默认值""

validationStateint

输入校验状态。

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

默认值EValidationState.None

valuevar

选中的时间字符串；TimePicker 范围模式为起止数组，格式由 valueFormat 决定。

默认值undefined

valueKeystring

选项取值字段或对象值的唯一标识字段。

默认值"value"

valueOnClearvar

清除后的值，也可传函数返回清除值；默认继承配置。

默认值继承 Provider，默认 undefined

valueRolestring

数据对象中用于文字、取值、子节点或缩进的字段名。

默认值"value"

visiblebool

是否显示组件。

默认值true

widthreal

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

默认值implicitWidth

advancedbool只读

选择器是否因多选、过滤或自定义委托而使用扩展模式。

默认值由运行时计算

emptybool只读

当前值是否被判定为空。

默认值由运行时计算

groupedbool只读

选择器模型是否包含选项分组。

默认值由运行时计算

hasValidationErrorbool只读

当前校验状态是否为 Error。

默认值由运行时计算

selectedValuesvar只读

选择器多选模式下的已选值数组。

默认值由运行时计算

sourceOptionsvar只读

经过数据规范化处理的建议或选择项列表。

默认值由运行时计算

visibleOptionsvar只读

选择器当前过滤后显示的选项。

默认值由运行时计算

方法

签名作用

commitInput(text)

提交输入文字；内容无效时保留原值并发出 inputRejected。