Skip to content
ArcadiaDesign

When to draw one

A chart answers one question about many values. Say the question in one sentence before you draw; if you cannot, show the numbers.

Try the lighter forms first, in this order: the number alone; a meter for how much of a limit is left; a table for values a person looks up, compares exactly or copies; a small line beside the number for the shape of a trend. Two or three values are numbers side by side, never a chart.

Which chart

Choose by the question, one question to a chart and one value scale to a plot: a second unit is a second plot on the same rows, never a second axis.

The questionDrawNot this
How did it change over timeA line. An area when the amount under it matters: one series, or a stack. Bars when each row is a total of its own, such as tokens a dayA curve through counts per day; a line across names that have no order
How do these compareBars sorted by value, horizontal past eight bars or when the names are longA pie; bars in no order; more than three bars to a group
What part of the whole is eachHorizontal bars ranked by share, or one stacked bar; over time, stacked bars or a stacked area. A ring of five parts at most, with its list, only as a card's headlineA pie; a ring without its list; a stack whose parts do not add up
How much of a limit is leftA meter, its limit a tick with a labelA dial; a zone painted red before the value reaches it
How is it spreadBars over equal binsA mean alone; a line through the bins
How do two measures relateA scatterTwo lines on two scales
When is it busy, day by dayA calendar in five steps of one hue, its key in numbersA rainbow; steps named Less and More
How many get through each stepHorizontal bars in step order, the drop written between themA funnel drawn as a shape

Today the kit draws lines, areas and bars, sparklines and stat tiles, on the pages in the Charts group; until the other forms have pages there, answer their questions with a meter or a table.

Two registers

A chart is drawn in one of two registers, never between them: a plot has a block of its own, and an inline chart sits in a row, a tile or a cell beside its number.

A plot: its grid and value axis give the scale, so it reads without a pointer.
Median response timeToday
111msdown 17% from Sep 8
95th percentileToday
245msdown 8.2% from Sep 8
Inline: the same two series over their last 4 weeks, a line beside each number. Point at one and its number reads the day.
WhatPlotInline
Built fromChart and its partsSparkline and Stat, a meter, a progress ring
ScaleRead without a pointer: a value axis, or the value on each markNone: the number beside it is the scale
Grid, axes, legendYesNever
SeriesSix and Other at mostOne to a mark
Line--chart-line, 2px--chart-line-inline, the icon stroke
ReadingA crosshair, a dot on each series, the row on the axis and a cardThe host's own number
Height128, 192 or 256px16, 24 or 32px

Under 240px wide a chart is inline: a plot that narrow has no room for its scale.

Series colour

A series' colour is its identity, never its rank: --chart-1 to --chart-6, handed out in that order and kept by the same thing on every chart, legend and card.

A seventh series is --chart-other, a series that owns no slot beside ones that do is --chart-ink, and the accent is never a series. Each clears 3:1 on every surface a chart may sit on, in both themes; the figures below are measured live, in this theme.

SlotAppCardRaisedElevated

Under simulated protanopia, deuteranopia and tritanopia no two of the six come within 0.07 of each other in OKLab, in either theme. Colour is still never the only key: the legend and the card name every series, and the words beside a chart name a series by what it is and where it sits, never by its colour, which reads differently by day and at night.

The reading

One reading serves the pointer, a finger and the keys. It snaps to the rows: the pointer's x picks the nearest row across the plot's whole height, with no delay.

Point at the plot, tap it, or Tab to it and use the arrow keys.

The crosshair, a dot on each series, the row's label on the axis and the card are drawn on the read row in the pointer's own frame: a reading, not a movement. The card stands at the plot's top, 16px beside the crosshair, and turns to the other side where it would leave the plot. It never covers the row it reads and never follows the pointer's height.

Nothing dims while the crosshair reads across series: that is the comparison being made. To read one series alone, point at its legend item and the others set back; a press hides or shows the series, and the scale fits what is left.

A finger reads with a tap or a sideways drag. A vertical swipe that starts on the plot still scrolls the page, and the reading stays until a tap somewhere else.

Tab
Moves to the plot: the reading starts on the newest row, or on the row read last.
←→
Step a row.
↑↓
Step a row, as on any slider.
HomeEnd
The first row and the newest.
Esc
Hides the reading until the next key.

To assistive technology the plot is a slider over its rows. Its name is generated from the data, and its value text is the reading: "Tue, Oct 6: Europe 403, Americas 300, Asia 170, Total 873".

Motion

A chart appears whole in its first frame: nothing draws in, grows, staggers or counts up, on load or on scroll.

The card enters once per reading on the tooltip's step, a 4px slide and a fade over --duration-tip, and leaves over --duration-tip-exit. Between rows it never glides: a card that follows the pointer lets the crosshair step under it. From the keyboard it has no entrance, and under reduced motion it fades in where it stands.

The legend's dim is a colour change over --duration-fast. A series shown or hidden re-fits the scale in one frame: the scale never tweens and the marks never morph.