Skip to content

EDropdown 下拉菜单 ​

import EUI 1.0

示例与代码 ​

鼠标位置右键菜单 ​

QML 代码QML
效果
运行代码,体验组件交互

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

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

指定位置打开菜单 ​

QML 代码QML
效果
运行代码,体验组件交互

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

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

下拉菜单 ​

QML 代码QML
效果
运行代码,体验组件交互

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

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

属性 ​

属性说明取值与默认值
accessibleNamestring

辅助技术读取的名称;建议为无文字控件设置可读名称。

默认值text
autoInsertSpacebool

在两个中文字符的按钮文字之间插入空格。

默认值继承 Provider,默认 false
autofocusbool

组件显示时自动聚焦;受控件可用状态及弹层生命周期影响。

默认值false
bgbool

为文字按钮显示背景。

默认值false
checkablebool

是否允许通过点击切换选中状态。

默认值false
checkedbool

控件是否选中或开启。

默认值false
circlebool

采用圆形按钮样式。

默认值false
colorcolor

自定义颜色;透明值通常表示使用当前主题或语义配色。

默认值动态绑定
dashedbool

使用虚线边框。

默认值继承 Provider,默认 false
durationint

加载图标完成一圈旋转的时间,单位为毫秒。

默认值2600
effectstring

弹层的视觉主题。

"light" / "dark"

默认值"light"
enabledbool

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

默认值true
fontfont

字体配置,控制字体、字号及文字样式。

常用字段:
family、pixelSize、pointSize
bold、italic、weight
underline、strikeout
letterSpacing、wordSpacing

默认值应用字体
heightreal

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

默认值implicitHeight
hideOnClickbool

点击菜单项后关闭下拉菜单。

默认值true
hideTimeoutint

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

默认值150
iconComponentComponent

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

默认值null
iconSizeint

图标、选项或交互部件的尺寸,单位为像素。

默认值12
iconSourceint

组件使用的图标。

EIcons.*
0(无图标)

默认值EIcons.CHEVRON_DOWN
leftIconbool

将图标放在文字左侧。

默认值false
loadingbool

是否处于加载状态。

默认值false
loadingComponentComponent

自定义加载状态的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。

默认值null
loadingIconSourceint

组件使用的图标。

EIcons.*
0(无图标)

默认值0
maxHeightreal

最大显示高度,单位为像素;0 表示不额外限制。

默认值0
menuWidthint

弹层或菜单宽度,单位为像素;0 时使用自动宽度。

默认值160
minHeightint

控件最小高度,单位为像素;默认随 size 变化。

默认值动态绑定
modelvar

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

默认值[]
nativeTypestring

按钮行为,可用于普通操作、提交或重置表单。

button
submit
reset

默认值"button"
paddingSpacingint

文字和图标之间的间距,单位为像素。

默认值6
persistentbool

关闭后保留弹层内容实例。

默认值true
placementint

弹层或消息的显示位置。

EPlacement.TopLeft
EPlacement.Top
EPlacement.TopRight
EPlacement.Left
EPlacement.Right
EPlacement.BottomLeft
EPlacement.Bottom
EPlacement.BottomRight

默认值EPlacement.BottomLeft
plainbool

采用朴素配色。

默认值继承 Provider,默认 false
progressreal

进度值;用于进度动画或通知进度显示,具体范围由组件处理。

默认值-1
referenceItem

弹层依附的可视对象。

默认值null
roundbool

采用圆角胶囊按钮样式。

默认值继承 Provider,默认 false
showArrowbool

是否显示弹层或引导箭头。

默认值false
showTimeoutint

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

默认值150
sizeint

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

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider,默认 EStyle.Medium
splitButtonbool

把触发按钮拆分为主操作和下拉操作。

默认值false
strokeWidthint

边框、分隔线或进度轨道的线宽,单位为像素。

默认值3
styleTypeint

语义配色风格。

EStyle.Default
EStyle.Primary
EStyle.Success
EStyle.Info
EStyle.Warning
EStyle.Danger

默认值继承 Provider,默认 EStyle.Default
textstring

显示的文字内容。

默认值""
textButtonbool

采用文字按钮样式。

默认值继承 Provider,默认 false
triggerstring

打开下拉菜单的触发方式。

"click" / "hover"
"contextmenu"

默认值"click"
triggerKeysvar

触发操作的 Qt 键值数组;空数组禁用键盘触发。

默认值[Qt.Key_Return, Qt.Key_Enter, Qt.Key_Space, Qt.Key_Down]
visiblebool

是否显示组件。

默认值true
widthreal

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

默认值implicitWidth
displayTextstring只读

经过格式化、进度或徽章规则处理后的显示文字。

默认值由运行时计算
itemsvar只读

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

默认值由运行时计算
menualias只读

内部菜单、弹层或提示对象引用。

默认值别名:dropdownMenu
referenceAvailablebool只读

弹层参考对象是否可用、可交互或可见。

默认值由运行时计算

信号 ​

签名作用
command(var value, var item)

执行命令时触发,包含命令值和对应菜单项。

visibleChangedByUser(bool visible)

用户操作使下拉菜单显示或隐藏时触发,visible 为新的可见状态。

方法 ​

签名作用
close()

关闭组件的面板或弹窗。

open()

打开组件的面板或弹窗。

openAt(x, y, item)

在 item 的 x、y 坐标处打开下拉菜单。

基于 MIT 许可发布 · 第三方资源遵循其各自许可