Free · ECharts · Editable React source
Bar Foundation
A flexible ECharts bar base for vertical, horizontal, grouped, and stacked comparisons.
This is the installable component, not a mockup. Width is a preview container setting; theme and colors use your app’s shadcn CSS variables.
Select a mark or an accessible data-table value, or change the range to inspect the callback.
Waiting for an interaction…
Edit sample data · JSON
01 / Installation
Your code. Your project.
Use an initialized shadcn/Tailwind React project. The URL installs the component and its shared files recursively. No namespace configuration, platform account, or agent files.
Next.js, Vite & manual setup →npx shadcn@latest add https://beautifulcharts.dev/r/echarts-bar-foundation.jsonPackage dependencies: echarts. Shared files are included in Source above. The installed license file covers the free source.
For a manual install, add those packages, copy every listed Source file to its displayed path, and adjust the @/ alias if your project uses a different one.
02 / Component API
Make it yours.
Types, defaults, and source below are generated from the distributed component. Numeric values must be finite; recipe-specific bounds are checked in source. Formatters change displayed labels, not the underlying measurements.
| Prop | Type | Default | Required |
|---|---|---|---|
| data | EChartsBarDatum[] | sampleData | No |
| categoryKey | string | "team" | No |
| series | EChartsBarSeries[] | sampleSeries | No |
| title | string | "Bar foundation" | No |
| subtitle | string | "Rank and compare discrete categories" | No |
| orientation | "horizontal" | "vertical" | "vertical" | No |
| radius | number | 6 | No |
| showTooltip | boolean | true | No |
| showLegend | boolean | false | No |
| showBrush | boolean | false | No |
| onRangeChange | (params: unknown) => void | — | No |
| renderer | EChartsRenderer | "canvas" | No |
| onSelect | (params: unknown) => void | — | No |
| ariaDescription | string | — | No |
| optionOverrides | EChartsCoreOption | — | No |
| isLoading | boolean | — | No |
| className | string | — | No |
Exact data and series types
export type EChartsBarDatum = Record<string, string | number | undefined>;
export type EChartsBarSeries = { key: string; label?: string; color?: string; stack?: string };
export type EChartsBarFoundationProps = { data?: EChartsBarDatum[]; categoryKey?: string; series?: EChartsBarSeries[]; title?: string; subtitle?: string; orientation?: "horizontal" | "vertical"; radius?: number; showTooltip?: boolean; showLegend?: boolean; showBrush?: boolean; onRangeChange?: (params: unknown) => void; renderer?: EChartsRenderer; onSelect?: (params: unknown) => void; ariaDescription?: string; optionOverrides?: EChartsCoreOption; isLoading?: boolean; className?: string };shadcn theming
Your card, text, border, error, font, and chart colors—not a forced design system.
Native customization
Modify the local source or use the documented renderer-native extension points.
Accessible states
Loading, empty states, reduced motion, descriptions, and inspectable data tables.