Buttons and input
Native Qt
Search Field
A live search input with suggestions, keyboard highlighting, clearing, and activation.
Usage
Ruby example
Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.
search_field("", suggestions: %w[Button Card Chart], live: true) { |query| puts "Query: #{query}" }
API
Component properties
13 component-specific values, plus shared item and layout properties.
textText configuration for Search Field.propertysuggestionsSuggestions configuration for Search Field.propertytext_roleText role configuration for Search Field.propertyliveLive configuration for Search Field.propertycurrent_indexCurrent index configuration for Search Field.propertywidthWidth configuration for Search Field.propertyenabledEnabled configuration for Search Field.propertyforegroundForeground configuration for Search Field.propertybackgroundBackground configuration for Search Field.propertyaccentAccent configuration for Search Field.propertyfont_familyFont family configuration for Search Field.propertyfont_sizeFont size configuration for Search Field.propertyvisibleVisible configuration for Search Field.propertyShow 14 shared item properties
opacityscalerotationzheightfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction
Events
Subscribe with on widget, :event and keep behavior in Ruby.
↗
inputNative event payload↗
changeNative event payload↗
searchNative event payload↗
submitNative event payload↗
activateNative event payload↗
highlightNative event payload↗
clearNative event payload↗
focusNative event payload↗
blurNative event payload