PptxGenJS图表 API

属性#

位置/尺寸道具 ( PositionProps ) #

选项	类型	默认	描述	可能的值
x	数字	1.0	hor 位置（英寸）	0-n
x	字符串		霍尔位置（百分比）	'n%'。（例如：{x:'50%'}幻灯片的中间）
y	数字	1.0	ver 位置（英寸）	0-n
y	字符串		位置（百分比）	'n%'。（例如：{y:'50%'}幻灯片的中间）
w	数字	1.0	宽度（英寸）	0-n
w	字符串		宽度（百分比）	'n%'。（例如：{w:'50%'}幻灯片宽度的 50%）
h	数字	1.0	高度（英寸）	0-n
h	字符串		高度（百分比）	'n%'。（例如：{h:'50%'}幻灯片高度的 50%）

常规 ( IChartOpts)、数据表 ( IChartPropsDataTable)、图例 ( IChartPropsLegend)、标题 ( IChartPropsTitle) #

选项	类型	默认	描述	可能的值
altText	字符串		图表替代文字	PowerPoint 中“替换文字”面板中显示的字符串
border	对象		图表边框	具有pt和color值的对象。示例：border:{pt:'1', color:'f1f1f1'}
chartColors	大批		数据颜色	十六进制颜色代码数组。示例：['0088CC','FFCC00']
chartColorsOpacity	数字	100	数据颜色不透明度（百分比）	1-100。示例：{ chartColorsOpacity:50 }
dataTableFontSize	数字		数据表字体大小	1-256。示例：{ dataTableFontSize: 13 }
fill	字符串		填充/背景颜色	十六进制颜色代码。示例：{ fill:'0088CC' }
holeSize	数字	50	甜甜圈孔大小（百分比）	1-100。示例：{ holeSize:50 }
invertedColors	大批		负数的数据颜色	十六进制颜色代码数组。示例：['0088CC','FFCC00']
legendFontFace	字符串	Arial	字体	字体名称。示例：{ legendFontFace:'Arial' }
legendFontSize	数字	10	图例字体大小	1-256。示例：{ legendFontSize: 13 }
legendColor	字符串	000000	图例文本颜色	十六进制颜色代码。示例：{ legendColor: '0088CC' }
legendPos	字符串	r	图表图例位置	b(下), tr(右上), l(左), r(右), t(上)
layout	对象		图表区域内的定位图	带有x、和props 的对象y，均在 0-1 范围内（与图表大小成比例）。例如：在绘图区域内完全展开图表w``h``{x: 0, y: 0, w: 1, h: 1}
radarStyle	字符串	standard	雷达图样式	standard, marker,filled
showDataTable	布尔值	false	在图表下方显示数据表	true或false（不适用于饼图/甜甜圈图）
showDataTableKeys	布尔值	true	显示数据表键（色块）	true或false（不适用于饼图/甜甜圈图）
showDataTableHorzBorder	布尔值	true	显示数据表水平边框	true或false（不适用于饼图/甜甜圈图）
showDataTableVertBorder	布尔值	true	显示数据表垂直边框	true或false（不适用于饼图/甜甜圈图）
showDataTableOutline	布尔值	true	显示数据表表格大纲	true或false（不适用于饼图/甜甜圈图）
showLabel	布尔值	false	显示数据标签	true或者false
showLeaderLines	布尔值	false	显示引导线	true或者false
showLegend	布尔值	false	显示图表图例	true或者false
showPercent	布尔值	false	显示数据百分比	true或者false
showTitle	布尔值	false	显示图表标题	true或者false
showValue	布尔值	false	显示数据值	true或者false
title	字符串		图表标题	示例：{ title:'Sales by Region' }
titleAlign	字符串	center	图表标题文本对齐	left center或right例如：{ titleAlign:'left' }
titleColor	字符串	000000	标题颜色	十六进制颜色代码。示例：{ titleColor:'0088CC' }
titleFontFace	字符串	Arial	字体	字体名称。示例：{ titleFontFace:'Arial' }
titleFontSize	数字	18	字体大小	1-256。示例：{ titleFontSize:12 }
titlePos	对象		职称位置	具有 x 和 y 值的对象。示例：{ titlePos:{x: 0, y: 10} }
titleRotate	整数		标题旋转（度）	0-359。示例：{ titleRotate:45 }

Cat 轴 ( IChartPropsAxisCat) 和 Val 轴 ( IChartPropsAxisVal) #

选项	类型	默认	描述	可能的值
catAxisBaseTimeUnit	字符串		类别轴基准时间单位	days months或者years
catAxisHidden	布尔值	false	隐藏类别轴	true或者false
catAxisLabelColor	字符串	000000	类别轴颜色	十六进制颜色代码。示例：{ catAxisLabelColor:'0088CC' }
catAxisLabelFontBold	布尔值	false	使猫轴标签加粗	true或者false
catAxisLabelFontFace	字符串	Arial	类别轴字体	字体名称。示例：{ titleFontFace:'Arial' }
catAxisLabelFontSize	整数	18	类别轴字体大小	1-256。示例：{ titleFontSize:12 }
catAxisLabelFrequency	整数		PPT《标签之间的间隔》	1-n。示例：{ catAxisLabelFrequency: 2 }
catAxisLabelPos	字符串	nextTo	类别轴标签位置	low, high, 或nextTo. 示例：{ catAxisLabelPos: 'low' }
catAxisLabelRotate	整数		类别轴旋转（度）	0-360。示例：{ catAxisLabelRotate:45 }
catAxisLineColor	字符串	000000	类别-轴线颜色	十六进制颜色代码。示例：{ catAxisTitleColor:'0088CC' }
catAxisLineShow	布尔值	true	显示/隐藏类别轴线	true或者false
catAxisLineSize	整数	18	类别轴字体大小	1-256。示例：{ titleFontSize:12 }
catAxisLineStyle	字符串	solid	类别-轴线样式	solid, dash,dot
catAxisMajorTickMark	字符串		类别轴主要刻度线	none, inside, outside,cross
catAxisMajorTimeUnit	字符串		类别轴主要时间单位	days,months或years
catAxisMaxVal	整数		类别轴最大值	整数。示例：{ catAxisMaxVal:10 }
catAxisMinVal	整数		类别轴最小值	整数。示例：{ catAxisMinVal:0 }
catAxisMinorTickMark	字符串		类别轴小刻度线	none, inside, outside,cross
catAxisMinorTimeUnit	字符串		类别轴次要时间单位	days,months或years
catAxisMajorUnit	整数		类轴主要单位	正整数。示例：{ catAxisMajorUnit:12 }
catAxisMinorUnit	整数		类别轴次要单位	正整数。示例：{ catAxisMinorUnit:1 }
catAxisOrientation	字符串	minMax	类别轴方向	maxMin（高->低）或minMax（低->高）
catAxisTitle	字符串	Axis Title	轴标题	一个字符串。示例：{ catAxisTitle:'Regions' }
catAxisTitleColor	字符串	000000	标题颜色	十六进制颜色代码。示例：{ catAxisTitleColor:'0088CC' }
catAxisTitleFontFace	字符串	Arial	字体	字体名称。示例：{ catAxisTitleFontFace:'Arial' }
catAxisTitleFontSize	整数		字体大小	1-256。示例：{ catAxisTitleFontSize:12 }
catAxisTitleRotate	整数		标题旋转（度）	0-360。示例：{ catAxisTitleRotate:45 }
catGridLine	对象	none	类别网格线样式	具有属性size(pt)color和style( 'solid','dash'或'dot')'none'的对象或隐藏
showCatAxisTitle	布尔值	false	显示类别（垂直）标题	true或false。示例：{ showCatAxisTitle:true }
showValAxisTitle	布尔值	false	显示值（水平）标题	true或false。示例：{ showValAxisTitle:true }
valAxisDisplayUnit	字符串		显示单元	billions, hundredMillions, hundreds, hundredThousands, millions, tenMillions, tenThousands, thousands,trillions
valAxisHidden	布尔值	false	隐藏价值轴	true或者false
valAxisLabelColor	字符串	000000	值轴颜色	十六进制颜色代码。示例：{ valAxisLabelColor:'0088CC' }
valAxisLabelFontBold	布尔值	false	使 val 轴标签加粗	true或者false
valAxisLabelFontFace	字符串	Arial	值轴字体	字体名称。示例：{ titleFontFace:'Arial' }
valAxisLabelFontSize	整数	18	值轴字体大小	1-256。示例：{ titleFontSize:12 }
valAxisLabelFormatCode	字符串	General	值轴数字格式	格式字符串。示例：{ axisLabelFormatCode:'#,##0' }
valAxisLineColor	字符串	000000	价值轴线颜色	十六进制颜色代码。示例：{ catAxisTitleColor:'0088CC' }
valAxisLineShow	布尔值	true	显示/隐藏价值轴线	true或者false
valAxisLineSize	整数	18	值轴字体大小	1-256。示例：{ titleFontSize:12 }
valAxisLineStyle	字符串	solid	价值轴线样式	solid, dash,dot
valAxisLogScaleBase	数字		对数刻度	2-99
valAxisMajorTickMark	字符串		价值轴主要刻度线	none, inside, outside,cross
valAxisMajorUnit	数字	1.0	值轴刻度步长	浮点数或整数。示例：{ majorUnit:0.2 }
valAxisMaxVal	数字		值轴最大值	1-N。示例：{ valAxisMaxVal:125 }
valAxisMinVal	数字		值轴最小值	1-N。示例：{ valAxisMinVal: -10 }
valAxisMinorTickMark	字符串		值轴次刻度线	none, inside, outside,cross
valAxisOrientation	字符串	minMax	价值轴方向	maxMin（高->低）或minMax（低->高）
valAxisTitle	字符串	Axis Title	轴标题	一个字符串。示例：{ valAxisTitle:'Sales (USD)' }
valAxisTitleColor	字符串	000000	标题颜色	十六进制颜色代码。示例：{ valAxisTitleColor:'0088CC' }
valAxisTitleFontFace	字符串	Arial	字体	字体名称。示例：{ valAxisTitleFontFace:'Arial' }
valAxisTitleFontSize	数字		字体大小	1-256。示例：{ valAxisTitleFontSize:12 }
valAxisTitleRotate	整数		标题旋转（度）	0-360。示例：{ valAxisTitleRotate:45 }
valGridLine	对象		值网格线样式	具有属性size(pt)color和style( 'solid','dash'或'dot')'none'的对象或隐藏

条形 ( IChartPropsChartBar)、数据标签 ( IChartPropsDataLabel)、线 ( IChartPropsChartLine) #

选项	类型	默认	描述	可能的值
barDir	字符串	col	条形方向	（条形图）bar（水平）或col（垂直）。示例：{barDir:'bar'}
barGapWidthPct	数字	150	条形组之间的宽度（百分比）	（条形图）0-500。示例：{ barGapWidthPct:50 }
barGrouping	字符串	clustered	酒吧分组	（条形图）clustered或stacked或percentStacked。
barOverlapPct	数字	0	重叠（百分比）	（条形图）-100- 100。示例：{ barOverlapPct:50 }
catLabelFormatCode	字符串		显示数据值的格式	格式字符串。示例：{ catLabelFormatCode:'#,##0' }
dataBorder	对象		数据边框	具有pt和color值的对象。示例：border:{pt:'1', color:'f1f1f1'}
dataLabelColor	字符串	000000	数据标签颜色	十六进制颜色代码。示例：{ dataLabelColor:'0088CC' }
dataLabelFormatCode	字符串		显示数据值的格式	格式字符串。保留%：#%；保留以为小数：#.0%;示例：{ dataLabelFormatCode:'#,##0' }
dataLabelFormatScatter	字符串	custom	标签格式	(散点图) custom,,, customXY_XY
dataLabelFontBold	布尔值	false	使数据标签加粗	示例：{ dataLabelFontBold:true }
dataLabelFontFace	字符串	Arial	值轴字体	字体名称。示例：{ titleFontFace:'Arial' }
dataLabelFontSize	数字	18	值轴字体大小	1-256。示例：{ titleFontSize:12 }
dataLabelPosition	字符串	bestFit	数据标签位置	bestFit, b, ctr, inBase, inEnd, l, outEnd, r,t
dataNoEffects	布尔值	false	是否忽略对数据的影响	（甜甜圈/饼图）true或false
displayBlanksAs	字符串	span	画线还是画间隙	（折线图）span或gap
lineDash	字符串	solid	（条形图/散点图）边框线虚线样式	dash, dashDot, lgDash, lgDashDot, lgDashDotDot, solid,sysDash或sysDot
lineDataSymbol	字符串	circle	线标记上使用的符号	circle, dash, diamond, dot, none, square,triangle
lineDataSymbolSize	数字	6	线数据符号的大小	1-256。示例：{ lineDataSymbolSize:12 }
lineDataSymbolLineSize	数字	0.75	数据符号轮廓的大小	1-256。示例：{ lineDataSymbolLineSize:12 }
lineDataSymbolLineColor	字符串	000000	数据符号线的颜色	十六进制颜色代码。示例：{ lineDataSymbolLineColor:'0088CC' }
lineSize	数字	2	数据线粗细（0为无线）	0-256。示例：{ lineSize: 1 }
lineSmooth	布尔值	false	是否平滑线条	true或false- 例如：{ lineSmooth: true }
shadow	ShadowProps		数据元素阴影选项	none或者ShadowProps

3D 条形图 ( IChartPropsChartBar)，系列轴 ( IChartPropsDataTable) #

选项	类型	默认	描述	可能的值
bar3DShape	字符串	box	酒吧 3d 形状	box, cylinder, coneToMax, pyramid,pyramidToMax
barGapDepthPct	数字	150	条形组之间的宽度（百分比）	0-500。示例：{ barGapWidthPct:50 }
dataLabelBkgrdColors	布尔值	false	bkgd 颜色是系列颜色	true或者false
serAxisBaseTimeUnit	字符串		序列轴基准时间单位	days months或者years
serAxisHidden	布尔值	false	隐藏系列轴	true或者false
serAxisOrientation	字符串	minMax	串联轴方向	maxMin（高->低）或minMax（低->高）
serAxisLabelColor	字符串	000000	系列轴颜色	十六进制颜色代码。示例：{ serAxisLabelColor:'0088CC' }
serAxisLabelFontBold	布尔值	false	使猫轴标签加粗	true或者false
serAxisLabelFontFace	字符串	Arial	系列轴字体	字体名称。示例：{ titleFontFace:'Arial' }
serAxisLabelFontSize	整数	18	系列轴字体大小	1-256。示例：{ titleFontSize:12 }
serAxisLabelFrequency	整数		PPT《标签之间的间隔》	1-n。示例：{ serAxisLabelFrequency: 2 }
serAxisLabelPos	字符串	nextTo	轴标签位置	low, high, 或nextTo. 示例：{ serAxisLabelPos: 'low' }
serAxisLineShow	布尔值	true	显示/隐藏系列轴线	true或者false
serAxisMajorTimeUnit	字符串		串行轴主要时间单位	days,months或years
serAxisMajorUnit	整数		串联轴主要单元	正整数。示例：{ serAxisMajorUnit:12 }
serAxisMinorTimeUnit	字符串		序列轴次要时间单位	days,months或years
serAxisMinorUnit	整数		串联轴次要单元	正整数。示例：{ serAxisMinorUnit:1 }
serAxisTitle	字符串	Axis Title	轴标题	一个字符串。示例：{ serAxisTitle:'Regions' }
serAxisTitleColor	字符串	000000	标题颜色	十六进制颜色代码。示例：{ serAxisTitleColor:'0088CC' }
serAxisTitleFontFace	字符串	Arial	字体	字体名称。示例：{ serAxisTitleFontFace:'Arial' }
serAxisTitleFontSize	整数		字体大小	1-256。示例：{ serAxisTitleFontSize:12 }
serAxisTitleRotate	整数		标题旋转（度）	0-360。示例：{ serAxisTitleRotate:45 }
serGridLine	对象	none	系列网格线样式	具有属性size(pt)color和style( 'solid','dash'或'dot')'none'的对象或隐藏
v3DRAngAx	布尔值	true	直角轴	true或者false
v3DPerspective	整数	18	系列轴字体大小	1-240。示例：{ v3DPerspective:125 }
v3DRotX	整数		x 轴旋转（度）	-90- 90。示例：{ v3DRotX:-45 }
v3DRotY	整数		标题旋转（度）	0-360。示例：{ v3DRotY:180 }
valueBarColors	布尔值	false	在多数据系列上强制使用 chartColors	true或者false

元素阴影#

选项	类型	单元	默认	描述	可能的值
type	字符串		outer	阴影类型	outer或inner。示例：{ type:'outer' }
angle	数字	度数	90	阴影角	0-359。示例：{ angle:90 }
blur	数字	积分	3	模糊大小	1-256。示例：{ blur:3 }
color	字符串		000000	阴影颜色	十六进制颜色代码。示例：{ color:'0088CC' }
offset	数字	积分	1.8	偏移大小	1-256。示例：{ offset:2 }
opacity	数字	百分	0.35	不透明度	0-1。示例：{ opacity:0.35 }

多类型选项#

选项	类型	默认	描述	可能的值
catAxes	大批		两个轴选项对象的数组	请参阅下面的示例
secondaryCatAxis	布尔值	false	如果数据应该使用次要类别轴（或主要）	true或者false
secondaryValAxis	布尔值	false	如果数据应该使用辅助值轴（或主要）	true或者false
valAxes	大批		两个轴选项对象的数组	请参阅下面的示例