Data and collections Native Qt

Calendar

Calendar is a native Zui component in the data and collections catalog, with 22 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.

Ruby

calendar "2026-08-24", show_week_numbers: true, show_navigation: true, width: 520

API

Component properties

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

dateDate configuration for Calendar.property

minimumMinimum configuration for Calendar.property

maximumMaximum configuration for Calendar.property

monthMonth configuration for Calendar.property

yearYear configuration for Calendar.property

localeLocale configuration for Calendar.property

show_week_numbersShow week numbers configuration for Calendar.property

show_navigationShow navigation configuration for Calendar.property

widthWidth configuration for Calendar.property

heightHeight configuration for Calendar.property

backgroundBackground configuration for Calendar.property

header_backgroundHeader background configuration for Calendar.property

selected_backgroundSelected background configuration for Calendar.property

today_backgroundToday background configuration for Calendar.property

foregroundForeground configuration for Calendar.property

mutedMuted configuration for Calendar.property

accentAccent configuration for Calendar.property

border_colorBorder color configuration for Calendar.property

radiusRadius configuration for Calendar.property

font_familyFont family configuration for Calendar.property

font_sizeFont size configuration for Calendar.property

visibleVisible configuration for Calendar.property

Show 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.

↗inputNative event payload

↗changeNative event payload

↗navigateNative event payload