When to use it. Who talks to whom: groups as arcs around a circle, relationships as ribbons through the middle, ribbon width ∝ flow. Feed it a matrix — service-to-service traffic, team hand-offs, trade between regions. Tapping an arc spotlights that group's ribbons (the rest fade to a whisper) and fires arcAction with the group's total, so the diagram doubles as a focus picker.
Type
chord
Also titled
Chord
Default size
3 rows × 3 columns
Symbol
circle.hexagonpath.fill
Docs
Docs complete
Search for it as
relationships
connections
circular
flow
matrix
Rendered by the app
Fields
11 fields you can set on a chord control. Every control also takes the shared fields (id, position, span, sync, action).
Fields
Field
Type
Default
What it does
haptichaptic
choiceone of 10
—
Buzz when you tap
Plays this vibration when you tap an arc, on supported phones.
noneno vibration
lighta gentle tap
mediuma firm tap
heavya strong thump
softa muted, cushioned tap
rigida sharp, hard tap
selectiona tiny tick like scrolling a picker
successa double tap for done
warninga sharp double tap for caution
errora buzzy triple tap for failure
Titlelabel
text
—
The title above the chart
Shows this text as the header above the diagram, with the selected group's readout beside it.
chordConfigchordConfig
object
—
All the chart settings in one place
Groups the arc, ribbon, color and action settings for the diagram; every part is optional.
Colortint
color
#667eea
The main color
Colors the first group and seeds the palette for the rest when no colors list is given.
formatValueformatValue
text
—
How totals are written
Formats the group total shown in the selection readout, for example as a number or percent.
arcActionchordConfig.arcAction
object
—
What happens when you tap a group
Runs this action when you tap an arc; the value sent is the group's label and total.
Arc colorschordConfig.colors
string[]
—
The colors for each group
Colors the arcs in order and repeats the list if there are more groups; colors in the data take priority.
Arc gapchordConfig.pad
number0–20 degstep 0.5
2.5
Gap between arcs
Leaves this many degrees of empty space between neighbouring arcs, from 0 to 20 (default 2.5).
Ribbon strengthchordConfig.ribbonOpacity
number0–1step 0.05
0.4
How solid the ribbons look
Sets how opaque the ribbons are from 0 to 1 (default 0.4); ribbons of the selected group brighten.
scrubchordConfig.scrub
on / off
false(off)
Drag around the ring to focus
When on, dragging around the ring moves the spotlight from group to group with a tick at each one; tapping still runs the action.
LabelschordConfig.showLabels
on / off
true(on)
Show group names
Writes each group's name around the outside of the ring; turn off to hide them.
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 group names that are dimmed while another group is spotlighted.
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 an arcarc
tap
json
the tapped group's label and total flow, as JSON
Dragging with scrub on only moves the spotlight; nothing sends until you tap
Example: {"label": "Sample A", "total": 3}
Receives
Receives
Takes
From
Type
What it does
cellsshow
hub, mqtt, http, store, default
json
a name per group and a square grid of numbers, where row one column two is the flow from group one to group two
arcs and ribbons resize to the new flows; a new set of labels redraws the ring
Arc size ∝ the group's row sum (pure receivers use their incoming total so
they still show). Each ribbon end is sized by that direction's flow, so an
asymmetric matrix tapers honestly.
Behavior
Arcs start at 12 o'clock and run clockwise; labels stay horizontal, anchored away from the rim
Tap an arc to spotlight its ribbons + fire arcAction; tap again or tap outside the ring to clear
scrub: true turns the ring into a dial — dragging sweeps the spotlight with a tick at every arc boundary
Ribbons blend a gradient between their two group colors
Dataset pushes animate via the control's animation profile
Notes
3–8 groups read best; the rim gets crowded past that