ts-pptx

Appearance

Interface: ChartPropsChartBar ​

Extended by ​

Properties ​

bar3DShape? ​

optional bar3DShape?: "cone" | "coneToMax" | "box" | "cylinder" | "pyramid" | "pyramidToMax"

The solid a 3-D bar is drawn as (ST_Shape).

Default ​

ts
'box'

barDir? ​

optional barDir?: "col" | "bar"

Whether bars run horizontally (bar) or vertically (col) (ST_BarDir).

Default ​

ts
'col'

barGapDepthPct? ​

optional barGapDepthPct?: number

barGapWidthPct? ​

optional barGapWidthPct?: number

MS-PPT > Format chart > Format Data Point > Series Options > "Gap Width"

  • width (percent)
  • range: 0-500

Default ​

ts
150

barGrouping? ​

optional barGrouping?: "standard" | "percentStacked" | "clustered" | "stacked"

How the plot stacks its series (ST_BarGrouping). A 2-D bar plot takes every member but standard, which is the 3-D form's own default; an out-of-range value falls back to the default for the plot with a warning.

Default ​

ts
'clustered' (2-D), 'standard' (3-D)

barOverlapPct? ​

optional barOverlapPct?: number

MS-PPT > Format chart > Format Data Point > Series Options > "Series Overlap"

  • overlap (percent)
  • range: -100-100

Default ​

ts
0

barSeriesLine? ​

optional barSeriesLine?: boolean | OptsChartGridLine

Draw connector lines between data points across stacked bar/column series ("Series Lines" in PowerPoint). Emits <c:serLines> in the bar chart.

  • true uses PowerPoint's automatic line styling.
  • An OptsChartGridLine object customizes color/size/style/cap.
  • Omit (or pass an object with style: 'none') to disable.

Bar (bar) charts only; ignored for 3D bar charts.

Default ​

ts
undefined

Examples ​

ts
true
ts
{ color: '777777', size: 1, style: 'dash' }