zui docs v0.0.5
GitHub ↗
Display, content, and media Native Qt

Badge

A compact count or status marker with capped values and dot mode.

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
badge 12, maximum: 99, background: "#b7ff5a", foreground: "#101408"
API

Component properties

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

valueValue configuration for Badge.property
maximumMaximum configuration for Badge.property
dotDot configuration for Badge.property
sizeSize configuration for Badge.property
minimum_widthMinimum width configuration for Badge.property
paddingPadding configuration for Badge.property
backgroundBackground configuration for Badge.property
foregroundForeground configuration for Badge.property
font_sizeFont size configuration for Badge.property
visibleVisible configuration for Badge.property
Show 15 shared item properties
enabledopacityscalerotationzwidthheightfill_widthfill_heightpreferred_widthpreferred_heightminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

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

clickNative event payload