Bar-Y series
A Bar-Y series displays horizontal bars. Each point provides an x value and a y coordinate or category. Set series.data[].type to bar-y.
See the BarYSeries API reference for all series options and ChartSeriesOptions for shared defaults.
Grouping and stacking
Multiple series are grouped by default. Use stacking: 'normal' to stack their values or stacking: 'percent' to show their proportions. Percent stacking supports only non-negative values. Use stackId to create separate stacks and series.options['bar-y'].stackGap to set the gap between segments in pixels.
Set grouping: false to overlay bars at the category center without taking up grouped slots. Non-stacked bars start at the value-axis baseline; stacking still accumulates values within each stackId. Omitted or true grouping preserves side-by-side positions.
Later series in series.data cover earlier ones, including their borders. The example places Plan before Actual to draw Actual on top.
Bar thickness is shared through series.options['bar-y'].barPadding and barMaxWidth. Per-series thickness is tracked in #761.
All series in the same stack must use the same grouping value; omitted grouping counts as true. Mixing values within a stack is a configuration error. To overlay complete stacks, give each stack a distinct stackId and set grouping: false on every series in those stacks.
Appearance
Borders
Set borderWidth in pixels (default 0), borderColor as a CSS color, and borderRadius in pixels. Set defaults in series.options['bar-y'] and override them on individual series. The default border color is var(--gcharts-shape-border-color).
Opacity
Set opacity from 0 to 1 in series.options['bar-y'], and override it on individual series or points. Omitted or null values inherit the next level, defaulting to 1. Opacity affects the fill and border and leaves normal data labels opaque.
The legend symbol follows series opacity. Tooltip markers follow point opacity, falling back to series opacity. Legend and tooltip text remain opaque; hidden series keep the standard inactive legend symbol.
The example uses the default palette with rounded borders and a shared opacity of 0.6.
States
Hover changes the fill color; the border retains its configured color. The inactive state multiplies the resolved fill and border opacity by states.inactive.opacity, so transparent bars stay transparent. SVG data labels use the inactive opacity directly. When it ends, bars restore their point or series opacity.