Components/Feedback

EDialog Dialog

import EUI 1.0

Examples

Dynamic content and result

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { height: 50 width: 420 EButton { text: "Open dialog" onClicked: dialogs.open(content, { "greeting": "Dynamic content" }, { "title": "Service dialog", "onClose": function(value, accepted) { sampleFeedback.open(accepted ? JSON.stringify(value) : "Cancelled") } }) } EDialogService { id: dialogs } Component { id: content Column { property var dialogRef property string greeting: "Hello" spacing: 12 EText { text: parent.greeting } EButton { text: "Return result" onClicked: parent.dialogRef.resolve({ "saved": true }) } } } EMessage { id: sampleFeedback type: EStyle.Info objectName: "sampleFeedback" } }

Preview

Run the code to try the component

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

Code runs in this browser Licenses

Close guards and dragging

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Item { width: Math.min(640, parent.width) height: 480 Column { width: parent.width - 48 spacing: 16 anchors.centerIn: parent EButton { text: qsTr("Open dialog") onClicked: webNavigationDialog.open() } EDialog { id: webNavigationDialog draggable: true showFooter: false destroyOnClose: true title: qsTr("Confirm before closing") beforeClose: function(done) { webNavigationDialogConfirmation.complete = done webNavigationDialogConfirmation.open() } contentComponent: webNavigationDialogContent } Component { id: webNavigationDialogContent EText { width: parent.width wrapMode: Text.WordWrap text: qsTr("Content is destroyed after closing and recreated when opened again.") } } EDialog { id: webNavigationDialogConfirmation property var complete: null title: qsTr("Confirm close") text: qsTr("Close the current panel?") onAccepted: { if (complete) complete() complete = null } onRejected: { if (complete) complete(true) complete = null } } } }

Preview

Run the code to try the component

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

Code runs in this browser Licenses

Dialog

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { EButton { text: "Open" onClicked: examplePopup.open() } EDialog { id: examplePopup title: "Save changes" text: "Save your current changes?" } }

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

alignCenterbool

Center the layout or text.

DefaultInherited; default true

autofocusbool

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

Defaulttrue

backgroundColorcolor

Background color.

DefaultDynamic binding

beforeClosevar

Callback before closing; dialogs complete asynchronous checks through done(cancel).

Defaultnull

borderColorcolor

Border color.

DefaultDynamic binding

cancelTextstring

Cancel button text.

DefaultLocalized text

centerbool

Center the layout or text.

Defaultfalse

closeDelayint

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

Default0

closeIconint

Icon used by the component.

EIcons.*
0 (no icon)

DefaultEIcons.XMARK

closeOnClickOutsidebool

Close when clicking outside the popup.

Defaulttrue

closeOnEscapebool

Allow Escape to close the component.

Defaulttrue

closePolicyenum

Automatic popup closing conditions; flags can be combined.

Popup.* (combine with |)
NoAutoClose
CloseOnPressOutside
CloseOnPressOutsideParent
CloseOnReleaseOutside
CloseOnReleaseOutsideParent
CloseOnEscape

DefaultDynamic binding

confirmStyleTypeint

Semantic color style.

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

DefaultEStyle.Primary

confirmTextstring

Confirm button text.

DefaultLocalized text

contentalias

Content slot; declare QML child objects directly inside the component.

DefaultAlias: dialogContent.data

contentComponentComponent

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

Defaultnull

destroyOnClosebool

Destroy Component-loaded content after closing.

Defaultfalse

dialogRadiusreal

Corner radius in pixels.

Default8

draggablebool

Enable dragging of the object defined by the current component.

DefaultInherited; default false

enabledbool

Allow interaction; false disables the control.

Defaulttrue

enterDurationint

Animation or display duration in milliseconds; the component binding identifies its use.

Default220

exitDurationint

Animation or display duration in milliseconds; the component binding identifies its use.

Default180

focusbool

Whether the popup requests focus.

Defaultautofocus

fullscreenbool

Use full-screen display or a full-window overlay.

Defaultfalse

heightreal

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

Defaultfullscreen && Overlay.overlay ? Overlay.overlay.height : implicitHeight

modalbool

Use a modal popup that blocks interaction with underlying content.

Defaulttrue

modalOverlayColorcolor

Modal or non-modal overlay color.

DefaultDynamic binding

modalPenetrablebool

Allow input to pass through the non-modal overlay.

Defaultfalse

modelessOverlayColorcolor

Modal or non-modal overlay color.

DefaultDynamic binding

openDelayint

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

Default0

overflowbool

Allow the dialog to be dragged beyond the window bounds.

DefaultInherited; default false

showCancelButtonbool

Show the cancel button.

Defaulttrue

showClosebool

Show a close or remove button.

Defaulttrue

showConfirmButtonbool

Show the confirm button.

Defaulttrue

showFooterbool

Show the footer action area.

Defaulttrue

showHeaderbool

Show the header area.

Defaulttrue

textstring

Displayed text.

Default""

textColorcolor

Text color.

DefaultDynamic binding

titlestring

Title text.

Default""

titleColorcolor

Title color.

DefaultDynamic binding

topreal

Dialog top position in pixels, used when not vertically centered.

Default0

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

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

DefaultDynamic binding

windowMarginreal

Minimum dialog margin from the window edges in pixels.

Default16

loadedContentaliasRead only

Actual content item instantiated from a Component.

DefaultAlias: contentLoader.item

maximumDialogWidthrealRead only

Maximum dialog width after subtracting window margins.

DefaultComputed at runtime

Signals

SignaturePurpose

closeRejected()

Emitted when beforeClose rejects a close request.

openAutoFocused()

Emitted after the popup opens and finishes focusing its content.

closeAutoFocused()

Emitted after the popup closes and restores focus.

Methods

SignaturePurpose

close()

Close the component panel or popup.

open()

Open the component panel or popup.

resetPosition()

Restore the dialog to its initial position.

requestClose()

Request popup closure and run the beforeClose check.