@shbernal/ts-pptx

---

@shbernal/ts-pptx / index / ChartOpts

Interface: ChartOpts

Defined in: src/types/chart.ts:807

Options for the modern (Office 2016) chartEx chart types.

NOTE: chartEx charts (currently waterfall) render only in PowerPoint 2016+/Microsoft 365. In older Office, Google Slides, Keynote and LibreOffice a fallback placeholder shows instead.

Extends

• ChartPropsAxisCat.ChartPropsAxisSer.ChartPropsAxisVal.ChartPropsBase.ChartPropsChartBar.ChartPropsChartDoughnut.ChartPropsChartLine.ChartPropsChartPie.ChartPropsChartRadar.ChartPropsChartWaterfall.ChartPropsChartHistogram.ChartPropsChartBoxWhisker.ChartPropsChartRegionMap.ChartPropsChartStock.ChartPropsChartSurface.ChartPropsDataLabel.ChartPropsDataTable.ChartPropsLegend.ChartPropsTitle.ObjectNameProps.OptsChartGridLine.PositionProps

Properties

align?

optional align?: HAlign

Defined in: src/types/text.ts:18

Horizontal alignment

Default

'left'

Inherited from

ChartPropsTitle.align

---

altText?

optional altText?: string

Defined in: src/types/chart.ts:840

Alt Text value ("How would you describe this object and its contents to someone who is blind?")

• PowerPoint: [right-click on a chart] > "Edit Alt Text..."

Overrides

ObjectNameProps.altText

---

axisPos?

optional axisPos?: "r" | "b" | "t" | "l"

Defined in: src/types/chart.ts:219

Axis position

Inherited from

ChartPropsBase.axisPos

---

bar3DShape?

optional bar3DShape?: string

Defined in: src/types/chart.ts:473

Inherited from

ChartPropsChartBar.bar3DShape

---

barDir?

optional barDir?: string

Defined in: src/types/chart.ts:474

Inherited from

ChartPropsChartBar.barDir

---

barGapDepthPct?

optional barGapDepthPct?: number

Defined in: src/types/chart.ts:475

Inherited from

ChartPropsChartBar.barGapDepthPct

---

barGapWidthPct?

optional barGapWidthPct?: number

Defined in: src/types/chart.ts:482

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

• width (percent)
• range: 0-500

Default

150

Inherited from

ChartPropsChartBar.barGapWidthPct

---

barGrouping?

optional barGrouping?: string

Defined in: src/types/chart.ts:483

Inherited from

ChartPropsChartBar.barGrouping

---

barOverlapPct?

optional barOverlapPct?: number

Defined in: src/types/chart.ts:490

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

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

Default

0

Inherited from

ChartPropsChartBar.barOverlapPct

---

barSeriesLine?

optional barSeriesLine?: boolean | OptsChartGridLine

Defined in: src/types/chart.ts:504

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

undefined

Examples

true

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

Inherited from

ChartPropsChartBar.barSeriesLine

---

binning?

optional binning?: ChartExBinning

Defined in: src/types/chart.ts:618

Bin configuration for a histogram chart. Omit for PowerPoint's automatic binning.

Example

{ intervalClosed: 'l' }

Inherited from

ChartPropsChartHistogram.binning

---

bold?

optional bold?: boolean

Defined in: src/types/text.ts:23

Bold style

Default

false

Inherited from

ChartPropsTitle.bold

---

breakLine?

optional breakLine?: boolean

Defined in: src/types/text.ts:28

Add a line-break

Default

false

Inherited from

ChartPropsTitle.breakLine

---

bullet?

optional bullet?: boolean | "inherit" | { characterCode?: string; color?: string; fontFace?: string; image?: { data?: string; path?: string; }; indent?: number; numberStartAt?: number; numberType?: "alphaLcParenBoth" | "alphaLcParenR" | "alphaLcPeriod" | "alphaUcParenBoth" | "alphaUcParenR" | "alphaUcPeriod" | "arabicParenBoth" | "arabicParenR" | "arabicPeriod" | "arabicPlain" | "romanLcParenBoth" | "romanLcParenR" | "romanLcPeriod" | "romanUcParenBoth" | "romanUcParenR" | "romanUcPeriod"; size?: number; type?: "number" | "bullet"; }

Defined in: src/types/text.ts:53

Add standard or custom bullet

• use true for standard bullet
• pass object options for custom bullet
• false (and omitting the option) is the explicit off: it writes <a:buNone/> plus marL="0" indent="0", which overrides whatever bullet the layout's or master's list style sets for this level
• 'inherit' states nothing at all — no bullet child and no margin attributes — so the list style keeps reaching the paragraph. This is the one state omission cannot spell, because omitting the option means false here for compatibility

The margins are only a default of the bullet state: paraMarginLeft and paraIndent state @marL/@indent independently in any of the three, including an inherited margin under a drawn bullet.

Union Members

boolean

---

"inherit"

---

Type Literal

{ characterCode?: string; color?: string; fontFace?: string; image?: { data?: string; path?: string; }; indent?: number; numberStartAt?: number; numberType?: "alphaLcParenBoth" | "alphaLcParenR" | "alphaLcPeriod" | "alphaUcParenBoth" | "alphaUcParenR" | "alphaUcPeriod" | "arabicParenBoth" | "arabicParenR" | "arabicPeriod" | "arabicPlain" | "romanLcParenBoth" | "romanLcParenR" | "romanLcPeriod" | "romanUcParenBoth" | "romanUcParenR" | "romanUcPeriod"; size?: number; type?: "number" | "bullet"; }

characterCode?

optional characterCode?: string

Bullet character code (unicode)

Example

'25BA' // 'BLACK RIGHT-POINTING POINTER' (U+25BA)

color?

optional color?: string

Bullet glyph color (separate from the text run color)

Example

'FF0000' // red bullet

fontFace?

optional fontFace?: string

Bullet glyph font typeface (<a:buFont/>), e.g. for symbol-font bullets

Example

'Wingdings' // render `characterCode` using the Wingdings font

image?

optional image?: object

Image to use as the bullet glyph ("picture bullet", <a:buBlip>)

• supply an image path (filesystem/URL) or base64 data (same forms as addImage())
• raster formats (PNG/JPG/GIF) and SVG are supported; use size to scale relative to the text height
• SVG bullets embed a PNG preview plus the SVG (the same dual-rel handling as addImage())
• takes precedence over type/characterCode when set

Examples

image: { path: 'images/star.png' }

image: { data: 'image/png;base64,iVBOR...' }

image: { path: 'images/star.svg' }

image.data?

optional data?: string

image.path?

optional path?: string

indent?

optional indent?: number

Indentation (space between bullet and text) (points)

Default

27 // DEF_BULLET_MARGIN

Example

10 // Indents text 10 points from bullet

numberStartAt?

optional numberStartAt?: number

Number bullets start at

Default

1

Example

10 // numbered bullets start with 10

numberType?

optional numberType?: "alphaLcParenBoth" | "alphaLcParenR" | "alphaLcPeriod" | "alphaUcParenBoth" | "alphaUcParenR" | "alphaUcPeriod" | "arabicParenBoth" | "arabicParenR" | "arabicPeriod" | "arabicPlain" | "romanLcParenBoth" | "romanLcParenR" | "romanLcPeriod" | "romanUcParenBoth" | "romanUcParenR" | "romanUcPeriod"

Number type

Example

'romanLcParenR' // roman numerals lower-case with paranthesis right

size?

optional size?: number

Bullet glyph size as a percentage of the run's text size (25–400)

Default

100

Example

80 // bullet glyph is 80% of the text size

type?

optional type?: "number" | "bullet"

Bullet type

Default

bullet

Default

false

Inherited from

ChartPropsTitle.bullet

---

cap?

optional cap?: LineCap

Defined in: src/types/chart.ts:162

MS-PPT > Chart format > Format Major Gridlines > Line > Cap type

• line cap type

Default

flat

Inherited from

OptsChartGridLine.cap

---

caps?

optional caps?: "small" | "all" | "none"

Defined in: src/types/text.ts:149

Text capitalization (a:rPr/@cap, ST_TextCapsType)

• 'all' = ALL CAPS
• 'small' = Small Caps
• 'none' = the explicit off: it writes cap="none", which overrides a capitalization the run would otherwise inherit. Omitting the option states nothing and lets that inheritance stand
• PowerPoint: Font > Effects > All Caps / Small Caps

Default

(unset) inherit

Inherited from

ChartPropsTitle.caps

---

catAxes?

optional catAxes?: ChartPropsAxisCat[]

Defined in: src/types/chart.ts:330

Multi-Chart prop: array of cat axes

Inherited from

ChartPropsAxisCat.catAxes

---

catAxisBaseTimeUnit?

optional catAxisBaseTimeUnit?: string

Defined in: src/types/chart.ts:331

Inherited from

ChartPropsAxisCat.catAxisBaseTimeUnit

---

catAxisCrossesAt?

optional catAxisCrossesAt?: number | "autoZero"

Defined in: src/types/chart.ts:332

Inherited from

ChartPropsAxisCat.catAxisCrossesAt

---

catAxisHidden?

optional catAxisHidden?: boolean

Defined in: src/types/chart.ts:333

Inherited from

ChartPropsAxisCat.catAxisHidden

---

catAxisLabelColor?

optional catAxisLabelColor?: string

Defined in: src/types/chart.ts:334

Inherited from

ChartPropsAxisCat.catAxisLabelColor

---

catAxisLabelFontBold?

optional catAxisLabelFontBold?: boolean

Defined in: src/types/chart.ts:335

Inherited from

ChartPropsAxisCat.catAxisLabelFontBold

---

catAxisLabelFontFace?

optional catAxisLabelFontFace?: string

Defined in: src/types/chart.ts:336

Inherited from

ChartPropsAxisCat.catAxisLabelFontFace

---

catAxisLabelFontItalic?

optional catAxisLabelFontItalic?: boolean

Defined in: src/types/chart.ts:337

Inherited from

ChartPropsAxisCat.catAxisLabelFontItalic

---

catAxisLabelFontSize?

optional catAxisLabelFontSize?: number

Defined in: src/types/chart.ts:338

Inherited from

ChartPropsAxisCat.catAxisLabelFontSize

---

catAxisLabelFormatCode?

optional catAxisLabelFormatCode?: string

Defined in: src/types/chart.ts:345

Number format code for the category (X) axis labels on scatter and bubble charts. Falls back to valAxisLabelFormatCode when not set.

• Example: '0.00', '#,##0', 'mmm yyyy'
• PowerPoint: Format Axis > Number > Format Code

Inherited from

ChartPropsAxisCat.catAxisLabelFormatCode

---

catAxisLabelFrequency?

optional catAxisLabelFrequency?: string

Defined in: src/types/chart.ts:346

Inherited from

ChartPropsAxisCat.catAxisLabelFrequency

---

catAxisLabelPos?

optional catAxisLabelPos?: "none" | "high" | "low" | "nextTo"

Defined in: src/types/chart.ts:347

Inherited from

ChartPropsAxisCat.catAxisLabelPos

---

catAxisLabelRotate?

optional catAxisLabelRotate?: number

Defined in: src/types/chart.ts:348

Inherited from

ChartPropsAxisCat.catAxisLabelRotate

---

catAxisLineColor?

optional catAxisLineColor?: string

Defined in: src/types/chart.ts:349

Inherited from

ChartPropsAxisCat.catAxisLineColor

---

catAxisLineShow?

optional catAxisLineShow?: boolean

Defined in: src/types/chart.ts:350

Inherited from

ChartPropsAxisCat.catAxisLineShow

---

catAxisLineSize?

optional catAxisLineSize?: number

Defined in: src/types/chart.ts:351

Inherited from

ChartPropsAxisCat.catAxisLineSize

---

catAxisLineStyle?

optional catAxisLineStyle?: "dash" | "solid" | "dot"

Defined in: src/types/chart.ts:352

Inherited from

ChartPropsAxisCat.catAxisLineStyle

---

catAxisMajorTickMark?

optional catAxisMajorTickMark?: ChartAxisTickMark

Defined in: src/types/chart.ts:353

Inherited from

ChartPropsAxisCat.catAxisMajorTickMark

---

catAxisMajorTimeUnit?

optional catAxisMajorTimeUnit?: string

Defined in: src/types/chart.ts:354

Inherited from

ChartPropsAxisCat.catAxisMajorTimeUnit

---

catAxisMajorUnit?

optional catAxisMajorUnit?: number

Defined in: src/types/chart.ts:355

Inherited from

ChartPropsAxisCat.catAxisMajorUnit

---

catAxisMaxVal?

optional catAxisMaxVal?: number

Defined in: src/types/chart.ts:356

Inherited from

ChartPropsAxisCat.catAxisMaxVal

---

catAxisMinorTickMark?

optional catAxisMinorTickMark?: ChartAxisTickMark

Defined in: src/types/chart.ts:357

Inherited from

ChartPropsAxisCat.catAxisMinorTickMark

---

catAxisMinorTimeUnit?

optional catAxisMinorTimeUnit?: string

Defined in: src/types/chart.ts:358

Inherited from

ChartPropsAxisCat.catAxisMinorTimeUnit

---

catAxisMinorUnit?

optional catAxisMinorUnit?: number

Defined in: src/types/chart.ts:359

Inherited from

ChartPropsAxisCat.catAxisMinorUnit

---

catAxisMinVal?

optional catAxisMinVal?: number

Defined in: src/types/chart.ts:360

Inherited from

ChartPropsAxisCat.catAxisMinVal

---

catAxisMultiLevelLabels?

optional catAxisMultiLevelLabels?: boolean

Defined in: src/types/chart.ts:361

Inherited from

ChartPropsAxisCat.catAxisMultiLevelLabels

---

catAxisOrientation?

optional catAxisOrientation?: "minMax" | "maxMin"

Defined in: src/types/chart.ts:362

Inherited from

ChartPropsAxisCat.catAxisOrientation

---

catAxisTitle?

optional catAxisTitle?: string

Defined in: src/types/chart.ts:363

Inherited from

ChartPropsAxisCat.catAxisTitle

---

catAxisTitleColor?

optional catAxisTitleColor?: string

Defined in: src/types/chart.ts:364

Inherited from

ChartPropsAxisCat.catAxisTitleColor

---

catAxisTitleFontFace?

optional catAxisTitleFontFace?: string

Defined in: src/types/chart.ts:365

Inherited from

ChartPropsAxisCat.catAxisTitleFontFace

---

catAxisTitleFontSize?

optional catAxisTitleFontSize?: number

Defined in: src/types/chart.ts:366

Inherited from

ChartPropsAxisCat.catAxisTitleFontSize

---

catAxisTitleRotate?

optional catAxisTitleRotate?: number

Defined in: src/types/chart.ts:367

Inherited from

ChartPropsAxisCat.catAxisTitleRotate

---

catGridLine?

optional catGridLine?: OptsChartGridLine

Defined in: src/types/chart.ts:368

Inherited from

ChartPropsAxisCat.catGridLine

---

catLabelFormatCode?

optional catLabelFormatCode?: string

Defined in: src/types/chart.ts:369

Inherited from

ChartPropsAxisCat.catLabelFormatCode

---

chartArea?

optional chartArea?: ChartAreaProps

Defined in: src/types/chart.ts:313

PowerPoint: Format Chart Area (Fill & Border/Line)

Inherited from

ChartPropsBase.chartArea

---

chartColors?

optional chartColors?: string[]

Defined in: src/types/chart.ts:220

Inherited from

ChartPropsBase.chartColors

---

chartColorsOpacity?

optional chartColorsOpacity?: number

Defined in: src/types/chart.ts:225

opacity (0 - 100)

Example

50 // 50% opaque

Inherited from

ChartPropsBase.chartColorsOpacity

---

color?

optional color?: string

Defined in: src/types/text.ts:157

Text color

• HexColor or ThemeColor
• MS-PPT > Format Shape > Text Options > Text Fill & Outline > Text Fill > Color

Examples

'FF0000' // hex color (red)

SchemeColor.text1 // Theme color (Text1)

Inherited from

ChartPropsTitle.color

---

dataBorder?

optional dataBorder?: BorderProps

Defined in: src/types/chart.ts:226

Inherited from

ChartPropsBase.dataBorder

---

dataLabelBkgrdColors?

optional dataLabelBkgrdColors?: boolean

Defined in: src/types/chart.ts:735

Inherited from

ChartPropsDataLabel.dataLabelBkgrdColors

---

dataLabelColor?

optional dataLabelColor?: string

Defined in: src/types/chart.ts:736

Inherited from

ChartPropsDataLabel.dataLabelColor

---

dataLabelFontBold?

optional dataLabelFontBold?: boolean

Defined in: src/types/chart.ts:737

Inherited from

ChartPropsDataLabel.dataLabelFontBold

---

dataLabelFontFace?

optional dataLabelFontFace?: string

Defined in: src/types/chart.ts:738

Inherited from

ChartPropsDataLabel.dataLabelFontFace

---

dataLabelFontItalic?

optional dataLabelFontItalic?: boolean

Defined in: src/types/chart.ts:739

Inherited from

ChartPropsDataLabel.dataLabelFontItalic

---

dataLabelFontSize?

optional dataLabelFontSize?: number

Defined in: src/types/chart.ts:740

Inherited from

ChartPropsDataLabel.dataLabelFontSize

---

dataLabelFormatCode?

optional dataLabelFormatCode?: string

Defined in: src/types/chart.ts:747

Data label format code

Examples

'#%' // round percent

'0.00%' // shows values as '0.00%'

'$0.00' // shows values as '$0.00'

Inherited from

ChartPropsDataLabel.dataLabelFormatCode

---

dataLabelFormatScatter?

optional dataLabelFormatScatter?: "custom" | "customXY" | "XY"

Defined in: src/types/chart.ts:748

Inherited from

ChartPropsDataLabel.dataLabelFormatScatter

---

dataLabelPosition?

optional dataLabelPosition?: "r" | "b" | "ctr" | "t" | "l" | "bestFit" | "inEnd" | "outEnd"

Defined in: src/types/chart.ts:749

Inherited from

ChartPropsDataLabel.dataLabelPosition

---

dataNoEffects?

optional dataNoEffects?: boolean

Defined in: src/types/chart.ts:507

Inherited from

ChartPropsChartDoughnut.dataNoEffects

---

dataTableFontSize?

optional dataTableFontSize?: number

Defined in: src/types/chart.ts:752

Inherited from

ChartPropsDataTable.dataTableFontSize

---

dataTableFormatCode?

optional dataTableFormatCode?: string

Defined in: src/types/chart.ts:759

Data table format code

Examples

'#%' // round percent

'0.00%' // shows values as '0.00%'

'$0.00' // shows values as '$0.00'

Inherited from

ChartPropsDataTable.dataTableFormatCode

---

displayBlanksAs?

optional displayBlanksAs?: "zero" | "gap" | "span"

Defined in: src/types/chart.ts:227

Inherited from

ChartPropsBase.displayBlanksAs

---

firstSliceAng?

optional firstSliceAng?: number

Defined in: src/types/chart.ts:576

MS-PPT > Format chart > Format Data Series > Series Options > "Angle of first slice"

• angle (degrees)
• range: 0-359

Default

0

Inherited from

ChartPropsChartPie.firstSliceAng

---

fontFace?

optional fontFace?: string

Defined in: src/types/text.ts:167

Font face name

Applied to the Latin (<a:latin>) and complex-script (<a:cs>) font slots, matching how PowerPoint writes a font picked from the UI. The East Asian slot (<a:ea>) is left to inherit from the theme unless fontFaceEA is set — forcing a Latin-only face into the East Asian slot duplicates/ghosts text in Office 365.

Example

'Arial' // Arial font

Inherited from

ChartPropsTitle.fontFace

---

fontFaceEA?

optional fontFaceEA?: string

Defined in: src/types/text.ts:175

East Asian font face name (<a:ea> slot), used to render CJK (Chinese/Japanese/Korean) glyphs

Set this when the East Asian font differs from fontFace. When omitted, <a:ea> inherits the theme East Asian font, which is what PowerPoint does for Latin fonts.

Example

'微軟正黑體' // render East Asian glyphs with Microsoft JhengHei

Inherited from

ChartPropsTitle.fontFaceEA

---

fontSize?

optional fontSize?: number

Defined in: src/types/text.ts:180

Font size

Example

12 // Font size 12

Inherited from

ChartPropsTitle.fontSize

---

geography?

optional geography?: ChartExGeography

Defined in: src/types/chart.ts:671

Geography configuration for a regionMap chart. Omit for PowerPoint's defaults (cultureLanguage: 'en-US', cultureRegion: 'US').

Example

{ cultureLanguage: 'en-US', cultureRegion: 'FR' }

Inherited from

ChartPropsChartRegionMap.geography

---

h?

optional h?: Coord

Defined in: src/types/core.ts:49

Height

• inches or percentage

Examples

10.25 // height in inches

'75%' // height as percentage of slide size

Inherited from

PositionProps.h

---

highlight?

optional highlight?: string

Defined in: src/types/text.ts:185

Text highlight color (hex format)

Example

'FFFF00' // yellow

Inherited from

ChartPropsTitle.highlight

---

holeSize?

optional holeSize?: number

Defined in: src/types/chart.ts:508

Inherited from

ChartPropsChartDoughnut.holeSize

---

invertedColors?

optional invertedColors?: string[]

Defined in: src/types/chart.ts:228

Inherited from

ChartPropsBase.invertedColors

---

italic?

optional italic?: boolean

Defined in: src/types/text.ts:190

italic style

Default

false

Inherited from

ChartPropsTitle.italic

---

lang?

optional lang?: string

Defined in: src/types/chart.ts:229

language

• ISO 639-1 standard language code

Default

'en-US' // english US

Example

'fr-CA' // french Canadian

Inherited from

ChartPropsBase.lang

---

layout?

optional layout?: PositionProps

Defined in: src/types/chart.ts:230

Inherited from

ChartPropsBase.layout

---

leaderLineColor?

optional leaderLineColor?: string

Defined in: src/types/chart.ts:255

Leader line color (pie/doughnut data labels). Requires showLeaderLines: true. When omitted, PowerPoint applies its automatic leader-line color.

Example

'FF0000' // red leader lines

Inherited from

ChartPropsBase.leaderLineColor

---

leaderLineSize?

optional leaderLineSize?: number

Defined in: src/types/chart.ts:261

Leader line width, in points (pie/doughnut data labels). Requires showLeaderLines: true.

Default

0.75

Example

1.5

Inherited from

ChartPropsBase.leaderLineSize

---

legendColor?

optional legendColor?: string

Defined in: src/types/chart.ts:771

Inherited from

ChartPropsLegend.legendColor

---

legendFontFace?

optional legendFontFace?: string

Defined in: src/types/chart.ts:772

Inherited from

ChartPropsLegend.legendFontFace

---

legendFontSize?

optional legendFontSize?: number

Defined in: src/types/chart.ts:773

Inherited from

ChartPropsLegend.legendFontSize

---

legendLayout?

optional legendLayout?: PositionProps

Defined in: src/types/chart.ts:787

Manual legend placement within the chart area.

Each of x/y/w/h is a fraction (0-1) of the chart's width/height. x/y position the legend's top-left corner relative to the chart edge; w/h set its size. Each axis is independent: provide only x to move the legend horizontally while leaving vertical placement and size automatic. Setting this overrides the automatic placement implied by legendPos.

Has no effect unless showLegend is true.

Example

{ x: 0.7, y: 0.3, w: 0.25, h: 0.4 }

Inherited from

ChartPropsLegend.legendLayout

---

legendPos?

optional legendPos?: "r" | "b" | "tr" | "t" | "l"

Defined in: src/types/chart.ts:788

Inherited from

ChartPropsLegend.legendPos

---

lineCap?

optional lineCap?: LineCap

Defined in: src/types/chart.ts:516

MS-PPT > Chart format > Format Data Series > Line > Cap type

• line cap type

Default

flat

Inherited from

ChartPropsChartLine.lineCap

---

lineDash?

optional lineDash?: ChartLineDash

Defined in: src/types/chart.ts:522

MS-PPT > Chart format > Format Data Series > Line > Dash type (chart-level default)

• applies to every series that has no entry in lineDashValues

Default

solid

Inherited from

ChartPropsChartLine.lineDash

---

lineDashValues?

optional lineDashValues?: ChartLineDash[]

Defined in: src/types/chart.ts:528

Per-series dash type overrides; index matches the series order in the data array.

• entries shorter than the series count fall back to lineDash
• example: ['solid', 'dash', 'lgDash'] gives each series its own dash pattern

Inherited from

ChartPropsChartLine.lineDashValues

---

lineDataSymbol?

optional lineDataSymbol?: "none" | "square" | "triangle" | "circle" | "diamond" | "dash" | "dot"

Defined in: src/types/chart.ts:534

MS-PPT > Chart format > Format Data Series > Marker Options > Built-in > Type

• marker type

Default

circle

Inherited from

ChartPropsChartLine.lineDataSymbol

---

lineDataSymbolLineColor?

optional lineDataSymbolLineColor?: string

Defined in: src/types/chart.ts:540

MS-PPT > Chart format > Format Data Series > [Marker Options] > Border > Color

• border color

Default

circle

Inherited from

ChartPropsChartLine.lineDataSymbolLineColor

---

lineDataSymbolLineSize?

optional lineDataSymbolLineSize?: number

Defined in: src/types/chart.ts:546

MS-PPT > Chart format > Format Data Series > [Marker Options] > Border > Width

• border width (points)

Default

0.75

Inherited from

ChartPropsChartLine.lineDataSymbolLineSize

---

lineDataSymbolSize?

optional lineDataSymbolSize?: number

Defined in: src/types/chart.ts:553

MS-PPT > Chart format > Format Data Series > Marker Options > Built-in > Size

• marker size
• range: 2-72

Default

6

Inherited from

ChartPropsChartLine.lineDataSymbolSize

---

lineSize?

optional lineSize?: number

Defined in: src/types/chart.ts:560

MS-PPT > Chart format > Format Data Series > Line > Width

• line width (points)
• range: 0-1584

Default

2

Inherited from

ChartPropsChartLine.lineSize

---

lineSmooth?

optional lineSmooth?: boolean

Defined in: src/types/chart.ts:566

MS-PPT > Chart format > Format Data Series > Line > Smoothed line

• "Smoothed line"

Default

false

Inherited from

ChartPropsChartLine.lineSmooth

---

metadata?

optional metadata?: Record<string, string>

Defined in: src/types/chart.ts:851

Custom chart-level metadata, emitted as a schema-valid extension on the chart space (c:chartSpace/c:extLst) under a stable ts-pptx vendor GUID.

• Use for round-trippable, machine-readable annotations a consumer wants to travel with the chart (e.g. a source-data id, a generator tag, a semantic role). PowerPoint preserves the extension untouched and ignores it for rendering.
• Keys must be non-empty strings; values must be strings. Invalid entries are dropped with a console warning rather than emitting degenerate XML.

Example

{ sourceId: 'q3-revenue', generator: 'my-deck-tool' }

---

objectLock?

optional objectLock?: ObjectLockProps

Defined in: src/types/object.ts:54

Object lock flags (DrawingML a:spLocks / a:picLocks / a:graphicFrameLocks)

• restrict how the object can be manipulated in PowerPoint (e.g. prevent moving, resizing, or grouping)
• each flag maps 1:1 to the OOXML attribute of the same name; only flags set to true are emitted
• PowerPoint UI: Selection Pane / right-click protections (most locks are honored at edit time, not as a password)
• flags only apply to the object types that support them (see each flag); flags set on an unsupported object type are ignored with a console warning

Examples

{ noMove: true, noResize: true } // pin an object in place

{ noGrp: true } // exclude from grouping

Inherited from

ObjectNameProps.objectLock

---

objectName?

optional objectName?: string

Defined in: src/types/object.ts:36

Object name

• used instead of default "Object N" name
• PowerPoint: Home > Arrange > Selection Pane...

Default

'Object 1'

Example

'Antenna Design 9'

Inherited from

ObjectNameProps.objectName

---

paraIndent?

optional paraIndent?: number | "inherit"

Defined in: src/types/text.ts:214

First-line indent (points) — a:pPr/@indent, the offset of the paragraph's FIRST line from paraMarginLeft. Negative hangs the first line to the left of the body, which is what a bulleted paragraph does; positive indents it to the right, the "first line indented" prose form. PowerPoint: Paragraph > Indentation > Special.

• 'inherit' writes no @indent at all, so the paragraph takes whatever its list style (a:lstStyle → placeholder → layout → master) sets — the same third state bullet spells, on the attribute beside it
• omitting the option keeps the bullet-derived default: a drawn bullet hangs the first line by its margin, bullet: false writes indent="0", bullet: 'inherit' writes nothing
• a value here overrides all of those, in every bullet state

Examples

-18 // hang the first line 18pt left of the body text

18 // indent the first line 18pt, prose style

'inherit' // keep the list style's indent, even on a bulleted paragraph

Inherited from

ChartPropsTitle.paraIndent

---

paraMarginLeft?

optional paraMarginLeft?: number | "inherit"

Defined in: src/types/text.ts:229

Left margin of the paragraph (points) — a:pPr/@marL, where the paragraph's body text starts. This is the paragraph's own margin, not the text frame's internal padding (margin) and not the discrete outline level (indentLevel, which writes a:p/@lvl). PowerPoint: Paragraph > Indentation > Before text.

• 'inherit' writes no @marL at all, so the paragraph takes whatever its list style (a:lstStyle → placeholder → layout → master) sets — the third state that omission cannot spell, since omitting it writes the bullet-derived default
• omitting the option keeps that default: a drawn bullet writes its own margin (see bullet.indent), bullet: false writes marL="0", bullet: 'inherit' writes nothing
• a value here overrides all of those, in every bullet state

Examples

36 // body text starts 36pt (0.5in) from the frame's text edge

'inherit' // keep the list style's margin, even on a bulleted paragraph

Inherited from

ChartPropsTitle.paraMarginLeft

---

plotArea?

optional plotArea?: ChartPropsFillLine

Defined in: src/types/chart.ts:317

PowerPoint: Format Plot Area (Fill & Border/Line)

Inherited from

ChartPropsBase.plotArea

---

radarStyle?

optional radarStyle?: "radar" | "markers" | "filled"

Defined in: src/types/chart.ts:584

Radar chart sub-type, named to match the PowerPoint UI ("Radar", "Radar with Markers", "Filled Radar").

Default

radar

Inherited from

ChartPropsChartRadar.radarStyle

---

secondaryCatAxis?

optional secondaryCatAxis?: boolean

Defined in: src/types/chart.ts:374

Whether data should use secondary category axis (instead of primary)

Default

false

Inherited from

ChartPropsAxisCat.secondaryCatAxis

---

secondaryValAxis?

optional secondaryValAxis?: boolean

Defined in: src/types/chart.ts:408

Whether data should use secondary value axis (instead of primary)

Default

false

Inherited from

ChartPropsAxisVal.secondaryValAxis

---

serAxisBaseTimeUnit?

optional serAxisBaseTimeUnit?: string

Defined in: src/types/chart.ts:378

Inherited from

ChartPropsAxisSer.serAxisBaseTimeUnit

---

serAxisHidden?

optional serAxisHidden?: boolean

Defined in: src/types/chart.ts:379

Inherited from

ChartPropsAxisSer.serAxisHidden

---

serAxisLabelColor?

optional serAxisLabelColor?: string

Defined in: src/types/chart.ts:380

Inherited from

ChartPropsAxisSer.serAxisLabelColor

---

serAxisLabelFontBold?

optional serAxisLabelFontBold?: boolean

Defined in: src/types/chart.ts:381

Inherited from

ChartPropsAxisSer.serAxisLabelFontBold

---

serAxisLabelFontFace?

optional serAxisLabelFontFace?: string

Defined in: src/types/chart.ts:382

Inherited from

ChartPropsAxisSer.serAxisLabelFontFace

---

serAxisLabelFontItalic?

optional serAxisLabelFontItalic?: boolean

Defined in: src/types/chart.ts:383

Inherited from

ChartPropsAxisSer.serAxisLabelFontItalic

---

serAxisLabelFontSize?

optional serAxisLabelFontSize?: number

Defined in: src/types/chart.ts:384

Inherited from

ChartPropsAxisSer.serAxisLabelFontSize

---

serAxisLabelFrequency?

optional serAxisLabelFrequency?: string

Defined in: src/types/chart.ts:385

Inherited from

ChartPropsAxisSer.serAxisLabelFrequency

---

serAxisLabelPos?

optional serAxisLabelPos?: "none" | "high" | "low" | "nextTo"

Defined in: src/types/chart.ts:386

Inherited from

ChartPropsAxisSer.serAxisLabelPos

---

serAxisLineColor?

optional serAxisLineColor?: string

Defined in: src/types/chart.ts:387

Inherited from

ChartPropsAxisSer.serAxisLineColor

---

serAxisLineShow?

optional serAxisLineShow?: boolean

Defined in: src/types/chart.ts:388

Inherited from

ChartPropsAxisSer.serAxisLineShow

---

serAxisMajorTimeUnit?

optional serAxisMajorTimeUnit?: string

Defined in: src/types/chart.ts:389

Inherited from

ChartPropsAxisSer.serAxisMajorTimeUnit

---

serAxisMajorUnit?

optional serAxisMajorUnit?: number

Defined in: src/types/chart.ts:390

Inherited from

ChartPropsAxisSer.serAxisMajorUnit

---

serAxisMinorTimeUnit?

optional serAxisMinorTimeUnit?: string

Defined in: src/types/chart.ts:391

Inherited from

ChartPropsAxisSer.serAxisMinorTimeUnit

---

serAxisMinorUnit?

optional serAxisMinorUnit?: number

Defined in: src/types/chart.ts:392

Inherited from

ChartPropsAxisSer.serAxisMinorUnit

---

serAxisOrientation?

optional serAxisOrientation?: string

Defined in: src/types/chart.ts:393

Inherited from

ChartPropsAxisSer.serAxisOrientation

---

serAxisTitle?

optional serAxisTitle?: string

Defined in: src/types/chart.ts:394

Inherited from

ChartPropsAxisSer.serAxisTitle

---

serAxisTitleColor?

optional serAxisTitleColor?: string

Defined in: src/types/chart.ts:395

Inherited from

ChartPropsAxisSer.serAxisTitleColor

---

serAxisTitleFontFace?

optional serAxisTitleFontFace?: string

Defined in: src/types/chart.ts:396

Inherited from

ChartPropsAxisSer.serAxisTitleFontFace

---

serAxisTitleFontSize?

optional serAxisTitleFontSize?: number

Defined in: src/types/chart.ts:397

Inherited from

ChartPropsAxisSer.serAxisTitleFontSize

---

serAxisTitleRotate?

optional serAxisTitleRotate?: number

Defined in: src/types/chart.ts:398

Inherited from

ChartPropsAxisSer.serAxisTitleRotate

---

serGridLine?

optional serGridLine?: OptsChartGridLine

Defined in: src/types/chart.ts:399

Inherited from

ChartPropsAxisSer.serGridLine

---

seriesOptions?

optional seriesOptions?: ChartSeriesOpts[]

Defined in: src/types/chart.ts:324

Per-series style overrides. Element at index N applies to the series at data[N]. Missing indices or unset fields fall back to the chart-level option.

Inherited from

ChartPropsBase.seriesOptions

---

serLabelFormatCode?

optional serLabelFormatCode?: string

Defined in: src/types/chart.ts:400

Inherited from

ChartPropsAxisSer.serLabelFormatCode

---

shadow?

optional shadow?: ShadowProps

Defined in: src/types/chart.ts:231

Inherited from

ChartPropsBase.shadow

---

showBubbleSize?

optional showBubbleSize?: boolean

Defined in: src/types/chart.ts:237

Show each bubble's size value as a data label (bubble / bubble3D charts only). Has no effect on other chart types.

Default

false

Inherited from

ChartPropsBase.showBubbleSize

---

showCatAxisTitle?

optional showCatAxisTitle?: boolean

Defined in: src/types/chart.ts:375

Inherited from

ChartPropsAxisCat.showCatAxisTitle

---

showDataTable?

optional showDataTable?: boolean

Defined in: src/types/chart.ts:764

Whether to show a data table adjacent to the chart

Default

false

Inherited from

ChartPropsDataTable.showDataTable

---

showDataTableHorzBorder?

optional showDataTableHorzBorder?: boolean

Defined in: src/types/chart.ts:765

Inherited from

ChartPropsDataTable.showDataTableHorzBorder

---

showDataTableKeys?

optional showDataTableKeys?: boolean

Defined in: src/types/chart.ts:766

Inherited from

ChartPropsDataTable.showDataTableKeys

---

showDataTableOutline?

optional showDataTableOutline?: boolean

Defined in: src/types/chart.ts:767

Inherited from

ChartPropsDataTable.showDataTableOutline

---

showDataTableVertBorder?

optional showDataTableVertBorder?: boolean

Defined in: src/types/chart.ts:768

Inherited from

ChartPropsDataTable.showDataTableVertBorder

---

showLabel?

optional showLabel?: boolean

Defined in: src/types/chart.ts:248

Enable data labels, with a meaning that is overloaded per plot type — it is not a plain duplicate of ChartPropsBase.showValue:

• pie / doughnut: shows the category name (c:showCatName);
• scatter: shows both the value and the category name;
• chartEx (waterfall/funnel/…): OR-combined with showValue to show the value label.

For the common "show the numeric value" case on standard plots, prefer showValue.

Default

false

Inherited from

ChartPropsBase.showLabel

---

showLeaderLines?

optional showLeaderLines?: boolean

Defined in: src/types/chart.ts:249

Inherited from

ChartPropsBase.showLeaderLines

---

showLegend?

optional showLegend?: boolean

Defined in: src/types/chart.ts:265

Default

false

Inherited from

ChartPropsBase.showLegend

---

showPercent?

optional showPercent?: boolean

Defined in: src/types/chart.ts:269

Default

false

Inherited from

ChartPropsBase.showPercent

---

showSerAxisTitle?

optional showSerAxisTitle?: boolean

Defined in: src/types/chart.ts:401

Inherited from

ChartPropsAxisSer.showSerAxisTitle

---

showSerName?

optional showSerName?: boolean

Defined in: src/types/chart.ts:273

Default

false

Inherited from

ChartPropsBase.showSerName

---

showTitle?

optional showTitle?: boolean

Defined in: src/types/chart.ts:277

Default

false

Inherited from

ChartPropsBase.showTitle

---

showValAxisTitle?

optional showValAxisTitle?: boolean

Defined in: src/types/chart.ts:409

Inherited from

ChartPropsAxisVal.showValAxisTitle

---

showValue?

optional showValue?: boolean

Defined in: src/types/chart.ts:281

Default

false

Inherited from

ChartPropsBase.showValue

---

size?

optional size?: number

Defined in: src/types/chart.ts:173

Gridline size (points)

Inherited from

OptsChartGridLine.size

---

softBreakBefore?

optional softBreakBefore?: boolean

Defined in: src/types/text.ts:234

Add a soft line-break (shift+enter) before line text content

Default

false

Inherited from

ChartPropsTitle.softBreakBefore

---

statistics?

optional statistics?: ChartExStatistics

Defined in: src/types/chart.ts:647

Statistics configuration for a boxWhisker chart. Omit for PowerPoint's defaults (exclusive quartiles, mean marker shown, outliers shown).

Example

{ quartileMethod: 'inclusive', meanLine: true }

Inherited from

ChartPropsChartBoxWhisker.statistics

---

stockStyle?

optional stockStyle?: "hlc" | "ohlc" | "vhlc" | "vohlc"

Defined in: src/types/chart.ts:685

Stock (high-low-close) chart style — selects how many value series the chart expects and how they are drawn. The data series must be supplied in the exact order implied by the style:

• 'hlc' — High, Low, Close (3 series). The close is marked with a dot.
• 'ohlc' — Open, High, Low, Close (4 series). Open→close is drawn as up/down bars.
• 'vhlc' — Volume, High, Low, Close (4 series). Volume is a column on its own axis.
• 'vohlc' — Volume, Open, High, Low, Close (5 series). Volume column + up/down bars.

<c:hiLowLines> connect the high/low of each category in every style.

Default

'hlc'

Inherited from

ChartPropsChartStock.stockStyle

---

style?

optional style?: "none" | "dash" | "solid" | "dot"

Defined in: src/types/chart.ts:177

Gridline style

Inherited from

OptsChartGridLine.style

---

subtotals?

optional subtotals?: number[]

Defined in: src/types/chart.ts:599

Zero-based category indices to render as subtotal/total columns in a waterfall chart (columns anchored to the axis baseline rather than floating from the running cumulative value). Out-of-range or non-integer entries are dropped with a console warning.

Example

[0, 4] // first and fifth categories are totals

Inherited from

ChartPropsChartWaterfall.subtotals

---

surface3D?

optional surface3D?: boolean

Defined in: src/types/chart.ts:693

Draw a 3-D surface (<c:surface3DChart>) rather than a 2-D contour / top view (<c:surfaceChart>). The 3-D surface tilts the scene; the contour looks straight down.

Default

true

Inherited from

ChartPropsChartSurface.surface3D

---

surfaceWireframe?

optional surfaceWireframe?: boolean

Defined in: src/types/chart.ts:699

Draw the surface as a wireframe mesh (<c:wireframe val="1"/>) instead of a filled sheet. Applies to both the 3-D surface and the 2-D contour.

Default

false

Inherited from

ChartPropsChartSurface.surfaceWireframe

---

tabStops?

optional tabStops?: object[]

Defined in: src/types/text.ts:240

tab stops

• PowerPoint: Paragraph > Tabs > Tab stop position

alignment?

optional alignment?: "r" | "ctr" | "l" | "dec"

position

position: number

Example

[{ position:1 }, { position:3 }] // Set first tab stop to 1 inch, set second tab stop to 3 inches

Inherited from

ChartPropsTitle.tabStops

---

textDirection?

optional textDirection?: "horz" | "vert" | "vert270" | "wordArtVert"

Defined in: src/types/text.ts:249

text direction horz = horizontal vert = rotate 90^ vert270 = rotate 270^ wordArtVert = stacked

Default

'horz'

Inherited from

ChartPropsTitle.textDirection

---

textWarp?

optional textWarp?: string

Defined in: src/types/text.ts:36

Preset text warp / WordArt shape (<a:bodyPr><a:prstTxWarp prst="..">), which bends the text along a preset path (arch, circle, wave, …). The value is an OOXML ST_TextShapeType preset name.

Examples

'textArchUp' // bend text along an upward arch (e.g. a label following a ring/arc)

'textCircle'

Inherited from

ChartPropsTitle.textWarp

---

title?

optional title?: string

Defined in: src/types/chart.ts:791

Inherited from

ChartPropsTitle.title

---

titleAlign?

optional titleAlign?: string

Defined in: src/types/chart.ts:792

Inherited from

ChartPropsTitle.titleAlign

---

titleBold?

optional titleBold?: boolean

Defined in: src/types/chart.ts:793

Inherited from

ChartPropsTitle.titleBold

---

titleColor?

optional titleColor?: string

Defined in: src/types/chart.ts:794

Inherited from

ChartPropsTitle.titleColor

---

titleFontFace?

optional titleFontFace?: string

Defined in: src/types/chart.ts:795

Inherited from

ChartPropsTitle.titleFontFace

---

titleFontSize?

optional titleFontSize?: number

Defined in: src/types/chart.ts:796

Inherited from

ChartPropsTitle.titleFontSize

---

titleItalic?

optional titleItalic?: boolean

Defined in: src/types/chart.ts:797

Inherited from

ChartPropsTitle.titleItalic

---

titlePos?

optional titlePos?: object

Defined in: src/types/chart.ts:804

Manual title position (inches), relative to the chart. Each axis is independent: omit x to keep automatic horizontal centering, or omit y to keep automatic vertical placement. Provide at least one.

x?

optional x?: number

y?

optional y?: number

Inherited from

ChartPropsTitle.titlePos

---

titleRotate?

optional titleRotate?: number

Defined in: src/types/chart.ts:805

Inherited from

ChartPropsTitle.titleRotate

---

titleUnderline?

optional titleUnderline?: boolean

Defined in: src/types/chart.ts:798

Inherited from

ChartPropsTitle.titleUnderline

---

transparency?

optional transparency?: number

Defined in: src/types/text.ts:256

Transparency (percent)

• MS-PPT > Format Shape > Text Options > Text Fill & Outline > Text Fill > Transparency
• range: 0-100

Default

0

Inherited from

ChartPropsTitle.transparency

---

type?

optional type?: "area" | "line" | "bar" | "bar3D" | "bubble" | "bubble3D" | "doughnut" | "pie" | "radar" | "scatter" | "stock" | "surface" | "waterfall" | "funnel" | "treemap" | "sunburst" | "histogram" | "pareto" | "boxWhisker" | "regionMap"

Defined in: src/types/chart.ts:835

Chart type — required when using the canonical addChart(data, options) signature.

• Omit only for multi-type (combo) charts, where each ChartMulti entry carries its own type.

---

underline?

optional underline?: object

Defined in: src/types/text.ts:267

underline properties

• PowerPoint: Font > Color & Underline > Underline Style/Underline Color
• style is the full ST_TextUnderlineType enumeration (ECMA-376 §20.1.10.81)
• 'none' is the explicit off: it writes a:rPr/@u="none", which overrides an underline the run would otherwise inherit from its list style, placeholder, layout or master. Omitting the option instead states nothing and lets that inheritance stand — the two are different facts, not two spellings of one.

color?

optional color?: string

style?

optional style?: "none" | "dash" | "dashHeavy" | "dashLong" | "dashLongHeavy" | "dbl" | "dotDash" | "dotDashHeavy" | "dotDotDash" | "dotDotDashHeavy" | "dotted" | "dottedHeavy" | "heavy" | "sng" | "wavy" | "wavyDbl" | "wavyHeavy" | "words"

Default

(unset) inherit

Inherited from

ChartPropsTitle.underline

---

v3DPerspective?

optional v3DPerspective?: number

Defined in: src/types/chart.ts:287

3D Perspecitve

• range: 0-120

Default

30

Inherited from

ChartPropsBase.v3DPerspective

---

v3DRAngAx?

optional v3DRAngAx?: boolean

Defined in: src/types/chart.ts:295

Right Angle Axes

• Shows chart from first-person perspective
• Overrides v3DPerspective when true
• PowerPoint: Chart Options > 3-D Rotation

Default

false

Inherited from

ChartPropsBase.v3DRAngAx

---

v3DRotX?

optional v3DRotX?: number

Defined in: src/types/chart.ts:302

X Rotation

• PowerPoint: Chart Options > 3-D Rotation
• range: 0-359.9

Default

30

Inherited from

ChartPropsBase.v3DRotX

---

v3DRotY?

optional v3DRotY?: number

Defined in: src/types/chart.ts:308

Y Rotation

• range: 0-359.9

Default

30

Inherited from

ChartPropsBase.v3DRotY

---

valAxes?

optional valAxes?: ChartPropsAxisVal[]

Defined in: src/types/chart.ts:413

Multi-Chart prop: array of val axes

Inherited from

ChartPropsAxisVal.valAxes

---

valAxisCrossBetween?

optional valAxisCrossBetween?: "between" | "midCat"

Defined in: src/types/chart.ts:421

Controls where axis values are plotted relative to tick marks

• 'between' = values plotted between tick marks (default for bar/column/line)
• 'midCat' = values plotted on tick marks (default for scatter/area)
• PowerPoint: Format Axis > Axis Options > Axis crosses > On tick marks / Between tick marks

Inherited from

ChartPropsAxisVal.valAxisCrossBetween

---

valAxisCrossesAt?

optional valAxisCrossesAt?: number | "autoZero"

Defined in: src/types/chart.ts:414

Inherited from

ChartPropsAxisVal.valAxisCrossesAt

---

valAxisDisplayUnit?

optional valAxisDisplayUnit?: "billions" | "hundredMillions" | "hundreds" | "hundredThousands" | "millions" | "tenMillions" | "tenThousands" | "thousands" | "trillions"

Defined in: src/types/chart.ts:422

Inherited from

ChartPropsAxisVal.valAxisDisplayUnit

---

valAxisDisplayUnitLabel?

optional valAxisDisplayUnitLabel?: boolean

Defined in: src/types/chart.ts:432

Inherited from

ChartPropsAxisVal.valAxisDisplayUnitLabel

---

valAxisHidden?

optional valAxisHidden?: boolean

Defined in: src/types/chart.ts:433

Inherited from

ChartPropsAxisVal.valAxisHidden

---

valAxisLabelColor?

optional valAxisLabelColor?: string

Defined in: src/types/chart.ts:434

Inherited from

ChartPropsAxisVal.valAxisLabelColor

---

valAxisLabelFontBold?

optional valAxisLabelFontBold?: boolean

Defined in: src/types/chart.ts:435

Inherited from

ChartPropsAxisVal.valAxisLabelFontBold

---

valAxisLabelFontFace?

optional valAxisLabelFontFace?: string

Defined in: src/types/chart.ts:436

Inherited from

ChartPropsAxisVal.valAxisLabelFontFace

---

valAxisLabelFontItalic?

optional valAxisLabelFontItalic?: boolean

Defined in: src/types/chart.ts:437

Inherited from

ChartPropsAxisVal.valAxisLabelFontItalic

---

valAxisLabelFontSize?

optional valAxisLabelFontSize?: number

Defined in: src/types/chart.ts:438

Inherited from

ChartPropsAxisVal.valAxisLabelFontSize

---

valAxisLabelFormatCode?

optional valAxisLabelFormatCode?: string

Defined in: src/types/chart.ts:439

Inherited from

ChartPropsAxisVal.valAxisLabelFormatCode

---

valAxisLabelPos?

optional valAxisLabelPos?: "none" | "high" | "low" | "nextTo"

Defined in: src/types/chart.ts:440

Inherited from

ChartPropsAxisVal.valAxisLabelPos

---

valAxisLabelRotate?

optional valAxisLabelRotate?: number

Defined in: src/types/chart.ts:441

Inherited from

ChartPropsAxisVal.valAxisLabelRotate

---

valAxisLineColor?

optional valAxisLineColor?: string

Defined in: src/types/chart.ts:442

Inherited from

ChartPropsAxisVal.valAxisLineColor

---

valAxisLineShow?

optional valAxisLineShow?: boolean

Defined in: src/types/chart.ts:443

Inherited from

ChartPropsAxisVal.valAxisLineShow

---

valAxisLineSize?

optional valAxisLineSize?: number

Defined in: src/types/chart.ts:444

Inherited from

ChartPropsAxisVal.valAxisLineSize

---

valAxisLineStyle?

optional valAxisLineStyle?: "dash" | "solid" | "dot"

Defined in: src/types/chart.ts:445

Inherited from

ChartPropsAxisVal.valAxisLineStyle

---

valAxisLogScaleBase?

optional valAxisLogScaleBase?: number

Defined in: src/types/chart.ts:450

PowerPoint: Format Axis > Axis Options > Logarithmic scale - Base

• range: 2-99

Inherited from

ChartPropsAxisVal.valAxisLogScaleBase

---

valAxisMajorTickMark?

optional valAxisMajorTickMark?: ChartAxisTickMark

Defined in: src/types/chart.ts:451

Inherited from

ChartPropsAxisVal.valAxisMajorTickMark

---

valAxisMajorUnit?

optional valAxisMajorUnit?: number

Defined in: src/types/chart.ts:452

Inherited from

ChartPropsAxisVal.valAxisMajorUnit

---

valAxisMaxVal?

optional valAxisMaxVal?: number

Defined in: src/types/chart.ts:453

Inherited from

ChartPropsAxisVal.valAxisMaxVal

---

valAxisMinorTickMark?

optional valAxisMinorTickMark?: ChartAxisTickMark

Defined in: src/types/chart.ts:454

Inherited from

ChartPropsAxisVal.valAxisMinorTickMark

---

valAxisMinVal?

optional valAxisMinVal?: number

Defined in: src/types/chart.ts:455

Inherited from

ChartPropsAxisVal.valAxisMinVal

---

valAxisOrientation?

optional valAxisOrientation?: "minMax" | "maxMin"

Defined in: src/types/chart.ts:456

Inherited from

ChartPropsAxisVal.valAxisOrientation

---

valAxisTitle?

optional valAxisTitle?: string

Defined in: src/types/chart.ts:457

Inherited from

ChartPropsAxisVal.valAxisTitle

---

valAxisTitleColor?

optional valAxisTitleColor?: string

Defined in: src/types/chart.ts:458

Inherited from

ChartPropsAxisVal.valAxisTitleColor

---

valAxisTitleFontFace?

optional valAxisTitleFontFace?: string

Defined in: src/types/chart.ts:459

Inherited from

ChartPropsAxisVal.valAxisTitleFontFace

---

valAxisTitleFontSize?

optional valAxisTitleFontSize?: number

Defined in: src/types/chart.ts:460

Inherited from

ChartPropsAxisVal.valAxisTitleFontSize

---

valAxisTitleRotate?

optional valAxisTitleRotate?: number

Defined in: src/types/chart.ts:461

Inherited from

ChartPropsAxisVal.valAxisTitleRotate

---

valGridLine?

optional valGridLine?: OptsChartGridLine

Defined in: src/types/chart.ts:462

Inherited from

ChartPropsAxisVal.valGridLine

---

valign?

optional valign?: VAlign

Defined in: src/types/text.ts:293

vertical alignment

Default

'top'

Inherited from

ChartPropsTitle.valign

---

valLabelFormatCode?

optional valLabelFormatCode?: string

Defined in: src/types/chart.ts:470

Value label format code

• this also directs Data Table formatting

Examples

'#%' // round percent

'0.00%' // shows values as '0.00%'

'$0.00' // shows values as '$0.00'

Inherited from

ChartPropsAxisVal.valLabelFormatCode

---

w?

optional w?: Coord

Defined in: src/types/core.ts:56

Width

• inches or percentage

Examples

10.25 // width in inches

'75%' // width as percentage of slide size

Inherited from

PositionProps.w

---

x?

optional x?: Coord

Defined in: src/types/core.ts:35

Horizontal position

• inches or percentage

Examples

10.25 // position in inches

'75%' // position as percentage of slide size

Inherited from

PositionProps.x

---

y?

optional y?: Coord

Defined in: src/types/core.ts:42

Vertical position

• inches or percentage

Examples

10.25 // position in inches

'75%' // position as percentage of slide size

Inherited from

PositionProps.y