Skip to contentKino
Skip to Content

Sparkline

A trend small enough to sit beside a value, as a line, an area or bars, with no axes. The point under the pointer stays bright while the rest steps back, and new values move every point from where it is.

npx shadcn add https://kinoui.com/r/sparkline.json
Share on

Examples

Revenue

Pro subscriptions paid each day.
Yesterday$1,756
CategoryRevenue
Sat 17 October$1,179
Sun 18 October$888
Mon 19 October$1,716
Tue 20 October$1,740
Wed 21 October$1,742
Thu 22 October$1,520
Fri 23 October$1,586
Sat 24 October$1,149
Sun 25 October$1,230
Mon 26 October$1,639
Tue 27 October$1,882
Wed 28 October$1,893
Thu 29 October$1,621
Fri 30 October$1,790
Sat 31 October$1,443
Sun 1 November$1,219
Mon 2 November$1,912
Tue 3 November$1,894
Wed 4 November$2,038
Thu 5 November$1,927
Fri 6 November$1,868
Sat 7 November$1,472
Sun 8 November$1,646
Mon 9 November$1,878
Tue 10 November$1,986
Wed 11 November$2,234
Thu 12 November$2,099
Fri 13 November$2,143
Sat 14 November$1,751
Sun 15 November$1,756

Stat card

The value above reads the day under the pointer or the keys through onActiveIndexChange, and a new range moves every point from where it is.

This week

How the workspace changed since Monday.
  • Notes saved744
    CategoryNotes saved
    Mon 9 November1,284
    Tue 10 November1,412
    Wed 11 November1,356
    Thu 12 November1,538
    Fri 13 November1,490
    Sat 14 November812
    Sun 15 November744
  • Storage57.5 GB
    CategoryStorage
    Mon 9 November52.1 GB
    Tue 10 November53.4 GB
    Wed 11 November54 GB
    Thu 12 November55.2 GB
    Fri 13 November56.3 GB
    Sat 14 November56.8 GB
    Sun 15 November57.5 GB
  • Sign-ups18
    CategorySign-ups
    Mon 9 November38
    Tue 10 November52
    Wed 11 November47
    Thu 12 November61
    Fri 13 November44
    Sat 14 November21
    Sun 15 November18

Variants

A line, an area or bars with variant, the line and the area with an end dot on their last value.

MemberNotesLast 14 days
AO
Amara OkaforLead
135
CategoryNotes
Mon 2 November10
Tue 3 November13
Wed 4 November12
Thu 5 November11
Fri 6 November10
Sat 7 November0
Sun 8 November0
Mon 9 November14
Tue 10 November13
Wed 11 November16
Thu 12 November14
Fri 13 November18
Sat 14 November2
Sun 15 November2
KW
Kenji WatanabeEngineer
90
CategoryNotes
Mon 2 November7
Tue 3 November6
Wed 4 November12
Thu 5 November7
Fri 6 November7
Sat 7 November0
Sun 8 November2
Mon 9 November9
Tue 10 November11
Wed 11 November10
Thu 12 November9
Fri 13 November7
Sat 14 November1
Sun 15 November2
LF
Lucía FernándezDesigner
59
CategoryNotes
Mon 2 November5
Tue 3 November7
Wed 4 November6
Thu 5 November5
Fri 6 November4
Sat 7 November0
Sun 8 November1
Mon 9 November6
Tue 10 November4
Wed 11 November6
Thu 12 November6
Fri 13 November6
Sat 14 November2
Sun 15 November1
TL
Tobias LindqvistProduct
45
CategoryNotes
Mon 2 November4
Tue 3 November4
Wed 4 November4
Thu 5 November4
Fri 6 November3
Sat 7 November3
Sun 8 November2
Mon 9 November4
Tue 10 November4
Wed 11 November4
Thu 12 November4
Fri 13 November5
Sat 14 November0
Sun 15 November0

Table

Sparklines that share one activeIndex light the same day in every row, and the counts beside them read that day.

Sync

How long a note takes to reach every device.
Last hour201 ms
CategorySync time
00:00217 ms
01:00235 ms
02:00229 ms
03:00235 ms
04:00249 ms
05:00241 ms
06:00264 ms
07:00251 ms
08:00256 ms
09:00222 ms
10:00216 ms
11:00238 ms
12:00180 ms
13:00208 ms
14:00431 ms
15:00178 ms
16:00175 ms
17:00143 ms
18:00143 ms
19:00159 ms
20:00151 ms
21:00161 ms
22:00172 ms
23:00201 ms

Tooltip

A ChartTooltip inside reads the hour under the pointer, with its change since the hour before.

Installation

npx shadcn@latest add https://kinoui.com/r/sparkline.json
Files
lib/reduce-motion.tslib/scroll.tslib/refs.tslib/resize.tslib/swap.tsxlib/popup.tslib/glide.tsxcomponents/kino/tooltip.tsxlib/cut.tsxlib/announce.tsxcomponents/kino/spinner.tsxcomponents/kino/button.tsxlib/chart-math.tslib/controllable.tslib/number-format.tslib/chart-core.tsxlib/run-progress.tslib/highlight.tscomponents/kino/chart.tsxlib/line-path.tslib/area-fill.tsxlib/placeholder.tslib/chart-line.tsxcomponents/kino/area-chart.tsxcomponents/kino/bar-chart.tsxcomponents/kino/line-chart.tsxcomponents/kino/sparkline.tsx
Packages
@base-ui/reactclass-variance-authorityd3-arrayd3-shape

New to Kino? Installation covers what your project needs first and the @kino namespace.

The CLI keeps any of these colours your project already has, such as the chart colours shadcn init writes. To use Kino’s, set them in your global CSS:

globals.css
:root {  --chart-1: oklch(0.62 0.16 250);  --chart-2: oklch(0.54 0.18 257);  --chart-3: oklch(0.47 0.21 263);  --chart-4: oklch(0.4 0.19 268);  --chart-5: oklch(0.33 0.15 272);}.dark {  --chart-1: oklch(0.82 0.09 245);  --chart-2: oklch(0.74 0.13 250);  --chart-3: oklch(0.67 0.17 257);  --chart-4: oklch(0.61 0.19 263);  --chart-5: oklch(0.55 0.2 268);}

API reference

Props

PropTypeDefaultDescription
dataChartDatum[]NoneOne row per category: the category under index, and a value under each series’ key. A value can be a number, a [from, to] range, or missing.
indexstringNoneThe key of each row’s category.
configChartConfigNoneEach series by its key: its label and color (or theme for light and dark). One key is one series; each key is drawn.
labelstringNoneWhat the chart shows, for screen readers, such as “Visitors by month”.
descriptionstringNoneA longer account for screen readers, such as the trend.
formatIntl.NumberFormatOptions(value: number) => stringNoneHow values are written in the tooltip, the labels, the table and, shortened, the value axis.
categoryFormat(value: unknown) => stringStringHow a category is written.
localeIntl.LocalesArgumentNoneThe locale numbers are written in. Give one, so the server and the browser agree.
orderedbooleanfalseThe categories run in order, such as days, so the tooltip gives each value’s change since the one before.
domain[number | 'auto', number | 'auto']NoneThe range the values run over. An end left auto fits the data, never rounded out: a line runs from its lowest value to its highest, and an area or bars from zero.
activeIndexnumber | nullNoneThe category under the pointer or the focus, with defaultActiveIndex and onActiveIndexChange.
selectedstring | nullNoneThe category picked, by its key, with defaultSelected and onSelectedChange. Giving any of them lets a press pick one.
loadingbooleanfalseShows a placeholder; the marks grow out of it when the data arrives.
errorReactNodeNonetrue for the chart’s own words, or what to say.
onRetry() => voidNoneAdds a Try again button beside the error.
emptyReactNode'No data'What shows when data is empty.
messagesPartial<ChartMessages>NoneEvery word the chart says or reads out, for another language.
variant'line''area''bar''line'Draws each series as a line, a line with the area under it filled, or bars.
curve'monotone''linear''step''monotone'How a line runs between its points: a smooth curve that never overshoots them, straight, or in steps.
endDotbooleanfalseMarks the last value of each line with a dot.
entrance'none''draw''none'How it arrives the first time it comes into view: drawn along from the start, bars one after another. None by default, since a page that loads doesn’t animate into place.

Data attributes

AttributeOnDescription
data-variantSparklineHow it draws its series: line, area or bar.
data-dimA line, its fill and its dots, or a barIt steps back while another point is lit.

CSS variables

VariableSet it onDefaultDescription
--sparkline-widthSparkline, or anything above it1.5pxHow thick a line is.
--sparkline-dimSparkline, or anything above it0.3How much colour what steps back keeps.
--sparkline-window-fadeSparkline, or anything above it0.75remHow far the bright stretch around the lit point fades into the line that stepped back.
--sparkline-fill-topSparkline, or anything above it0.32How strong an area’s fill is at its peak, from 0 to 1.
--sparkline-fill-bottomSparkline, or anything above it0.04How strong an area’s fill is at its bottom, from 0 to 1.

Accessibility

  • The figure is named by label. Inside it, the plot is one stop in the tab order: a slider over the points. The arrow keys step, Home and End go to the ends, and each point’s value is read as the slider’s value.
  • A hidden table holds every value, for screen readers and for copying.
  • Loading, an error and new data are announced in a status region.
  • Forced colours draw each series in a system colour.
  • When the system asks for less motion, points move to their place at once and only fade.