# Components

32 components in 9 groups. Each links to its own page: purpose, install, usage, examples and props. Live previews: https://emkit.embeddable.com/docs/components

## KPIs (2)

- [KPI number](/docs/components/kpi-number.md) (`<KpiNumber />`): A single headline figure, formatted with the measure’s currency, prefix, suffix and locale.
- [KPI with comparison](/docs/components/kpi-number-comparison.md) (`<KpiNumberComparison />`): A headline figure with its change against a comparison period, coloured by direction.

## Bars (5)

- [Bar chart](/docs/components/bar-chart.md) (`<BarChart />`): Compare one or more measures across the values of a dimension.
- [Horizontal bar chart](/docs/components/bar-chart-horizontal.md) (`<BarChartHorizontal />`): Bars laid out horizontally, for long category labels or ranked lists.
- [Grouped bar chart](/docs/components/bar-chart-grouped.md) (`<BarChartGrouped />`): Side-by-side bars for each value of a second dimension.
- [Grouped horizontal bar chart](/docs/components/bar-chart-grouped-horizontal.md) (`<BarChartGroupedHorizontal />`): Side-by-side bars for each value of a second dimension, laid out horizontally.
- [Bar and line combo](/docs/components/bar-line-chart.md) (`<BarLineChart />`): Bars and a line on independent axes, for volume against a rate or count.

## Stacked (3)

- [Stacked bar chart](/docs/components/bar-chart-stacked.md) (`<BarChartStacked />`): Show the composition of each bar by a second dimension.
- [Stacked horizontal bar chart](/docs/components/bar-chart-stacked-horizontal.md) (`<BarChartStackedHorizontal />`): The composition of each bar by a second dimension, laid out horizontally for long labels.
- [Stacked area chart](/docs/components/area-chart.md) (`<AreaChart />`): Stacked areas showing how segments contribute to a total over time.

## Lines (5)

- [Line chart](/docs/components/line-chart.md) (`<LineChart />`): A time series with gap filling and a built-in granularity switcher.
- [Multi-series line chart](/docs/components/line-chart-grouped.md) (`<LineChartGrouped />`): One line per value of a dimension, over time.
- [Line chart with comparison](/docs/components/line-chart-comparison.md) (`<LineChartComparison />`): The current period against an earlier one, each on its own date axis.
- [Line chart with KPI tabs](/docs/components/line-chart-with-kpi-tabs.md) (`<LineChartWithKpiTabs />`): A tab per measure showing its total; selecting a tab switches the plotted line.
- [Line chart with comparison and KPI tabs](/docs/components/line-chart-comparison-with-kpi-tabs.md) (`<LineChartComparisonWithKpiTabs />`): KPI tabs showing each measure’s change against the previous period, over a line chart that overlays both.

## Pies (3)

- [Pie chart](/docs/components/pie-chart.md) (`<PieChart />`): Share of a total across a small number of categories.
- [Donut chart](/docs/components/donut-chart.md) (`<DonutChart />`): A pie with the centre cut out, for a lighter visual weight.
- [Donut with total](/docs/components/donut-label-chart.md) (`<DonutLabelChart />`): A donut with a headline figure in the centre.

## Funnels (1)

- [Funnel chart](/docs/components/funnel-chart.md) (`<FunnelChart />`): How much of a total survives each step of a process, in order.

## Scatter (2)

- [Scatter chart](/docs/components/scatter-chart.md) (`<ScatterChart />`): Plot two measures against each other, one point per dimension value.
- [Bubble chart](/docs/components/bubble-chart.md) (`<BubbleChart />`): A scatter chart with a third measure encoded as bubble size.

## Tables (4)

- [Paginated table](/docs/components/table-paginated.md) (`<TablePaginated />`): A controlled table: you own paging and sorting and pass in the current page of rows.
- [Scrollable table](/docs/components/table-scrollable.md) (`<TableScrollable />`): An infinite-scroll table: you serve pages of 50 rows and it appends each as the reader scrolls.
- [Pivot table](/docs/components/pivot-table.md) (`<PivotTable />`): Measures cross-tabulated by a row and a column dimension, with totals.
- [Heat map](/docs/components/heat-map.md) (`<HeatMap />`): A grid of cells coloured by value, for spotting hot and cold combinations.

## Controls (7)

- [Date range picker](/docs/components/date-range-picker.md) (`<DateRangePicker />`): Preset ranges such as “Last 30 days”, with a calendar for any other range.
- [Custom date range picker](/docs/components/date-range-picker-custom.md) (`<DateRangePickerCustom />`): A calendar for picking any start and end date, with no presets.
- [Granularity select](/docs/components/granularity-select.md) (`<GranularitySelect />`): Day, week, month, quarter or year: the period a time series is grouped by.
- [Comparison period select](/docs/components/comparison-period-select.md) (`<ComparisonPeriodSelect />`): Previous period, previous year and the like: what the current figures are compared with.
- [Single select](/docs/components/single-select.md) (`<SingleSelect />`): A searchable dropdown of a field’s values, one of which can be chosen.
- [Multi select](/docs/components/multi-select.md) (`<MultiSelect />`): A searchable dropdown of a field’s values, any number of which can be chosen.
- [Text field](/docs/components/text-field.md) (`<TextField />`): A free-text input, reported once the reader pauses typing.
