Technical Support
🟢 Online now
Hello 👋

How can we help you today?
Contact on WhatsApp
B4X Store
jdashboardUI / Charts & Visualization / JTimeLine
Charts & Visualization

JTimeLine

Interactive vertical timeline for milestones and COMPLETED / ACTIVE / PENDING steps, with icons, cards and alternate sides.

Source
jdashboardUI.b4xlib · Public API only
Store language: en
Reference visual
Documentation reference created from the real component type. It is not an exact screenshot.
REFERENCE
JTimeLine REFERENCE Step 1Process milestone / statusStep 2Process milestone / statusStep 3Process milestone / statusStep 4Process milestone / status

Charts & Visualization · jdashboardUI 23.5 · B4J / JavaFX

Interactive vertical timeline for milestones and COMPLETED / ACTIVE / PENDING steps, with icons, cards and alternate sides.

The image shown on this page is a documentation reference visual. It is not intended to be a pixel-perfect screenshot; the real result depends on size, theme, colors and data.

Highlights

  • Process states
  • Cards and icons

When to use it

Interactive vertical timeline for milestones and COMPLETED / ACTIVE / PENDING steps, with icons, cards and alternate sides.

Designer Properties

Property Type Default Description
LineStyle String SOLID SOLID or DASHED
LineColor Color #FF64748B Default connector line color
ActiveLineColor Color #FF22C55E Color for completed segments
LineWidth Int 2 Width of connector line (dip)
NodeSize Int 24 Diameter of each circle indicator (dip)
ItemSpacing Int 80 Vertical space between items (dip)
UseStatusColors Boolean False Apply Completed/Active/Pending colors automatically
ColorCompleted Color #FF22C55E Circle color for COMPLETED status
ColorActive Color #FFFDE047 Circle color for ACTIVE status
ColorPending Color #FF94A3B8 Circle color for PENDING status
DefaultNodeColor Color #FF334155
DefaultNodeIconColor Color #FFFFFFFF
DefaultCardBgColor Color #FFFFFFFF
DefaultCardBorderColor Color #FFCBD5E1
AlternateSides Boolean False Alternate cards left/right

Creation and lifecycle

Private Timeline1 As JTimeLine

Timeline1.Initialize(Me, "Timeline1")
Timeline1.CreateTimeline(Root, 20dip, 20dip, Root.Width - 40dip, 500dip)

Working example

JTimeLine1.AddItem("08:00", "Order received", "Customer order created")
JTimeLine1.AddItem("09:15", "Preparing", "Warehouse is preparing items")
JTimeLine1.AddItem("11:30", "Shipped", "Package left the warehouse")

JTimeLine1.SetItemStatus(0, JTimeLine1.STATUS_COMPLETED)
JTimeLine1.SetItemStatus(1, JTimeLine1.STATUS_ACTIVE)
JTimeLine1.SetItemStatus(2, JTimeLine1.STATUS_PENDING)
JTimeLine1.Render

Normalized B4X properties

Compatible public getX/setX accessors are presented as normal B4X properties. Parameterized accessors remain documented as methods.

Property Access Type
Base read B4XView

Events

  • ItemClick(Index As Int, Title As String)
  • StateChanged(PreviousState As String, NewState As String)

Export and rendering

This component does not expose a public PNG export function in the analyzed version.

Source-backed notes for the analyzed version

  • Public status constants: STATUS_COMPLETED, STATUS_ACTIVE and STATUS_PENDING.
  • Supports SOLID / DASHED connectors and optional alternating cards.

Complete public API

  • Initialize(Callback As Object, EventName As String)
  • DesignerCreateView(Base As Object, Lbl As Label, Props As Map)
  • CreateTimeline(Parent As B4XView, Left As Int, Top As Int, Width As Int, Height As Int)
  • AddItem(YearOrDate As String, Title As String, Description As String = "", IconChar As String = "", IconFont As B4XFont = Null, IconColor As Int = 0)
  • AddItemWithIcon(YearOrDate As String, Title As String, Description As String, IconChar As String, IconFont As B4XFont, IconColor As Int)
  • AddItemCustom(YearOrDate As String, Title As String, Description As String, IconChar As String, IconFont As B4XFont, IconColor As Int, NodeBgColor As Int, CardBgColor As Int, TitleColor As Int, CardBorderColor As Int)
  • getBase() As B4XView
  • ScrollPanel() As B4XView
  • SetItemStatus(Index As Int, Status As String)
  • Clear()
  • Render()
  • SetCurrentStep(StepIndex As Int)
  • SetCurrentStepWithTimestamp(StepIndex As Int)
  • JStatusBarView
  • JPanelProgressBar