oldliandClaude Sonnet 5
ec7a44d6fb
Step 1 — Knowledge base: perfect all reference/*.md with type, range, default, unit - text.md: add DataOrPathProps, path/data, bullet deprecated params - chart.md: add deprecated section, fix 19 params with missing elements - slide.md: add bkgd→background deprecated mapping - output.md: add masterSlide, presLayout Step 2 — Schema: align schema/presentation.schema.json with KB - Add catAxisItem and valAxisItem definitions with full sub-property constraints - Fix 7 enum constraints (barDir, displayBlanksAs, bar3DShape, etc.) - Add 4 missing fields (verbose, autoPageCharWeight, autoPageLineWeight, notes, masterSlide, presLayout) Step 3 — Translation engine: transform renderers from passthrough to validation - index.js: add normalizePosition, normalizeColor, validateEnum shared utilities - All renderers: position validation, color hex normalization, enum validation - Image: graceful failure handling (catch load errors, warn, continue) - Chart: chartType enum validation, data parity check - Table: colspan/rowspan integer validation, border array check - Full verification: basic.json and full.json generate valid PPTX Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
18 KiB
图表参数 (Chart Props)
图表参数来自 IChartOpts 及其继承的所有接口，用于 slide.addChart() 方法。
图表类型 (CHART_NAME)
- 类型：
'area' | 'bar' | 'bar3D' | 'bubble' | 'doughnut' | 'line' | 'pie' | 'radar' | 'scatter'
可通过 pptxgen.ChartType.XXX 常量引用：
ChartType.area、ChartType.bar、ChartType.bar3d、ChartType.bubble、ChartType.bubble3d、ChartType.doughnut、ChartType.line、ChartType.pie、ChartType.radar、ChartType.scatter
多图类型 (IChartMulti)
{ type: CHART_NAME, data: OptsChartData[], options: IChartOpts }
数据接口 (OptsChartData)
-
labels：分类标签
- 类型：
string[] | string[][] - 示例：
['Year 2000', 'Year 2010', 'Year 2020'] - 说明：
string[][]用于多级分类轴，始于 v3.11.0
- 类型：
-
name：系列名称
- 类型：
string - 示例：
'Locations'
- 类型：
-
sizes：气泡大小
- 类型：
number[] - 说明：仅用于气泡图
- 示例：
[5, 1, 5, 1]
- 类型：
-
values：分类数值
- 类型：
number[] - 示例：
[2000, 2010, 2020]
- 类型：
位置属性 (PositionProps)
-
x：水平位置
- 类型：
Coord（number |${number}%``） - 单位：英寸（number）或百分比（
'50%'）
- 类型：
-
y：垂直位置
- 类型：
Coord - 单位：英寸或百分比
- 类型：
-
w：宽度
- 类型：
Coord - 单位：英寸或百分比
- 类型：
-
h：高度
- 类型：
Coord - 单位：英寸或百分比
- 类型：
对象名称属性 (ObjectNameProps)
- objectName：对象名称
- 类型：
string - 说明：替代默认的 "Object N" 名称
- 默认值：
'Object 1'
- 类型：
基础图表属性 (IChartPropsBase)
-
axisPos：坐标轴位置
- 类型：
'b' | 'l' | 'r' | 't' - 取值范围：
b（下）、l（左）、r（右）、t（上）
- 类型：
-
chartColors：图表系列颜色
- 类型：
HexColor[] - 格式：6 位十六进制颜色数组（无
#）
- 类型：
-
chartColorsOpacity：系列颜色不透明度
- 类型：
number - 取值范围：
0–100 - 示例：
50（50% 不透明）
- 类型：
-
dataBorder：数据点边框
- 类型：
BorderProps - 子参数：
- dataBorder.type：
'none' | 'dash' | 'solid' - dataBorder.color：
HexColor - dataBorder.pt：边框粗细（pt）
- dataBorder.type：
- 类型：
-
displayBlanksAs：空值显示方式
- 类型：
string
- 类型：
-
invertedColors：反色数组
- 类型：
HexColor[]
- 类型：
-
lang：语言
- 类型：
string
- 类型：
-
layout：图表在幻灯片中的位置
- 类型：
PositionProps
- 类型：
-
shadow：阴影
- 类型：
ShadowProps
- 类型：
-
showLabel：显示数据标签
- 类型：
boolean - 默认值：
false
- 类型：
-
showLeaderLines：显示引导线
- 类型：
boolean
- 类型：
-
showLegend：显示图例
- 类型：
boolean - 默认值：
false
- 类型：
-
showPercent：显示百分比
- 类型：
boolean - 默认值：
false
- 类型：
-
showSerName：显示系列名称
- 类型：
boolean - 默认值：
false
- 类型：
-
showTitle：显示图表标题
- 类型：
boolean - 默认值：
false
- 类型：
-
showValue：显示数值
- 类型：
boolean - 默认值：
false
- 类型：
-
v3DPerspective：3D 透视
- 类型：
number - 取值范围：
0–120 - 默认值：
30
- 类型：
-
v3DRAngAx：直角坐标轴
- 类型：
boolean - 说明：启用时覆盖
v3DPerspective，以第一人称视角显示图表 - 默认值：
false
- 类型：
-
v3DRotX：X 轴旋转
- 类型：
number - 取值范围：
0–359.9 - 默认值：
30
- 类型：
-
v3DRotY：Y 轴旋转
- 类型：
number - 取值范围：
0–359.9 - 默认值：
30
- 类型：
-
chartArea：图表区域样式
- 类型：
IChartAreaProps（继承IChartPropsFillLine） - 子参数：
- chartArea.border：边框
- chartArea.fill：填充
- chartArea.roundedCorners：圆角
- 类型：
boolean - 默认值：
true - 始于：v3.11
- 类型：
- 类型：
-
plotArea：绘图区样式
- 类型：
IChartPropsFillLine - 子参数：
- plotArea.border：绘图区边框
- plotArea.fill：绘图区填充
- 始于：v3.11
- 类型：
分类轴属性 (IChartPropsAxisCat)
-
catAxes：多图多轴设置
- 类型：
IChartPropsAxisCat[]
- 类型：
-
catAxisBaseTimeUnit：分类轴基础时间单位
- 类型：
string
- 类型：
-
catAxisCrossesAt：数值轴交叉位置
- 类型：
number | 'autoZero'
- 类型：
-
catAxisHidden：隐藏分类轴
- 类型：
boolean
- 类型：
-
catAxisLabelColor：轴标签颜色
- 类型：
string
- 类型：
-
catAxisLabelFontBold：轴标签粗体
- 类型：
boolean
- 类型：
-
catAxisLabelFontFace：轴标签字体
- 类型：
string
- 类型：
-
catAxisLabelFontItalic：轴标签斜体
- 类型：
boolean
- 类型：
-
catAxisLabelFontSize：轴标签字号
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
catAxisLabelFrequency：标签频率
- 类型：
string
- 类型：
-
catAxisLabelPos：标签位置
- 类型：
'none' | 'low' | 'high' | 'nextTo'
- 类型：
-
catAxisLabelRotate：标签旋转角度
- 类型：
number - 单位：度
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
catAxisLineColor：轴线颜色
- 类型：
string
- 类型：
-
catAxisLineShow：显示轴线
- 类型：
boolean
- 类型：
-
catAxisLineSize：轴线粗细
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
catAxisLineStyle：轴线样式
- 类型：
'solid' | 'dash' | 'dot'
- 类型：
-
catAxisMajorTickMark：主轴刻度标记
- 类型：
ChartAxisTickMark（'none' | 'inside' | 'outside' | 'cross'）
- 类型：
-
catAxisMajorTimeUnit：主要时间单位
- 类型：
string
- 类型：
-
catAxisMajorUnit：主要刻度单位
- 类型：
number - 单位：无单位（数值刻度）
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
catAxisMaxVal：轴最大值
- 类型：
number
- 类型：
-
catAxisMinorTickMark：副轴刻度标记
- 类型：
ChartAxisTickMark
- 类型：
-
catAxisMinorTimeUnit：次要时间单位
- 类型：
string
- 类型：
-
catAxisMinorUnit：次要刻度单位
- 类型：
number - 单位：无单位（数值刻度）
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
catAxisMinVal：轴最小值
- 类型：
number
- 类型：
-
catAxisMultiLevelLabels：多级标签
- 类型：
boolean - 始于：v3.11.0
- 类型：
-
catAxisOrientation：轴方向
- 类型：
'minMax'
- 类型：
-
catAxisTitle：轴标题
- 类型：
string
- 类型：
-
catAxisTitleColor：轴标题颜色
- 类型：
string
- 类型：
-
catAxisTitleFontFace：轴标题字体
- 类型：
string
- 类型：
-
catAxisTitleFontSize：轴标题字号
- 类型：
number
- 类型：
-
catAxisTitleRotate：轴标题旋转
- 类型：
number - 单位：度
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
catGridLine：分类网格线
- 类型：
OptsChartGridLine
- 类型：
-
catLabelFormatCode：分类标签格式代码
- 类型：
string
- 类型：
-
secondaryCatAxis：使用次要分类轴
- 类型：
boolean - 默认值：
false
- 类型：
-
showCatAxisTitle：显示分类轴标题
- 类型：
boolean
- 类型：
系列轴属性 (IChartPropsAxisSer)
-
serAxisBaseTimeUnit：系列轴基础时间单位
- 类型：
string
- 类型：
-
serAxisHidden：隐藏系列轴
- 类型：
boolean
- 类型：
-
serAxisLabelColor：系列轴标签颜色
- 类型：
string
- 类型：
-
serAxisLabelFontBold：系列轴标签粗体
- 类型：
boolean
- 类型：
-
serAxisLabelFontFace：系列轴标签字体
- 类型：
string
- 类型：
-
serAxisLabelFontItalic：系列轴标签斜体
- 类型：
boolean
- 类型：
-
serAxisLabelFontSize：系列轴标签字号
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
serAxisLabelFrequency：系列轴标签频率
- 类型：
string
- 类型：
-
serAxisLabelPos：系列轴标签位置
- 类型：
'none' | 'low' | 'high' | 'nextTo'
- 类型：
-
serAxisLineColor：系列轴线颜色
- 类型：
string
- 类型：
-
serAxisLineShow：显示系列轴线
- 类型：
boolean
- 类型：
-
serAxisMajorTimeUnit：系列轴主要时间单位
- 类型：
string
- 类型：
-
serAxisMajorUnit：系列轴主要刻度单位
- 类型：
number
- 类型：
-
serAxisMinorTimeUnit：系列轴次要时间单位
- 类型：
string
- 类型：
-
serAxisMinorUnit：系列轴次要刻度单位
- 类型：
number
- 类型：
-
serAxisOrientation：系列轴方向
- 类型：
string
- 类型：
-
serAxisTitle：系列轴标题
- 类型：
string
- 类型：
-
serAxisTitleColor：系列轴标题颜色
- 类型：
string
- 类型：
-
serAxisTitleFontFace：系列轴标题字体
- 类型：
string
- 类型：
-
serAxisTitleFontSize：系列轴标题字号
- 类型：
number
- 类型：
-
serAxisTitleRotate：系列轴标题旋转
- 类型：
number
- 类型：
-
serGridLine：系列网格线
- 类型：
OptsChartGridLine
- 类型：
-
serLabelFormatCode：系列标签格式代码
- 类型：
string
- 类型：
-
showSerAxisTitle：显示系列轴标题
- 类型：
boolean
- 类型：
数值轴属性 (IChartPropsAxisVal)
-
secondaryValAxis：使用次要数值轴
- 类型：
boolean - 默认值：
false
- 类型：
-
showValAxisTitle：显示数值轴标题
- 类型：
boolean
- 类型：
-
valAxes：多图多数值轴
- 类型：
IChartPropsAxisVal[]
- 类型：
-
valAxisCrossesAt：数值轴交叉位置
- 类型：
number | 'autoZero'
- 类型：
-
valAxisDisplayUnit：显示单位
- 类型：
'billions' | 'hundredMillions' | 'hundreds' | 'hundredThousands' | 'millions' | 'tenMillions' | 'tenThousands' | 'thousands' | 'trillions'
- 类型：
-
valAxisDisplayUnitLabel：显示单位标签
- 类型：
boolean
- 类型：
-
valAxisHidden：隐藏数值轴
- 类型：
boolean
- 类型：
-
valAxisLabelColor：数值轴标签颜色
- 类型：
string
- 类型：
-
valAxisLabelFontBold：数值轴标签粗体
- 类型：
boolean
- 类型：
-
valAxisLabelFontFace：数值轴标签字体
- 类型：
string
- 类型：
-
valAxisLabelFontItalic：数值轴标签斜体
- 类型：
boolean
- 类型：
-
valAxisLabelFontSize：数值轴标签字号
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
valAxisLabelFormatCode：数值轴标签格式代码
- 类型：
string
- 类型：
-
valAxisLabelPos：数值轴标签位置
- 类型：
'none' | 'low' | 'high' | 'nextTo'
- 类型：
-
valAxisLabelRotate：数值轴标签旋转
- 类型：
number - 单位：度
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
valAxisLineColor：数值轴线颜色
- 类型：
string
- 类型：
-
valAxisLineShow：显示数值轴线
- 类型：
boolean
- 类型：
-
valAxisLineSize：数值轴线粗细
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
valAxisLineStyle：数值轴线样式
- 类型：
'solid' | 'dash' | 'dot'
- 类型：
-
valAxisLogScaleBase：对数刻度基数
- 类型：
number - 取值范围：
2–99 - 始于：v3.5.0
- 类型：
-
valAxisMajorTickMark：数值轴主刻度标记
- 类型：
ChartAxisTickMark
- 类型：
-
valAxisMajorUnit：数值轴主要刻度单位
- 类型：
number - 单位：无单位（数值刻度）
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
valAxisMaxVal：数值轴最大值
- 类型：
number - 单位：无单位（数值与数据一致）
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
valAxisMinorTickMark：数值轴副刻度标记
- 类型：
ChartAxisTickMark
- 类型：
-
valAxisMinVal：数值轴最小值
- 类型：
number - 单位：无单位（数值与数据一致）
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
valAxisOrientation：数值轴方向
- 类型：
'minMax'
- 类型：
-
valAxisTitle：数值轴标题
- 类型：
string
- 类型：
-
valAxisTitleColor：数值轴标题颜色
- 类型：
string
- 类型：
-
valAxisTitleFontFace：数值轴标题字体
- 类型：
string
- 类型：
-
valAxisTitleFontSize：数值轴标题字号
- 类型：
number
- 类型：
-
valAxisTitleRotate：数值轴标题旋转
- 类型：
number
- 类型：
-
valGridLine：数值网格线
- 类型：
OptsChartGridLine
- 类型：
-
valLabelFormatCode：数值标签格式代码
- 类型：
string - 始于：v3.3.0
- 示例：
'#%'、'0.00%'、'$0.00'
- 类型：
柱状图属性 (IChartPropsChartBar)
-
bar3DShape：3D 柱形形状
- 类型：
string - 取值范围：
'box' | 'cylinder' | 'cone' | 'pyramid'（PowerPoint 标准值），类型声明为 string，也可接受其他值 - 默认值：
'box'
- 类型：
-
barDir：柱形方向
- 类型：
string - 取值范围：
'bar'（水平）、'col'（垂直） - 默认值：
'col'
- 类型：
-
barGapDepthPct：3D 柱形深度间距百分比
- 类型：
number - 取值范围：
0–500 - 默认值：
150 - 单位：%
- 类型：
-
barGapWidthPct：间距宽度百分比
- 类型：
number - 取值范围：
0–500 - 默认值：
150
- 类型：
-
barGrouping：分组方式
- 类型：
string - 取值范围：
'clustered' | 'stacked' | 'standard'（PowerPoint 标准值），类型声明为 string，也可接受其他值 - 默认值：
'clustered'
- 类型：
-
barOverlapPct：系列重叠百分比
- 类型：
number - 取值范围：
-100–100 - 默认值：
0 - 始于：v3.9.0
- 类型：
圆环图属性 (IChartPropsChartDoughnut)
-
dataNoEffects：禁用数据点效果
- 类型：
boolean - 默认值：
false
- 类型：
-
holeSize：中心孔大小
- 类型：
number - 取值范围：
0–90（百分比） - 默认值：
50
- 类型：
折线图属性 (IChartPropsChartLine)
-
lineCap：线帽类型
- 类型：
ChartLineCap（'flat' | 'round' | 'square'） - 默认值：
'flat'
- 类型：
-
lineDash：线型
- 类型：
'dash' | 'dashDot' | 'lgDash' | 'lgDashDot' | 'lgDashDotDot' | 'solid' | 'sysDash' | 'sysDot' - 默认值：
'solid'
- 类型：
-
lineDataSymbol：数据点标记类型
- 类型：
'circle' | 'dash' | 'diamond' | 'dot' | 'none' | 'square' | 'triangle' - 默认值：
'circle'
- 类型：
-
lineDataSymbolLineColor：标记边框颜色
- 类型：
string
- 类型：
-
lineDataSymbolLineSize：标记边框宽度
- 类型：
number - 默认值：
0.75
- 类型：
-
lineDataSymbolSize：标记大小
- 类型：
number - 取值范围：
2–72 - 默认值：
6
- 类型：
-
lineSize：线条宽度
- 类型：
number - 取值范围：
0–1584 - 默认值：
2
- 类型：
-
lineSmooth：平滑线
- 类型：
boolean - 默认值：
false
- 类型：
饼图属性 (IChartPropsChartPie)
-
dataNoEffects：禁用数据点效果
- 类型：
boolean - 默认值：
false
- 类型：
-
firstSliceAng：第一扇区起始角度
- 类型：
number - 取值范围：
0–359 - 默认值：
0 - 始于：v3.4.0
- 类型：
雷达图属性 (IChartPropsChartRadar)
- radarStyle：雷达图样式
- 类型：
'standard' | 'marker' | 'filled' - 默认值：
'standard'
- 类型：
数据标签属性 (IChartPropsDataLabel)
-
dataLabelBkgrdColors：数据标签背景色
- 类型：
boolean - 默认值：
false
- 类型：
-
dataLabelColor：数据标签颜色
- 类型：
string - 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
dataLabelFontBold：数据标签粗体
- 类型：
boolean
- 类型：
-
dataLabelFontFace：数据标签字体
- 类型：
string
- 类型：
-
dataLabelFontItalic：数据标签斜体
- 类型：
boolean
- 类型：
-
dataLabelFontSize：数据标签字号
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
dataLabelFormatCode：数据标签格式代码
- 类型：
string - 示例：
'#%'、'0.00%'、'$0.00'
- 类型：
-
dataLabelFormatScatter：散点图标签格式
- 类型：
'custom' | 'customXY' | 'XY'
- 类型：
-
dataLabelPosition：数据标签位置
- 类型：
'b' | 'bestFit' | 'ctr' | 'l' | 'r' | 't' | 'inEnd' | 'outEnd'
- 类型：
数据表属性 (IChartPropsDataTable)
-
dataTableFontSize：数据表字号
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
dataTableFormatCode：数据表格式代码
- 类型：
string - 始于：v3.3.0
- 类型：
-
showDataTable：显示数据表
- 类型：
boolean - 默认值：
false
- 类型：
-
showDataTableHorzBorder：显示水平边框
- 类型：
boolean
- 类型：
-
showDataTableKeys：显示图例标示
- 类型：
boolean
- 类型：
-
showDataTableOutline：显示外框
- 类型：
boolean
- 类型：
-
showDataTableVertBorder：显示垂直边框
- 类型：
boolean
- 类型：
图例属性 (IChartPropsLegend)
-
legendColor：图例文字颜色
- 类型：
string
- 类型：
-
legendFontFace：图例字体
- 类型：
string
- 类型：
-
legendFontSize：图例字号
- 类型：
number
- 类型：
-
legendPos：图例位置
- 类型：
'b' | 'l' | 'r' | 't' | 'tr' - 取值范围：
b（底部）、l（左侧）、r（右侧）、t（顶部）、tr（右上）
- 类型：
标题属性 (IChartPropsTitle)
继承 TextBaseProps。
-
title：图表标题文字
- 类型：
string
- 类型：
-
titleAlign：标题对齐
- 类型：
string - 取值范围：
'l' | 'ctr' | 'r' - 默认值：
'ctr'
- 类型：
-
titleBold：标题粗体
- 类型：
boolean
- 类型：
-
titleColor：标题颜色
- 类型：
string
- 类型：
-
titleFontFace：标题字体
- 类型：
string
- 类型：
-
titleFontSize：标题字号
- 类型：
number
- 类型：
-
titlePos：标题位置
- 类型：
{ x: number, y: number }
- 类型：
-
titleRotate：标题旋转
- 类型：
number
- 类型：
网格线属性 (OptsChartGridLine)
-
cap：线帽类型
- 类型：
ChartLineCap（'flat' | 'round' | 'square'） - 默认值：
'flat'
- 类型：
-
color：网格线颜色
- 类型：
HexColor
- 类型：
-
size：网格线粗细
- 类型：
number - 单位：pt
- 取值范围：无特殊约束范围
- 无默认值
- 类型：
-
style：网格线样式
- 类型：
'solid' | 'dash' | 'dot' | 'none'
- 类型：
IChartPropsFillLine
用于 chartArea、plotArea 的填充与边框基础类型。
-
border：边框
- 类型：
BorderProps
- 类型：
-
fill：填充
- 类型：
ShapeFillProps
- 类型：
IChartOpts 附加属性
- altText：替代文字（无障碍）
- 类型：
string - 说明：PowerPoint 中右击图表 > "编辑替代文字"
- 类型：
已废弃参数
| 已废弃参数 | 替代参数 | 废弃版本 |
|---|---|---|
border |
plotArea.border |
v3.11.0 |
fill |
plotArea.fill |
v3.11.0 |