Components/Navigation

EDropdown Dropdown

import EUI 1.0

Examples

Context menu at pointer

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EDropdown { width: 420 height: 100 trigger: "contextmenu" model: [{ "label": "Copy", "command": "copy" }, { "label": "Paste", "command": "paste" }] ERectangle { anchors.fill: parent color: EPaletteManager.ThemePalette.surfaceHover(ETheme.dark) EText { anchors.centerIn: parent text: "Right-click anywhere" } } }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Open at a position

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { height: 60 width: 420 EButton { text: "Open at (120, 40)" onClicked: menu.openAt(120, 40) } EDropdown { id: menu model: [{ "label": "Action", "command": "action" }] } }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Dropdown

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EDropdown { text: "Actions" model: [{ "text": "Edit", "command": "edit" }] }

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

accessibleNamestring

Name read by assistive technologies; provide a readable name for controls without text.

Defaulttext

autoInsertSpacebool

Insert a space between two Chinese characters in button text.

DefaultInherited; default false

autofocusbool

Focus automatically when shown, subject to availability and popup lifecycle.

Defaultfalse

bgbool

Show a background for a text button.

Defaultfalse

checkablebool

Allow clicks to toggle the checked state.

Defaultfalse

checkedbool

Whether the control is checked or active.

Defaultfalse

circlebool

Use circular button styling.

Defaultfalse

colorcolor

Custom color; a transparent value usually selects theme or semantic colors.

DefaultDynamic binding

dashedbool

Use a dashed border.

DefaultInherited; default false

durationint

Duration of one loading-icon rotation in milliseconds.

Default2600

effectstring

Visual theme of the popup.

"light" / "dark"

Default"light"

enabledbool

Allow interaction; false disables the control.

Defaulttrue

fontfont

Font settings for the family, size and text style.

Common fields:
family, pixelSize, pointSize
bold, italic, weight
underline, strikeout
letterSpacing, wordSpacing

Defaultapplication font

heightreal

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

DefaultimplicitHeight

hideOnClickbool

Close the dropdown after clicking a menu item.

Defaulttrue

hideTimeoutint

Delay, throttling or automatic close time in milliseconds; 0 means no delay or no timed close.

Default150

iconComponentComponent

Component slot for custom icon; null uses the default content. See this page’s examples for delegate context.

Defaultnull

iconSizeint

Size of the icon, option or interactive part in pixels.

Default12

iconSourceint

Icon used by the component.

EIcons.*
0 (no icon)

DefaultEIcons.CHEVRON_DOWN

leftIconbool

Place the icon to the left of the text.

Defaultfalse

linkbool

Use link button styling.

Defaultfalse

loadingbool

Whether the component is loading.

Defaultfalse

loadingComponentComponent

Component slot for custom loading state; null uses the default content. See this page’s examples for delegate context.

Defaultnull

loadingIconSourceint

Icon used by the component.

EIcons.*
0 (no icon)

Default0

maxHeightreal

Maximum display height in pixels; 0 adds no extra limit.

Default0

menuWidthint

Popup or menu width in pixels; 0 selects automatic width.

Default160

minHeightint

Minimum control height in pixels; follows size by default.

DefaultDynamic binding

modelvar

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

Default[]

nativeTypestring

Button behavior for normal actions, submitting or resetting a form.

button
submit
reset

Default"button"

paddingSpacingint

Gap between text and icon in pixels.

Default6

persistentbool

Keep popup content instantiated after closing.

Defaulttrue

placementint

Display position of the popup or message.

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

DefaultEPlacement.BottomLeft

plainbool

Use plain colors.

DefaultInherited; default false

progressreal

Progress value used by progress animation or notification progress display.

Default-1

referenceItem

Visual item used as the popup reference.

Defaultnull

roundbool

Use rounded pill button styling.

DefaultInherited; default false

showArrowbool

Show the popup or tour arrow.

Defaultfalse

showTimeoutint

Delay, throttling or automatic close time in milliseconds; 0 means no delay or no timed close.

Default150

sizeint

Control size; inherits the nearest EConfigProvider by default.

EStyle.Small
EStyle.Medium
EStyle.Large

DefaultInherited; EStyle.Medium by default

splitButtonbool

Split the trigger into a main action and dropdown action.

Defaultfalse

strokeWidthint

Border, divider or progress track width in pixels.

Default3

styleTypeint

Semantic color style.

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

DefaultInherited; default EStyle.Default

textstring

Displayed text.

Default""

textButtonbool

Use text button styling.

DefaultInherited; default false

triggerstring

Interaction that opens the dropdown menu.

"click" / "hover"
"contextmenu"

Default"click"

triggerKeysvar

Array of Qt key codes that trigger the action; an empty array disables keyboard triggering.

Default[Qt.Key_Return, Qt.Key_Enter, Qt.Key_Space, Qt.Key_Down]

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

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

DefaultimplicitWidth

displayTextstringRead only

Display text after formatting, progress or badge rules.

DefaultComputed at runtime

itemsvarRead only

Normalized or transformed item list.

DefaultComputed at runtime

menualiasRead only

Reference to the internal menu, popup or tooltip.

DefaultAlias: dropdownMenu

referenceAvailableboolRead only

Whether the popup reference is available, enabled or visible.

DefaultComputed at runtime

Signals

SignaturePurpose

command(var value, var item)

Emitted when a command is invoked, with its value and menu item.

visibleChangedByUser(bool visible)

Emitted when user interaction opens or closes the dropdown; visible is its new visibility.

Methods

SignaturePurpose

close()

Close the component panel or popup.

open()

Open the component panel or popup.

openAt(x, y, item)

Open the dropdown at coordinates x and y relative to item.