Navigation and structure
Native Qt
List View
A streamlined native collection view with keys, labels, descriptions, icons, 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.
list_view([{ id: 1, name: "Overview", icon: :house }, { id: 2, name: "Settings", icon: :gear }], key_field: :id, label_field: :name, icon_field: :icon, selected: 1) { |item| puts "Opened: #{item.fetch("name")}" }
API
Component properties
12 component-specific values, plus shared item and layout properties.
itemsItems configuration for List View.propertykey_fieldKey field configuration for List View.propertylabel_fieldLabel field configuration for List View.propertydescription_fieldDescription field configuration for List View.propertyicon_fieldIcon field configuration for List View.propertyselectedSelected configuration for List View.propertyorientationOrientation configuration for List View.propertyspacingSpacing configuration for List View.propertywidthWidth configuration for List View.propertyheightHeight configuration for List View.propertyempty_textEmpty text configuration for List View.propertyvisibleVisible configuration for List View.propertyShow 14 shared item properties
enabledopacityscalerotationzfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction
Events
Subscribe with on widget, :event and keep behavior in Ruby.
↗
activateNative event payload↗
changeNative event payload↗
scrollNative event payload