mirror of https://github.com/apache/superset.git synced 2026-05-21 15:55:10 +00:00

Files

Claude Code cbcfd9599f docs: cut 6.1.0 versions for docs, admin_docs, developer_docs, components

Snapshots all four versioned Docusaurus sections at v6.1.0. Built on
top of the version-cutting tooling work in chore/docs-cut-6.1.0-versions
so the snapshot benefits from:

- Auto-gen refresh before snapshotting (database pages from engine
  spec metadata, API reference from openapi.json, component pages
  from Storybook stories) — captured at the SHA we cut from rather
  than whatever happened to be on disk.
- Data-import freeze: country list, feature flag table, database
  diagnostics, and component metadata are copied into snapshot-local
  `_versioned_data/` dirs so the historical version doesn't silently
  mutate when the source files change.
- Depth-aware import-path rewriter that handles deeply-nested
  component MDX files referencing `../../../src/` from the snapshot.

Versioning behavior: `lastVersion` stays at `current` for every
section, so the canonical URLs (`/docs/...`, `/admin-docs/...`,
`/developer-docs/...`, `/components/...`) continue to render content
from master. The `current` version is consistently labeled "Next"
with an `unreleased` banner, and `6.1.0` is a historical pin
accessible only via its explicit version segment.

Component playground: previously `disabled: true` in versions-config.json,
now enabled and versioned. The plugin block in docusaurus.config.ts
was already gated only by the `disabled` flag, so no other code
changes were needed to bring it back online.

The frozen `databases.json` in the snapshot is the canonical 80-database
artifact from the latest committed state in master (preserved by the
generator's input-hash cache), not a fallback regenerated from a
local Flask environment.

2026-05-13 17:15:46 -07:00

3.1 KiB

Raw Blame History

title: Bar Chart sidebar_position: 1

Bar Chart Component

The Bar Chart component is used to visualize categorical data with rectangular bars.

Props

Prop	Type	Default	Description
`data`	`array`	`[]`	Array of data objects to visualize
`width`	`number`	`800`	Width of the chart in pixels
`height`	`number`	`600`	Height of the chart in pixels
`xField`	`string`	-	Field name for x-axis values
`yField`	`string`	-	Field name for y-axis values
`colorField`	`string`	-	Field name for color encoding
`colorScheme`	`string`	`'supersetColors'`	Color scheme to use
`showLegend`	`boolean`	`true`	Whether to show the legend
`showGrid`	`boolean`	`true`	Whether to show grid lines
`labelPosition`	`string`	`'top'`	Position of bar labels: 'top', 'middle', 'bottom'

Examples

Basic Bar Chart

import { BarChart } from '@superset-ui/chart-components';

const data = [
  { category: 'A', value: 10 },
  { category: 'B', value: 20 },
  { category: 'C', value: 15 },
  { category: 'D', value: 25 },
];

function Example() {
  return (
    <BarChart
      data={data}
      width={800}
      height={400}
      xField="category"
      yField="value"
      colorScheme="supersetColors"
    />
  );
}

Grouped Bar Chart

import { BarChart } from '@superset-ui/chart-components';

const data = [
  { category: 'A', group: 'Group 1', value: 10 },
  { category: 'A', group: 'Group 2', value: 15 },
  { category: 'B', group: 'Group 1', value: 20 },
  { category: 'B', group: 'Group 2', value: 25 },
  { category: 'C', group: 'Group 1', value: 15 },
  { category: 'C', group: 'Group 2', value: 10 },
];

function Example() {
  return (
    <BarChart
      data={data}
      width={800}
      height={400}
      xField="category"
      yField="value"
      colorField="group"
      colorScheme="supersetColors"
    />
  );
}

Best Practices

Use bar charts when comparing quantities across categories
Sort bars by value for better readability, unless there's a natural order to the categories
Use consistent colors for the same categories across different charts
Consider using horizontal bar charts when category labels are long

3.1 KiB Raw Blame History