zui docs v0.0.5
GitHub ↗
Menus, dialogs, and feedback Container Native Qt

Dialog

A composable modal surface with native focus management, close policy, and action events.

Usage

Ruby example

Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.

Ruby
dialog "Create project", opened: true, width: 460 do
  text_field "", placeholder: "Project name"
end
API

Component properties

23 component-specific values, plus shared item and layout properties.

titleTitle configuration for Dialog.property
openedOpened configuration for Dialog.property
centeredCentered configuration for Dialog.property
xX configuration for Dialog.property
yY configuration for Dialog.property
widthWidth configuration for Dialog.property
heightHeight configuration for Dialog.property
modalModal configuration for Dialog.property
dimDim configuration for Dialog.property
focusFocus configuration for Dialog.property
close_policyClose policy configuration for Dialog.property
standard_buttonsStandard buttons configuration for Dialog.property
layoutLayout configuration for Dialog.property
spacingSpacing configuration for Dialog.property
paddingPadding configuration for Dialog.property
enabledEnabled configuration for Dialog.property
backgroundBackground configuration for Dialog.property
foregroundForeground configuration for Dialog.property
border_colorBorder color configuration for Dialog.property
radiusRadius configuration for Dialog.property
font_familyFont family configuration for Dialog.property
font_sizeFont size configuration for Dialog.property
visibleVisible configuration for Dialog.property
Show 13 shared item properties
opacityscalerotationzfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

Subscribe with on widget, :event and keep behavior in Ruby.

acceptNative event payload
rejectNative event payload
applyNative event payload
resetNative event payload
discardNative event payload
helpNative event payload
openNative event payload
closeNative event payload
about_to_showNative event payload
about_to_hideNative event payload
showNative event payload
hideNative event payload
focusNative event payload
blurNative event payload