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.
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.propertyvalueValue configuration for Searchable Dropdown.propertyoptionsOptions configuration for Searchable Dropdown.propertyplaceholderPlaceholder configuration for Searchable Dropdown.propertyempty_textEmpty text configuration for Searchable Dropdown.propertytrigger_labelTrigger label configuration for Searchable Dropdown.propertyforegroundForeground configuration for Searchable Dropdown.propertybackgroundBackground configuration for Searchable Dropdown.propertypopup_borderPopup border configuration for Searchable Dropdown.propertyaccentAccent configuration for Searchable Dropdown.propertyfont_familyFont family configuration for Searchable Dropdown.propertyrow_heightRow height configuration for Searchable Dropdown.propertypopup_row_heightPopup row height configuration for Searchable Dropdown.propertypopup_min_heightPopup min height configuration for Searchable Dropdown.propertyshow_labelShow label configuration for Searchable Dropdown.propertycursorCursor configuration for Searchable Dropdown.propertyShow 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