When to use it. Distribution at a glance: one box-and-whisker (quartiles, median, Tukey outliers) or violin (kernel density body) per category. Push raw samples and the phone does the statistics — quartiles, 1.5 × IQR fences, gaussian KDE — or push precomputed stats when the server already reduced them. Tapping a distribution reads its median into the header and fires boxAction with the full five-number summary, so a latency plot doubles as a drill-down picker.
Type
boxPlot
Also titled
Box Plot
Default size
3 rows × 4 columns
Symbol
align.vertical.center
Docs
Docs complete
Search for it as
boxplot
distribution
quartile
whisker
spread
statistics
Rendered by the app
Fields
19 fields you can set on a boxPlot 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 tap
Plays this haptic on the phone when you tap or scrub the plot, on supported hardware.
noneno vibration
lighta small soft tap
mediuma medium tap
heavya strong thud
softa cushioned, muffled 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 plot's title
Shows this text above the plot, with the selected box's median beside it.
ShapeboxStyle
choiceone of 2
box
Boxes or violins
Draws each category as a box-and-whisker or as a smooth violin-shaped density body.
boxdefaulta box with whiskers marking the quartiles and median
violina smooth shape showing where the samples cluster (needs raw samples)
boxPlotConfigboxPlotConfig
object
—
Extra plot settings
Groups the options for axes, whiskers, colors, scrubbing and the tap action.
Colortint
color
#667eea
Main color
Colors the first box and seeds the color of the others.
formatValueformatValue
text
—
How numbers are written
Formats the axis labels and the median readout, e.g. as a unit or with fixed decimals.
boxActionboxPlotConfig.boxAction
object
—
What a tap does
Fires this action when you tap a box, passing its five-number summary as {{value}}.
Bar roundnessboxPlotConfig.barCornerRadius
number0–30 ptstep 1
3
Box roundness
Rounds the box corners from square (0) to 30 points.
Box widthboxPlotConfig.boxWidth
number0–1step 0.05
0.55
How wide the boxes are
Sets each box's width as a fraction (0 to 1) of its category slot.
Box colorsboxPlotConfig.colors
string[]
—
Colors for each box
Cycles through this list of colors, one per category, instead of the built-in palette.
scrubboxPlotConfig.scrub
on / off
false(off)
Drag across the boxes
Lets a drag sweep the selection across categories with a tick for each change; the action still fires only on tap.
Grid linesboxPlotConfig.showGrid
on / off
true(on)
Grid lines on or off
Shows or hides the horizontal grid lines behind the boxes.
Mean dotboxPlotConfig.showMean
on / off
false(off)
Mean dot on or off
Shows or hides a hollow dot at each category's average.
OutliersboxPlotConfig.showOutliers
on / off
true(on)
Outlier dots on or off
Shows or hides the dots for values beyond the whiskers.
Bottom axisboxPlotConfig.showXAxis
on / off
true(on)
Category names on or off
Shows or hides the category labels along the bottom.
Side axisboxPlotConfig.showYAxis
on / off
true(on)
Value scale on or off
Shows or hides the value labels down the left side.
WhiskersboxPlotConfig.whiskers
choiceone of 2
tukey
How far the whiskers reach
Sets whether the whiskers stop at the Tukey fences with outliers as dots, or stretch to the full range.
tukeydefaultwhiskers stop at 1.5 times the spread and farther values show as dots
minmaxwhiskers reach the smallest and largest values with no outlier dots
yMaxboxPlotConfig.yMax
number
—
Top of the scale
Pins the top of the value axis instead of fitting it to the data.
yMinboxPlotConfig.yMin
number
—
Bottom of the scale
Pins the bottom of the value axis instead of fitting it to the data.
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 boxbox
tap
json
the tapped category's five-number summary (index, min, q1, median, q3, max) as JSON
Dragging with scrub on only moves the highlight; nothing sends until you tap