When to use it. A project timeline: one horizontal bar per task from start to end, with an optional progress fill, milestone diamonds, and a dashed today marker when the timeline is date-based. The hidden edge: with editable: true, dragging along a bar sets that task's progress — the chart becomes a bank of per-task progress sliders that write back into the dataset and fire taskAction on release.
Type
gantt
Also titled
Gantt
Default size
3 rows × 4 columns
Symbol
chart.bar.doc.horizontal
Docs
Docs complete
Search for it as
schedule
timeline
project
tasks
plan
bars
Rendered by the app
Fields
15 fields you can set on a gantt control. Every control also takes the shared fields (id, position, span, sync, action).
Fields
Field
Type
Default
What it does
haptichaptic
choiceone of 10
—
The buzz you feel on a touch
Plays this haptic on the phone when you tap or drag on the timeline.
noneno vibration
lighta small soft tap
mediuma medium tap
heavya strong thud
softa muted cushioned tap
rigida firm sharp click
selectionthe faint tick of picking an item
successthe double tap of a success
warninga two-pulse warning
errora sharp triple buzz of an error
Titlelabel
text
—
The title above the chart
Shows this text as the header over the timeline; the selected task's name and percent appear beside it.
ganttConfigganttConfig
object
—
All the timeline settings
Groups the options that change how the bars, axis and dragging behave; every setting inside is optional.
Colortint
color
#667eea
The main color
Colors the first task's bar and seeds the colors of the rest.
Bar roundnessganttConfig.barCornerRadius
number0–30 ptstep 1
5
How round the bar ends are
Rounds the corners of every bar; 0 is square and higher is pill-like.
Bar colorsganttConfig.colors
string[]
—
A color for each task
Cycles through these colors down the rows; a task's own color overrides it.
editableganttConfig.editable
on / off
false(off)
Let people drag progress
Dragging along a bar sets that task's progress, saves it and fires the task action when you let go.
Row heightganttConfig.rowHeight
number12–100 ptstep 1
30
How tall each row is
Sets the height of every task row, so the whole chart grows or shrinks with the task count.
scrubganttConfig.scrub
on / off
false(off)
Slide to browse rows
When the chart is not editable, dragging sweeps the selected row with a haptic tick; the action still fires on tap.
Time axisganttConfig.showAxis
on / off
true(on)
Show the time labels
Draws the time labels along the top of the chart when on, hides them when off.
Grid linesganttConfig.showGrid
on / off
true(on)
Show the grid lines
Draws faint vertical lines at each axis label when on.
Progress fillganttConfig.showProgress
on / off
true(on)
Show how far along
Fills each bar to its progress and shows the percent readout when on.
Today lineganttConfig.showToday
on / off
true(on)
Show a line for now
Draws a dashed line at the current time on date-based timelines; number timelines never show it.
stepganttConfig.step
number0–1step 0.05
0.05
How coarse dragging is
Rounds dragged progress to multiples of this size (0.05 is 5 percent steps), with a tick at each notch.
taskActionganttConfig.taskAction
object
—
What a tap or drag sends
The action fired when a task is tapped or a progress drag ends; {{value}} carries the task as JSON.
Theme fields
Restyle one control by setting these in its theme object; a layout's theme sets them for every control.
Theme fields
Field
Type
Default
What it does
secondaryColortheme.secondaryColor
color
#FFFFFF99
Dimmed text color
Colors the faintest text and ink on the chart.
Emits and receives
What this control sends when you use it, and what it can show or follow when data arrives.
Emits
Emits
Sends
When
Type
What it sends
When you tap a tasktask
tap
json
the task as its name, its place in the list and its progress from 0 to 1
With Editable on it also sends when you let go after dragging a bar to set progress
"yyyy-MM-dd", ISO 8601 datetime, or a plain number (any unit)
end
string | number
yes*
Same forms as start (*not needed for milestones)
progress
number
no
0–1 fill inside the bar
color
string
no
Bar color (hex)
milestone
bool
no
Draw a diamond at start instead of a bar
Dates and numbers share one axis — don't mix them in one payload.
Behavior
Tap a bar to select it (header shows name %); tap empty space to clear
Dragging (when editable) snaps to step with a selection tick per notch, updates the stored dataset on release so state readback round-trips, then fires the action with {"name", "index", "progress"}
Axis labels adapt to the span: hours under 2 days, day/month under ~10 months, month/year beyond
Milestones ignore end and can't be progress-dragged
Without editable, scrub: true lets a drag sweep the row selection fluidly instead
Notes
Keep names short — the leading gutter is ~25% of the width, capped at 110 pt
~10 tasks fit comfortably; the control grows taller with more
Dependencies/arrows are out of scope v1 — encode ordering with dates
Related
Axis bottom — cartesian series (incl. waterfall for cumulative effects)