Skip to content
GaudiGaudi Design System home

Search documentation

Search every page, heading and paragraph.

HistogramChart

Observations in round bins with labelled markers such as the median, a percentile or a budget.

Charts@gaudi/design-system/charts/HistogramChartView in StorybookSource

Installation

pnpm add github:ahmadassaf/design-system recharts

Import from @gaudi/design-system. Load @gaudi/design-system/global.css once and add transpilePackages: ['@gaudi/design-system'] in Next.js.

import { HistogramChart } from '@gaudi/design-system/charts/HistogramChart';

Copy an example into your project with the shadcn CLI: npx shadcn@latest add https://design.gaudi.site/r/histogram-chart-reading-time.json.

Usage

import { HistogramChart } from '@gaudi/design-system/charts';
<HistogramChart ariaLabel='Distribution of page weight' values={weights} markers={[{ value: 520, label: 'Median' }]} unit=' KB' />

Examples

Reading time with median and p90

Storybook

API

19 props

Accessibility

The plot is one tab stop named by ariaLabel. The arrow keys walk the points, Home and End jump to the ends, Enter or Space activates and Escape clears; the active point is drawn and read out politely. Every value is mirrored in a data table, and the SVG is hidden from assistive technology.