Charts · Bars

PyramidChart

Stacked tiers whose width encodes the value (0-100). Family: Bars · chart 11 of 60.

Headcount
label	width
Leads	18
Managers	42
Specialists	70
Staff	100

Report an issue with this chart

Headcount
label	width
Leads	18
Managers	42
Specialists	70
Staff	100

mode="precision"

Headcount
label	width
Leads	18
Managers	42
Specialists	70
Staff	100

substrate="green"

Headcount
label	width
Leads	18
Managers	42
Specialists	70
Staff	100

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 { PyramidChart } from '@silverpoint/react/pyramid-chart';

const data = [
  { label: 'Leads', width: 18 },
  { label: 'Managers', width: 42 },
  { label: 'Specialists', width: 70 },
  { label: 'Staff', width: 100 },
];

export default function App() {
  return (
    <div style={{ width: 480 }}>
      <PyramidChart
        data={data}
        labelKey="label"
        widthKey="width"
        title="Headcount"
      />
    </div>
  );
}

shell

npm install @silverpoint/vue @silverpoint/grounds @silverpoint/fonts

vue

<script setup lang="ts">
import '@silverpoint/fonts/fonts.css';
import '@silverpoint/grounds/styles.css';
import { SpPyramidChart } from '@silverpoint/vue/pyramid-chart';

const data = [
  { label: 'Leads', width: 18 },
  { label: 'Managers', width: 42 },
  { label: 'Specialists', width: 70 },
  { label: 'Staff', width: 100 },
];
</script>

<template>
  <div style="width: 480px">
    <SpPyramidChart
      :data="data"
      label-key="label"
      width-key="width"
      title="Headcount"
    />
  </div>
</template>

shell

npm install @silverpoint/angular @silverpoint/grounds @silverpoint/fonts

// src/styles.css:
//   @import '@silverpoint/fonts/fonts.css';
//   @import '@silverpoint/grounds/styles.css';

import { Component } from '@angular/core';
import { SpPyramidChart } from '@silverpoint/angular/pyramid-chart';

@Component({
  selector: 'app-root',
  imports: [SpPyramidChart],
  template: `
    <div style="width: 480px">
      <sp-pyramid-chart
        [data]="data"
        labelKey="label"
        widthKey="width"
        title="Headcount"
      />
    </div>
  `,
})
export class App {
  protected readonly data = [
    { label: 'Leads', width: 18 },
    { label: 'Managers', width: 42 },
    { label: 'Specialists', width: 70 },
    { label: 'Staff', width: 100 },
  ];
}

shell

pip install reflex-silverpoint-react

python

import reflex as rx
from reflex_silverpoint_react import pyramid_chart

DATA = [
    {"label": "Leads", "width": 18},
    {"label": "Managers", "width": 42},
    {"label": "Specialists", "width": 70},
    {"label": "Staff", "width": 100},
]


def index() -> rx.Component:
    return rx.box(
        pyramid_chart(
            data=DATA,
            label_key="label",
            width_key="width",
            title="Headcount",
        ),
        width="480px",
    )


app = rx.App()
app.add_page(index)

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.

Framework	Import
React	`import { PyramidChart } from '@silverpoint/react/pyramid-chart';`
Vue	`import { SpPyramidChart } from '@silverpoint/vue/pyramid-chart';`
Angular	`import { SpPyramidChart } from '@silverpoint/angular/pyramid-chart'; // <sp-pyramid-chart>`
Reflex	`from reflex_silverpoint_react import pyramid_chart`

Props

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

React / Angular	Vue	Reflex	Type	Description
`labelKey`	`label-key`	`label_key`	`Accessor<string>`	—
`widthKey`	`width-key`	`width_key`	`Accessor<number \| null \| undefined>`	—
`toneKey`	`tone-key`	`tone_key`	`Accessor<number \| null \| undefined>`	—

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 / Angular	Vue	Reflex	Type	Description
`data`	`data`	`data`	`readonly Datum[]`	Rows to draw. If omitted, the demo dataset is rendered (REQ-093) and the accessor props (`…_key`, `keys`, `names`) are ignored.
`ground`	`ground`	`ground`	`GroundRef`	Style ground: `silverpoint` or `cyanotype`, or a ground object. Defaults to the app provider's, or `silverpoint`.
`substrate`	`substrate`	`substrate`	`SubstrateName`	Prepared substrate within the ground (REQ-046).
`mode`	`mode`	`mode`	`InkMode`	`ink` by default; `precision` disables inking (REQ-021).
`seed`	`seed`	`seed`	`Seed`	Seed. If omitted, it is derived from `id` stably (REQ-003).
`id`	`id`	`id`	`string`	Stable identifier. If omitted, it is generated deterministically.
`height`	`height`	`height`	`number`	Height of the drawing area in px. Width is the container's unless pinned.
`width`	`width`	`width`	`number`	—
`chrome`	`chrome`	`chrome`	`'card' \| 'bare'`	`card` draws the full frame; `bare` only the drawing area (REQ-095).
`hatchFill`	`hatch-fill`	`hatch_fill`	`'tile' \| 'per-shape'`	How areas are filled (REQ-029).
`title`	`title`	`title`	`string`	—
`badge`	`badge`	`badge`	`string`	—
`value`	`value`	`value`	`string \| number`	—
`unit`	`unit`	`unit`	`string`	—
`footerLeft`	`footer-left`	`footer_left`	`string`	—
`footerRight`	`footer-right`	`footer_right`	`string`	—
`label`	`label`	`label`	`string`	Accessible name. If omitted, it is derived from `title` (REQ-120).
`description`	`description`	`description`	`string`	Long description for screen readers (REQ-120).
`dataTable`	`data-table`	`data_table`	`'visible' \| 'hidden' \| 'none'`	Tabular alternative; `hidden` leaves it for assistive technology only (REQ-121).
`locale`	`locale`	`locale`	`string`	—
`numberFormat`	`number-format`	`number_format`	`Intl.NumberFormatOptions`	—
`className`	`class-name`	`class_name`	`string`	—

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 } }.

Framework	Active item	Selection	Custom readout
React	`onActiveChange`	`onSelect`	`tooltip={(item, readout) => …}`
Vue	`@active-change`	`@select`	`<template #tooltip>`
Angular	`(activeChange)`	`(select)`	`<ng-template spTooltip>`
Reflex	`on_active_change`	`on_select`	`tooltip=tooltip_template(…)`

Interaction and readouts →

Report it

Found something wrong with PyramidChart? Open an issue on GitHub — the form comes pre-filled with the chart and the version.

PyramidChart

Example

Import

Props

Common props

Events