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>
4.5 KiB
4.5 KiB
幻灯片参数 (Slide Props)
幻灯片相关类型包括 Slide 类、PresSlide 接口和 BackgroundProps，通过 pptx.addSlide() 创建。
添加幻灯片 (addSlide)
pptx.addSlide(props?: AddSlideProps): PptxGenJS.Slide
AddSlideProps
-
masterName：母版名称
- 类型：
string - 说明：使用已定义的 Slide Master 名称
- 类型：
-
sectionTitle：节标题
- 类型：
string - 说明：将幻灯片添加到指定节
- 类型：
Slide 类属性
-
background：幻灯片背景
- 类型：
BackgroundProps - 说明：背景颜色或图片
- 类型：
-
color：默认文字颜色
- 类型：
HexColor - 格式：6 位十六进制（无
#） - 默认值：
'000000'
- 类型：
-
hidden：幻灯片是否隐藏
- 类型：
boolean - 默认值：
false
- 类型：
-
slideNumber：幻灯片编号选项
- 类型：
SlideNumberProps
- 类型：
-
newAutoPagedSlides：自动分页创建的新幻灯片
- 类型：
PresSlide[]
- 类型：
Slide 类方法
-
addChart(type, data, options?)
- 说明：添加图表
- 参数：
type：CHART_NAME | IChartMulti[]data：any[]options?：IChartOpts
- 返回：
Slide
-
addImage(options)
- 说明：添加图片
- 参数：
options—ImageProps - 返回：
Slide
-
addMedia(options)
- 说明：添加媒体（音频/视频）
- 参数：
options—MediaProps - 返回：
Slide
-
addNotes(notes)
- 说明：添加演讲者备注
- 参数：
notes—string - 返回：
Slide
-
addShape(shapeName, options?)
- 说明：添加形状
- 参数：
shapeName：SHAPE_NAMEoptions?：ShapeProps
- 返回：
Slide
-
addTable(tableRows, options?)
- 说明：添加表格
- 参数：
tableRows：TableRow[]options?：TableProps
- 返回：
Slide
-
addText(text, options?)
- 说明：添加文字
- 参数：
text：string | TextProps[]options?：TextPropsOptions
- 返回：
Slide
PresSlide 接口
PresSlide 为内部幻灯片表示，包含以下属性和方法：
-
addChart：添加图表
- 类型：
Function
- 类型：
-
addImage：添加图片
- 类型：
Function
- 类型：
-
addMedia：添加媒体
- 类型：
Function
- 类型：
-
addNotes：添加备注
- 类型：
Function
- 类型：
-
addShape：添加形状
- 类型：
Function
- 类型：
-
addTable：添加表格
- 类型：
Function
- 类型：
-
addText：添加文字
- 类型：
Function
- 类型：
-
background：背景
- 类型：
BackgroundProps
- 类型：
-
color：默认文字颜色
- 类型：
HexColor
- 类型：
-
hidden：是否隐藏
- 类型：
boolean
- 类型：
-
slideNumber：幻灯片编号
- 类型：
SlideNumberProps
- 类型：
BackgroundProps
继承 DataOrPathProps（path、data）和 ShapeFillProps（color、transparency、type）。
-
path：背景图片 URL 或本地路径
- 类型：
string - 示例：
'https://onedrives.com/myimg.png'
- 类型：
-
data：背景图片 base64 数据
- 类型：
string - 示例：
'image/png;base64,iVtDafDrBF[...]='
- 类型：
-
color：背景颜色
- 类型：
Color（来自 ShapeFillProps） - 格式：6 位十六进制（无
#）或主题色
- 类型：
-
transparency：背景透明度
- 类型：
number - 取值范围：
0–100 - 默认值：
0
- 类型：
-
type：填充类型
- 类型：
'none' | 'solid' - 默认值：
'solid'
- 类型：
SlideNumberProps
继承 PositionProps 和 TextBaseProps。
- margin：边距
- 类型：
Margin（number | [number, number, number, number]） - 单位：pt
- 类型：
幻灯片布局 (PresLayout)
pptx.defineLayout(layout: PresLayout)
-
name：布局名称
- 类型：
string - 示例：
'LAYOUT_WIDE'
- 类型：
-
width：宽度
- 类型：
number - 单位：英寸
- 类型：
-
height：高度
- 类型：
number - 单位：英寸
- 类型：
标准布局尺寸
| 常量名 | 宽度 | 高度 |
|---|---|---|
LAYOUT_4x3 |
10" | 7.5" |
LAYOUT_16x9 |
10" | 5.625" |
LAYOUT_16x10 |
10" | 6.25" |
LAYOUT_WIDE |
13.33" | 7.5" |
节属性 (SectionProps)
pptx.addSection(props: SectionProps)
-
title：节标题
- 类型：
string
- 类型：
-
order：节顺序
- 类型：
number - 取值范围：
1–n - 说明：在指定索引添加节
- 类型：
已废弃参数 (BackgroundProps)
| 已废弃参数 | 替代参数 | 废弃版本 |
|---|---|---|
fill |
ShapeFillProps.color |
v3.6.0 |
src |
DataOrPathProps.path |
v3.6.0 |
bkgd (Slide 类) |
background |
v3.3.0 |