zui docs v0.0.5
GitHub ↗
Buttons and input Native Qt

Searchable Dropdown

Searchable Dropdown is a native Zui component in the buttons and input catalog, with 16 component-specific properties.

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
searchable_dropdown :ruby, label: "Language", options: %i[ruby crystal elixir], placeholder: "Search languages"
API

Component properties

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

labelLabel configuration for Searchable Dropdown.property
valueValue configuration for Searchable Dropdown.property
optionsOptions configuration for Searchable Dropdown.property
placeholderPlaceholder configuration for Searchable Dropdown.property
empty_textEmpty text configuration for Searchable Dropdown.property
trigger_labelTrigger label configuration for Searchable Dropdown.property
foregroundForeground configuration for Searchable Dropdown.property
backgroundBackground configuration for Searchable Dropdown.property
popup_borderPopup border configuration for Searchable Dropdown.property
accentAccent configuration for Searchable Dropdown.property
font_familyFont family configuration for Searchable Dropdown.property
row_heightRow height configuration for Searchable Dropdown.property
popup_row_heightPopup row height configuration for Searchable Dropdown.property
popup_min_heightPopup min height configuration for Searchable Dropdown.property
show_labelShow label configuration for Searchable Dropdown.property
cursorCursor configuration for Searchable Dropdown.property
Show 17 shared item properties
visibleenabledopacityscalerotationzwidthheightfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

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

changeNative event payload
hoverNative event payload