Chart.js

# Interface: BarControllerDatasetOptions

# Hierarchy

# Properties

# animation

• animation: false | AnimationSpec<"bar"> & { onComplete?: (this: Chart<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint)[], unknown>, event: AnimationEvent) => void ; onProgress?: (this: Chart<keyof ChartTypeRegistry, (number | [number, number] | Point | BubbleDataPoint)[], unknown>, event: AnimationEvent) => void }

# Inherited from

AnimationOptions.animation

# Defined in

types/index.d.ts:1757 (opens new window)

# animations

• animations: AnimationsSpec<"bar">

# Inherited from

AnimationOptions.animations

# Defined in

types/index.d.ts:1767 (opens new window)

# backgroundColor

• backgroundColor: ScriptableAndArray<Color, ScriptableContext<"bar">>

# Inherited from

ScriptableAndArrayOptions.backgroundColor

# Defined in

types/index.d.ts:1817 (opens new window)

# barPercentage

• barPercentage: number

Percent (0-1) of the available width each bar should be within the category width. 1.0 will take the whole category width and put the bars right next to each other.

Default

0.9

# Defined in

types/index.d.ts:114 (opens new window)

# barThickness

• barThickness: number | "flex"

Manually set width of each bar in pixels. If set to 'flex', it computes "optimal" sample widths that globally arrange bars side by side. If not set (default), bars are equally sized based on the smallest interval.

# Defined in

types/index.d.ts:124 (opens new window)

# base

• base: ScriptableAndArray<number, ScriptableContext<"bar">>

The base value for the bar in data units along the value axis.

# Inherited from

ScriptableAndArrayOptions.base

# Defined in

types/index.d.ts:2090 (opens new window)

# borderColor

• borderColor: ScriptableAndArray<Color, ScriptableContext<"bar">>

# Inherited from

ScriptableAndArrayOptions.borderColor

# Defined in

types/index.d.ts:1816 (opens new window)

# borderRadius

• borderRadius: ScriptableAndArray<number | BorderRadius, ScriptableContext<"bar">>

Border radius

Default

0

# Inherited from

ScriptableAndArrayOptions.borderRadius

# Defined in

types/index.d.ts:2102 (opens new window)

# borderSkipped

• borderSkipped: ScriptableAndArray<boolean | "end" | "start" | "left" | "top" | "bottom" | "right" | "middle", ScriptableContext<"bar">>

Skipped (excluded) border: 'start', 'end', 'left', 'right', 'bottom', 'top', 'middle', false (none) or true (all).

Default

'start'

# Inherited from

ScriptableAndArrayOptions.borderSkipped

# Defined in

types/index.d.ts:2096 (opens new window)

# borderWidth

• borderWidth: ScriptableAndArray<number | { bottom?: number ; left?: number ; right?: number ; top?: number }, ScriptableContext<"bar">>

Width of the border, number for all sides, object to specify width for each side specifically

Default

0

# Inherited from

ScriptableAndArrayOptions.borderWidth

# Defined in

types/index.d.ts:2115 (opens new window)

# categoryPercentage

• categoryPercentage: number

Percent (0-1) of the available width each category should be within the sample width.

Default

0.8

# Defined in

types/index.d.ts:119 (opens new window)

# clip

• clip: number | false | ChartArea

How to clip relative to chartArea. Positive value allows overflow, negative value clips that many pixels inside chartArea. 0 = clip at chartArea. Clipping can also be configured per side: clip: {left: 5, top: false, right: -2, bottom: 0}

# Inherited from

ControllerDatasetOptions.clip

# Defined in

types/index.d.ts:75 (opens new window)

# grouped

• grouped: boolean

Should the bars be grouped on index axis

Default

true

# Defined in

types/index.d.ts:146 (opens new window)

# hidden

• hidden: boolean

Configures the visibility state of the dataset. Set it to true, to hide the dataset from the chart.

Default

false

# Inherited from

ControllerDatasetOptions.hidden

# Defined in

types/index.d.ts:93 (opens new window)

# hoverBackgroundColor

• hoverBackgroundColor: ScriptableAndArray<Color, ScriptableContext<"bar">>

# Inherited from

ScriptableAndArrayOptions.hoverBackgroundColor

# Defined in

types/index.d.ts:1823 (opens new window)

# hoverBorderColor

• hoverBorderColor: ScriptableAndArray<Color, ScriptableContext<"bar">>

# Inherited from

ScriptableAndArrayOptions.hoverBorderColor

# Defined in

types/index.d.ts:1822 (opens new window)

# hoverBorderWidth

• hoverBorderWidth: ScriptableAndArray<number, ScriptableContext<"bar">>

# Inherited from

ScriptableAndArrayOptions.hoverBorderWidth

# Defined in

types/index.d.ts:1821 (opens new window)

# indexAxis

• indexAxis: "x" | "y"

The base axis of the chart. 'x' for vertical charts and 'y' for horizontal charts.

Default

'x'

# Inherited from

ControllerDatasetOptions.indexAxis

# Defined in

types/index.d.ts:71 (opens new window)

# inflateAmount

• inflateAmount: ScriptableAndArray<number | "auto", ScriptableContext<"bar">>

Amount to inflate the rectangle(s). This can be used to hide artifacts between bars. Unit is pixels. 'auto' translates to 0.33 pixels when barPercentage * categoryPercentage is 1, else 0.

Default

'auto'

# Inherited from

ScriptableAndArrayOptions.inflateAmount

# Defined in

types/index.d.ts:2109 (opens new window)

# label

• label: string

The label for the dataset which appears in the legend and tooltips.

# Inherited from

ControllerDatasetOptions.label

# Defined in

types/index.d.ts:79 (opens new window)

# maxBarThickness

• maxBarThickness: number

Set this to ensure that bars are not sized thicker than this.

# Defined in

types/index.d.ts:129 (opens new window)

# minBarLength

• minBarLength: number

Set this to ensure that bars have a minimum length in pixels.

# Defined in

types/index.d.ts:134 (opens new window)

# normalized

• normalized: boolean

Chart.js is fastest if you provide data with indices that are unique, sorted, and consistent across datasets and provide the normalized: true option to let Chart.js know that you have done so.

# Inherited from

ControllerDatasetOptions.normalized

# Defined in

types/index.d.ts:63 (opens new window)

# order

• order: number

The drawing order of dataset. Also affects order for stacking, tooltip and legend.

# Inherited from

ControllerDatasetOptions.order

# Defined in

types/index.d.ts:83 (opens new window)

# parsing

• parsing: false | { [key: string]: string; }

How to parse the dataset. The parsing can be disabled by specifying parsing: false at chart options or dataset. If parsing is disabled, data must be sorted and in the formats the associated chart type and scales use internally.

# Inherited from

ControllerDatasetOptions.parsing

# Defined in

types/index.d.ts:54 (opens new window)

# pointStyle

• pointStyle: PointStyle

Point style for the legend

Default

'circle;

# Defined in

types/index.d.ts:140 (opens new window)

# stack

• stack: string

The ID of the group to which this dataset belongs to (when stacked, each group will be a separate stack).

# Inherited from

ControllerDatasetOptions.stack

# Defined in

types/index.d.ts:88 (opens new window)

# transitions

• transitions: TransitionsSpec<"bar">

# Inherited from

AnimationOptions.transitions

# Defined in

types/index.d.ts:1768 (opens new window)

# xAxisID

• xAxisID: string

The ID of the x axis to plot this dataset on.

# Defined in

types/index.d.ts:104 (opens new window)

# yAxisID

• yAxisID: string

The ID of the y axis to plot this dataset on.

# Defined in

types/index.d.ts:108 (opens new window)

← BarElement →