QCustomTimeline
A vertical event timeline.
Each item has a marker dot on a connecting rail plus a title, optional time and description. Rail colours come from tokens (qproperty lineColor); per-item dot colour can be overridden. Tokenized.
At a glance
| Tier | Free (GPLv3) |
| Import | from Custom_Widgets.QCustomTimeline import QCustomTimeline |
| Qt Designer | Yes — drag it from the palette |
Quick start
from Custom_Widgets.QCustomTimeline import QCustomTimeline
widget = QCustomTimeline()
Dark theme
Colours come from the design tokens, so the widget follows the app theme with no extra work.
Properties
Every property below is settable in code and in Qt Designer.
| Property | Type | Default |
|---|---|---|
lineColor | color | — |
dotColor | color | — |
Methods
| Method | Description |
|---|---|
addItem(title, time=None, description=None, color=None) | Add an item. |
count() | Count. |
dotColor(*args, **kwargs) | Dot color. |
lineColor(*args, **kwargs) | Line color. |
setItems(items) | Set the items. |
Theming
Colours come from the design tokens, so they follow the active theme. Roles used: accent, on-surface, on-surface-muted, outline.
See Design tokens.
Related
QCustomAgendaList · QCustomAlert · QCustomAvatar · QCustomAvatarGroup · QCustomBadge · QCustomCard · QCustomChip · QCustomChipGroup