Components · Lines

Line chart with comparison and KPI tabs

KPI tabs showing each measure’s change against the previous period, over a line chart that overlays both.

Open in playground

Preview

Signups and customers vs previous period

Usage

tsx
import {
  ChartsProvider,
  LineChartComparisonWithKpiTabs,
  dimension,
  measure,
  results,
} from 'em-kit';

const startDate = dimension({
  name: 'startDate',
  title: 'Start date',
  type: 'time',
  granularity: 'month',
});
const signups = measure({
  name: 'signups',
  title: 'Signups',
  inputs: {
    abbreviateLargeNumber: true,
    previousLineDashed: true,
    previousLineColor: '#a1a1aa',
  },
});
const customers = measure({
  name: 'customers',
  title: 'Customers',
  inputs: { previousLineDashed: true, previousLineColor: '#a1a1aa' },
});

export const Example = () => (
  <ChartsProvider>
    <div style={{ height: 460 }}>
      <LineChartComparisonWithKpiTabs
        title="Signups and customers vs previous period"
        xAxis={startDate}
        measures={[signups, customers]}
        results={results(rows)}
        resultsComparison={results(comparisonRows)}
        resultsKpis={results(kpiRows)}
        resultsKpisComparison={results(kpiComparisonRows)}
        comparisonPeriod="Previous period"
        primaryDateRange={currentRange}
        comparisonDateRange={previousRange}
        showValueLabels={false}
      />
    </div>
  </ChartsProvider>
);

const currentRange = {
  from: new Date('2026-03-01'),
  to: new Date('2026-06-30'),
};
const previousRange = {
  from: new Date('2025-11-01'),
  to: new Date('2026-02-28'),
};

const rows = [
  { startDate: '2026-03-01T00:00:00.000', customers: 469, signups: 2266 },
  { startDate: '2026-04-01T00:00:00.000', customers: 410, signups: 2474 },
  { startDate: '2026-05-01T00:00:00.000', customers: 428, signups: 2945 },
  { startDate: '2026-06-01T00:00:00.000', customers: 476, signups: 2634 },
];

const comparisonRows = [
  { startDate: '2025-11-01T00:00:00.000', customers: 478, signups: 1543 },
  { startDate: '2025-12-01T00:00:00.000', customers: 498, signups: 2282 },
  { startDate: '2026-01-01T00:00:00.000', customers: 406, signups: 2385 },
  { startDate: '2026-02-01T00:00:00.000', customers: 385, signups: 2191 },
];

const kpiRows = [{ signups: 10319, customers: 1783 }];

const kpiComparisonRows = [{ signups: 8401, customers: 1767 }];

Install with npm install em-kit. Needs <ChartsProvider> once and a parent with a height: Quick start.

Examples

One date axis

Both lines against the current period’s dates, without the second x-axis. showComparisonAxis={false} drops the axis that carries the comparison period’s own dates.

tsxDiffers from Usage
Show full code (76 lines)
import {
  ChartsProvider,
  LineChartComparisonWithKpiTabs,
  dimension,
  measure,
  results,
} from 'em-kit';

const startDate = dimension({
  name: 'startDate',
  title: 'Start date',
  type: 'time',
  granularity: 'month',
});
const signups = measure({
  name: 'signups',
  title: 'Signups',
  inputs: {
    abbreviateLargeNumber: true,
    previousLineDashed: true,
    previousLineColor: '#a1a1aa',
  },
});
const customers = measure({
  name: 'customers',
  title: 'Customers',
  inputs: { previousLineDashed: true, previousLineColor: '#a1a1aa' },
});

export const Example = () => (
  <ChartsProvider>
    <div style={{ height: 460 }}>
      <LineChartComparisonWithKpiTabs
        title="Signups and customers vs previous period"
        xAxis={startDate}
        measures={[signups, customers]}
        results={results(rows)}
        resultsComparison={results(comparisonRows)}
        resultsKpis={results(kpiRows)}
        resultsKpisComparison={results(kpiComparisonRows)}
        comparisonPeriod="Previous period"
        primaryDateRange={currentRange}
        comparisonDateRange={previousRange}
        showValueLabels={false}
        showComparisonAxis={false}
      />
    </div>
  </ChartsProvider>
);

const currentRange = {
  from: new Date('2026-03-01'),
  to: new Date('2026-06-30'),
};
const previousRange = {
  from: new Date('2025-11-01'),
  to: new Date('2026-02-28'),
};

const rows = [
  { startDate: '2026-03-01T00:00:00.000', customers: 469, signups: 2266 },
  { startDate: '2026-04-01T00:00:00.000', customers: 410, signups: 2474 },
  { startDate: '2026-05-01T00:00:00.000', customers: 428, signups: 2945 },
  { startDate: '2026-06-01T00:00:00.000', customers: 476, signups: 2634 },
];

const comparisonRows = [
  { startDate: '2025-11-01T00:00:00.000', customers: 478, signups: 1543 },
  { startDate: '2025-12-01T00:00:00.000', customers: 498, signups: 2282 },
  { startDate: '2026-01-01T00:00:00.000', customers: 406, signups: 2385 },
  { startDate: '2026-02-01T00:00:00.000', customers: 385, signups: 2191 },
];

const kpiRows = [{ signups: 10319, customers: 1783 }];

const kpiComparisonRows = [{ signups: 8401, customers: 1767 }];
<LineChartComparisonWithKpiTabs
  title="Signups and customers vs previous period"
  xAxis={startDate}
  measures={[signups, customers]}
  results={results(rows)}
  resultsComparison={results(comparisonRows)}
  resultsKpis={results(kpiRows)}
  resultsKpisComparison={results(kpiComparisonRows)}
  comparisonPeriod="Previous period"
  primaryDateRange={currentRange}
  comparisonDateRange={previousRange}
  showValueLabels={false}
  showComparisonAxis={false}
/>

Props

Not listed: granularity, which the type accepts and the component does not read. Keyboard and screen readers: Accessibility.

PropTypeDefaultDescription
xAxisrequiredDimensionThe dimension along the x-axis. A time dimension gets gap filling and date labels.
measuresrequiredMeasure[]The numeric fields to plot, one series each. Their inputs set the formatting.
resultsrequiredDataResponseYour query’s state: { isLoading, data, error }, where data is your rows. results(rows) builds it from an array.
resultsComparisonrequiredDataResponseRows for the comparison period, with the same keys as results.
comparisonDateRangerequiredTimeRangeThe dates resultsComparison covers: { from: Date, to: Date }, with an optional relativeTimeString naming a preset. The comparison’s axis runs from from to to.
primaryDateRangerequiredTimeRangeThe dates results covers: { from: Date, to: Date }, with an optional relativeTimeString naming a preset. The x-axis runs from from to to.
resultsKpisrequiredDataResponseOne row holding each measure’s total, shown as tabs above the chart. Clicking a tab plots that measure.
reverseXAxisbooleanfalseReverse the order of the x-axis.
showLegendbooleantrueShow the legend. A chart with one series shows none; entries wrap onto more lines when they do not fit.
showLogarithmicScalebooleanfalseUse a logarithmic value axis, for values that span several orders of magnitude.
showTooltipsbooleantrueShow a formatted tooltip on hover.
showValueLabelsbooleantruePrint each value on the chart.
xAxisLabelstringA title under the x-axis.
yAxisLabelstringA title beside the y-axis.
yAxisRangeMaxnumberFix the highest value on the y-axis. When unset, it fits the data.
yAxisRangeMinnumberFix the lowest value on the y-axis. When unset, a bar, line or area chart’s axis includes zero, and a scatter or bubble chart’s fits the data.
comparisonPeriodstringWhich period resultsComparison holds. One of "Previous period", "Previous week", "Previous month", "Previous quarter", "Previous year", "Same period last week", "Same period last month", "Same period last quarter", "Same period last year". Without it the comparison is not drawn. With setComparisonDateRange the comparison dates are worked out from it, and any other string gives no range.
showComparisonAxisbooleantrueShow a second x-axis with the comparison period’s dates. Set it to false to draw both lines against the current dates.
setGranularity(granularity: Granularity) => voidCalled with the granularity the reader picks in the card. The picker only shows when the time field sets showGranularityDropdown: true in its inputs. Store the value, set it as the field’s granularity and pass rows at that granularity.
setComparisonDateRange(dateRange: TimeRange) => voidIf set, the chart works out the comparison dates from primaryDateRange and comparisonPeriod and calls this with them, so you can query them. When it cannot work them out, it calls this with no range.
onLineClicked(arg: LineChartOptionsClickArg) => voidCalled with the clicked point’s dimension value and date range.LineChartOptionsClickArg = { dimensionValue: string | number | undefined; dimensionTimeRange: TimeRange; measureValue?: number | undefined; measureValues?: Record<string, unknown> | undefined; }
componentNamestringA name for this component, included in the interaction events it dispatches on the DOM, for your analytics.
trackingIdstringAn id included in the same events, to tell two instances apart.
titlestringThe card’s title. A "key|fallback" string is looked up in your translations.
descriptionstringSmaller text under the title. Translates like title.
tooltipstringText for an info icon beside the title.
hideMenubooleanfalseHide the card’s header: the title, description and menu.
menuOptions("csv" | "xlsx" | "png" | "maximize")[]["csv", "xlsx", "png", "maximize"]Which entries the card menu offers. Pass [] for none.
resultsKpisComparisonDataResponseThe same one row for the comparison period, so each tab can show its change.

A blank default means the prop is unset unless you pass it.

TypeDefinition
Granularity"second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year"
TimeRange{ from: Date | undefined; to: Date | undefined; relativeTimeString?: string; } | undefinedWhat a click’s TimeRange holds: Events.

Field options

Set in a field’s inputs, beside the common options:

OptionTypeSet onDescription
fillUnderLinebooleanmeasuresShade the area under the line.
lineColorstringmeasuresA colour for this measure’s line, in place of the theme’s.
previousLineColorstringmeasuresA colour for the comparison period’s line.
lineDashedbooleanmeasuresDraw the current period’s line dashed. Default: false.
previousLineDashedbooleanmeasuresDraw the comparison period’s line dashed. When off, it is solid like the current line. Default: false.
connectGapsbooleanmeasuresDraw a missing value as zero, so the line carries on. When off, the line breaks at the gap. Default: false.
invertChangeColorsbooleanmeasuresColour an increase as bad and a decrease as good, for costs or churn. Default: false.
reverseTrendDirectionbooleanmeasuresPoint the trend arrow the other way. When unset, the arrow follows invertChangeColors.
displayChangeAsPercentagebooleanmeasuresShow the change as a percentage instead of a difference. Default: false.
percentageDecimalPlacesnumbermeasuresDecimal places on the percentage change. Only read with displayChangeAsPercentage. Default: 1.