Skip to content
silverpoint
Documentation menu

Charts · Distributions & comparisons

ErrorBarChart

A point estimate with its interval per category. Family: Distributions & comparisons · chart 44 of 60.
Effect by trial armEffect by trial arm
Effect by trial arm
armeffectlowhigh
Arm A1.611.012.07
Arm B0.2-0.161.04
Arm C1.250.352.79
Arm D1.640.742.26
Arm E0.45-0.522.54
Arm F0.34-0.572.41
Arm G1.030.141.85
Arm H1.04-0.442.67
Effect by trial armEffect by trial arm
Effect by trial arm
armeffectlowhigh
Arm A1.611.012.07
Arm B0.2-0.161.04
Arm C1.250.352.79
Arm D1.640.742.26
Arm E0.45-0.522.54
Arm F0.34-0.572.41
Arm G1.030.141.85
Arm H1.04-0.442.67
mode="precision"
Effect by trial armEffect by trial arm
Effect by trial arm
armeffectlowhigh
Arm A1.611.012.07
Arm B0.2-0.161.04
Arm C1.250.352.79
Arm D1.640.742.26
Arm E0.45-0.522.54
Arm F0.34-0.572.41
Arm G1.030.141.85
Arm H1.04-0.442.67
substrate="green"
Effect by trial armEffect by trial arm
Effect by trial arm
armeffectlowhigh
Arm A1.611.012.07
Arm B0.2-0.161.04
Arm C1.250.352.79
Arm D1.640.742.26
Arm E0.45-0.522.54
Arm F0.34-0.572.41
Arm G1.030.141.85
Arm H1.04-0.442.67
ground="cyanotype"

Example

The chart above, in each framework. Pick a framework once and every example on the site follows it.

shell
npm install @silverpoint/react @silverpoint/grounds @silverpoint/fonts
tsx
import '@silverpoint/fonts/fonts.css';
import '@silverpoint/grounds/styles.css';
import { ErrorBarChart } from '@silverpoint/react/error-bar-chart';

const data = [
  { arm: 'Arm A', effect: 1.61, low: 1.01, high: 2.07 },
  { arm: 'Arm B', effect: 0.2, low: -0.16, high: 1.04 },
  { arm: 'Arm C', effect: 1.25, low: 0.35, high: 2.79 },
  { arm: 'Arm D', effect: 1.64, low: 0.74, high: 2.26 },
  { arm: 'Arm E', effect: 0.45, low: -0.52, high: 2.54 },
  { arm: 'Arm F', effect: 0.34, low: -0.57, high: 2.41 },
  { arm: 'Arm G', effect: 1.03, low: 0.14, high: 1.85 },
  { arm: 'Arm H', effect: 1.04, low: -0.44, high: 2.67 },
];

export default function App() {
  return (
    <div style={{ width: 480 }}>
      <ErrorBarChart
        data={data}
        labelKey="arm"
        estimateKey="effect"
        lowKey="low"
        highKey="high"
        title="Effect by trial arm"
      />
    </div>
  );
}

Import

Each chart has its own subpath, so a bundle only carries the charts it uses. Every adapter also exports every chart from its barrel.

FrameworkImport
Reactimport { ErrorBarChart } from '@silverpoint/react/error-bar-chart';
Vueimport { SpErrorBarChart } from '@silverpoint/vue/error-bar-chart';
Angularimport { SpErrorBarChart } from '@silverpoint/angular/error-bar-chart'; // <sp-error-bar-chart>
Reflexfrom reflex_silverpoint_react import error_bar_chart

Props

The props ErrorBarChart adds to the ones every chart takes. Accessor props (…Key, keys, names) name fields of your rows and are ignored without data.

React / AngularVueReflexTypeDescription
labelKeylabel-keylabel_keyAccessor<string>—
estimateKeyestimate-keyestimate_keyAccessor<number | null | undefined>—
lowKeylow-keylow_keyAccessor<number | null | undefined>—
highKeyhigh-keyhigh_keyAccessor<number | null | undefined>—
referencereferencereferencenumberA reference value drawn as a dotted rule.
orientationorientationorientationChartOrientationrows by default, as a forest plot reads.

Common props

Every chart also takes these. Framework conventions: camelCase in React and Angular, kebab-case in Vue templates, snake_case in Reflex. Read more about them.

Show the 22 common props
React / AngularVueReflexTypeDescription
datadatadatareadonly Datum[]Rows to draw. If omitted, the demo dataset is rendered (REQ-093) and the accessor props (…_key, keys, names) are ignored.
groundgroundgroundGroundRefStyle ground: silverpoint or cyanotype, or a ground object. Defaults to the app provider's, or silverpoint.
substratesubstratesubstrateSubstrateNamePrepared substrate within the ground (REQ-046).
modemodemodeInkModeink by default; precision disables inking (REQ-021).
seedseedseedSeedSeed. If omitted, it is derived from id stably (REQ-003).
idididstringStable identifier. If omitted, it is generated deterministically.
heightheightheightnumberHeight of the drawing area in px. Width is the container's unless pinned.
widthwidthwidthnumber—
chromechromechrome'card' | 'bare'card draws the full frame; bare only the drawing area (REQ-095).
hatchFillhatch-fillhatch_fill'tile' | 'per-shape'How areas are filled (REQ-029).
titletitletitlestring—
badgebadgebadgestring—
valuevaluevaluestring | number—
unitunitunitstring—
footerLeftfooter-leftfooter_leftstring—
footerRightfooter-rightfooter_rightstring—
labellabellabelstringAccessible name. If omitted, it is derived from title (REQ-120).
descriptiondescriptiondescriptionstringLong description for screen readers (REQ-120).
dataTabledata-tabledata_table'visible' | 'hidden' | 'none'Tabular alternative; hidden leaves it for assistive technology only (REQ-121).
localelocalelocalestring—
numberFormatnumber-formatnumber_formatIntl.NumberFormatOptions—
classNameclass-nameclass_namestring—

Events

Pointer and keyboard exploration are built in. The item under the pointer or focus is reported, and a click, Enter or Space selects it. The item is { seriesKey, index, datum, value, point: { x, y } }.

FrameworkActive itemSelectionCustom readout
ReactonActiveChangeonSelecttooltip={(item, readout) => …}
Vue@active-change@select<template #tooltip>
Angular(activeChange)(select)<ng-template spTooltip>
Reflexon_active_changeon_selecttooltip=tooltip_template(…)
Interaction and readouts →
Report it
Found something wrong with ErrorBarChart? Open an issue on GitHub — the form comes pre-filled with the chart and the version.