UNPKG

@mui/x-charts

Version:

The community edition of MUI X Charts components.

69 lines 2.57 kB
import * as React from 'react'; import { type BarElementSlotProps, type BarElementSlots } from "./BarElement.js"; import { type BarItemIdentifier } from "../models/index.js"; import { type BarLabelSlotProps, type BarLabelSlots } from "./BarLabel/BarLabelItem.js"; import type { BarItem, BarLabelContext } from "./BarLabel/index.js"; import { type RendererType } from "../ScatterChart/index.js"; export interface BarPlotSlots extends BarElementSlots, BarLabelSlots {} export interface BarPlotSlotProps extends BarElementSlotProps, BarLabelSlotProps {} export interface BarPlotProps { /** * If `true`, animations are skipped. * @default undefined */ skipAnimation?: boolean; /** * Callback fired when a bar item is clicked. * @param {React.MouseEvent<SVGElement, MouseEvent>} event The event source of the callback. * @param {BarItemIdentifier} barItemIdentifier The bar item identifier. */ onItemClick?(event: React.MouseEvent<SVGElement, MouseEvent>, barItemIdentifier: BarItemIdentifier): void; /** * Defines the border radius of the bar element. */ borderRadius?: number; /** * @deprecated Use `barLabel` in the chart series instead. * If provided, the function will be used to format the label of the bar. * It can be set to 'value' to display the current value. * @param {BarItem} item The item to format. * @param {BarLabelContext} context data about the bar. * @returns {string} The formatted label. */ barLabel?: 'value' | ((item: BarItem, context: BarLabelContext) => string | null | undefined); /** * The type of renderer to use for the bar plot. * - `svg-single`: Renders every bar in a `<rect />` element. * - `svg-batch`: Batch renders bars in `<path />` elements for better performance with large datasets, at the cost of some limitations. * Read more: https://mui.com/x/react-charts/bars/#performance * * @default 'svg-single' */ renderer?: RendererType; /** * The props used for each component slot. * @default {} */ slotProps?: BarPlotSlotProps; /** * Overridable component slots. * @default {} */ slots?: BarPlotSlots; } /** * Demos: * * - [Bars](https://mui.com/x/react-charts/bars/) * - [Bar demonstration](https://mui.com/x/react-charts/bar-demo/) * - [Stacking](https://mui.com/x/react-charts/stacking/) * * API: * * - [BarPlot API](https://mui.com/x/api/charts/bar-plot/) */ declare function BarPlot(props: BarPlotProps): React.JSX.Element; declare namespace BarPlot { var propTypes: any; } export { BarPlot };