Data and collections
Native Qt
Grid View
Grid View is a native Zui component in the data and collections catalog, with 38 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.
grid_view([{ id: 1, name: "Documents", icon: :folder }, { id: 2, name: "Images", icon: :image }], key_field: :id, label_field: :name, icon_field: :icon, cell_width: 180, cell_height: 120)
API
Component properties
38 component-specific values, plus shared item and layout properties.
itemsItems configuration for Grid View.propertykey_fieldKey field configuration for Grid View.propertylabel_fieldLabel field configuration for Grid View.propertydescription_fieldDescription field configuration for Grid View.propertyicon_fieldIcon field configuration for Grid View.propertyselectedSelected configuration for Grid View.propertycurrent_indexCurrent index configuration for Grid View.propertyflowFlow configuration for Grid View.propertylayout_directionLayout direction configuration for Grid View.propertycell_widthCell width configuration for Grid View.propertycell_heightCell height configuration for Grid View.propertyspacingSpacing configuration for Grid View.propertypaddingPadding configuration for Grid View.propertywidthWidth configuration for Grid View.propertyheightHeight configuration for Grid View.propertyhighlight_move_durationHighlight move duration configuration for Grid View.propertysnap_modeSnap mode configuration for Grid View.propertybounds_behaviorBounds behavior configuration for Grid View.propertykey_navigation_wrapsKey navigation wraps configuration for Grid View.propertyinteractiveInteractive configuration for Grid View.propertyclipClip configuration for Grid View.propertyempty_textEmpty text configuration for Grid View.propertyenabledEnabled configuration for Grid View.propertybackgroundBackground configuration for Grid View.propertycell_backgroundCell background configuration for Grid View.propertyselected_backgroundSelected background configuration for Grid View.propertyforegroundForeground configuration for Grid View.propertyselected_foregroundSelected foreground configuration for Grid View.propertymutedMuted configuration for Grid View.propertyaccentAccent configuration for Grid View.propertyborder_colorBorder color configuration for Grid View.propertyradiusRadius configuration for Grid View.propertyfont_familyFont family configuration for Grid View.propertyfont_sizeFont size configuration for Grid View.propertydescription_sizeDescription size configuration for Grid View.propertyicon_sizeIcon size configuration for Grid View.propertyaccessible_nameAccessible name configuration for Grid View.propertyvisibleVisible configuration for Grid View.propertyShow 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.
↗
activateNative event payload↗
changeNative event payload↗
current_changeNative event payload↗
count_changeNative event payload↗
highlightNative event payload↗
scrollNative event payload↗
movement_startNative event payload↗
movement_endNative event payload↗
showNative event payload↗
hideNative event payload↗
focusNative event payload↗
blurNative event payload