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>
165 lines
3.9 KiB
Markdown
165 lines
3.9 KiB
Markdown
# 输出参数 (Output Props)
|
||
|
||
输出参数用于导出演示文稿，支持 `writeFile()`（写入文件）、`write()`（返回数据）和 `stream()`（返回流）三种方式。
|
||
|
||
---
|
||
|
||
## 输出方法
|
||
|
||
### pptx.writeFile()
|
||
|
||
```ts
|
||
pptx.writeFile(props?: WriteFileProps): Promise<string>
|
||
```
|
||
|
||
- **fileName**：导出文件名
|
||
- 类型：`string`
|
||
- 默认值：`'Presentation.pptx'`
|
||
|
||
- **compression**：是否启用压缩
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
- 说明：可显著减小文件体积，但导出耗时略长
|
||
- 始于：v3.5.0
|
||
|
||
### pptx.write()
|
||
|
||
```ts
|
||
pptx.write(props?: WriteProps): Promise<string | ArrayBuffer | Blob | Uint8Array>
|
||
```
|
||
|
||
- **outputType**：输出类型
|
||
- 类型：`WRITE_OUTPUT_TYPE`
|
||
- 取值范围：`'arraybuffer' | 'base64' | 'binarystring' | 'blob' | 'nodebuffer' | 'uint8array' | 'STREAM'`
|
||
- 默认值：`'blob'`
|
||
|
||
- **compression**：是否启用压缩
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
- 始于：v3.5.0
|
||
|
||
### pptx.stream()
|
||
|
||
```ts
|
||
pptx.stream(props?: WriteBaseProps): Promise<string | ArrayBuffer | Blob | Uint8Array>
|
||
```
|
||
|
||
- **compression**：是否启用压缩
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
- 始于：v3.5.0
|
||
|
||
---
|
||
|
||
## WriteBaseProps
|
||
|
||
`writeFile()` 和 `stream()` 的输出基础属性。
|
||
|
||
- **compression**：压缩选项
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
- 始于：v3.5.0
|
||
- 说明：启用 Zip 压缩以减小文件体积
|
||
|
||
---
|
||
|
||
## WriteProps
|
||
|
||
继承 `WriteBaseProps`，用于 `write()` 方法。
|
||
|
||
- **outputType**：输出类型
|
||
- 类型：`WRITE_OUTPUT_TYPE`
|
||
- 取值范围：`'arraybuffer' | 'base64' | 'binarystring' | 'blob' | 'nodebuffer' | 'uint8array' | 'STREAM'`
|
||
- 默认值：`'blob'`
|
||
|
||
- **compression**：压缩选项
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
|
||
---
|
||
|
||
## WriteFileProps
|
||
|
||
继承 `WriteBaseProps`，用于 `writeFile()` 方法。
|
||
|
||
- **fileName**：导出文件名
|
||
- 类型：`string`
|
||
- 默认值：`'Presentation.pptx'`
|
||
|
||
- **compression**：压缩选项
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
|
||
---
|
||
|
||
## OutputType 枚举
|
||
|
||
| 常量 | 值 | 说明 |
|
||
|---|---|---|
|
||
| `OutputType.arraybuffer` | `'arraybuffer'` | ArrayBuffer |
|
||
| `OutputType.base64` | `'base64'` | Base64 字符串 |
|
||
| `OutputType.binarystring` | `'binarystring'` | 二进制字符串 |
|
||
| `OutputType.blob` | `'blob'` | Blob 对象（默认） |
|
||
| `OutputType.nodebuffer` | `'nodebuffer'` | Node.js Buffer |
|
||
| `OutputType.uint8array` | `'uint8array'` | Uint8Array |
|
||
|
||
## JSZIP_OUTPUT_TYPE
|
||
|
||
```ts
|
||
type JSZIP_OUTPUT_TYPE = 'arraybuffer' | 'base64' | 'binarystring' | 'blob' | 'nodebuffer' | 'uint8array'
|
||
```
|
||
|
||
## WRITE_OUTPUT_TYPE
|
||
|
||
```ts
|
||
type WRITE_OUTPUT_TYPE = JSZIP_OUTPUT_TYPE | 'STREAM'
|
||
```
|
||
|
||
---
|
||
|
||
## Presentation 属性
|
||
|
||
导出前的演示文稿元数据属性。
|
||
|
||
- **author**：作者
|
||
- 类型：`string`
|
||
- 说明：演示文稿作者名称
|
||
|
||
- **company**：公司
|
||
- 类型：`string`
|
||
- 说明：公司名称
|
||
|
||
- **layout**：布局名称
|
||
- 类型：`string`
|
||
- 说明：当前演示文稿布局
|
||
- 标准值：`'LAYOUT_4x3'`、`'LAYOUT_16x9'`、`'LAYOUT_16x10'`、`'LAYOUT_WIDE'`
|
||
|
||
- **rtlMode**：从右向左模式
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
|
||
- **revision**：修订号
|
||
- 类型：`string`
|
||
- 说明：必须为整数（不含小数点或逗号），否则 PowerPoint 打开时会报错
|
||
|
||
- **subject**：主题
|
||
- 类型：`string`
|
||
- 说明：演示文稿主题
|
||
|
||
- **theme**：主题字体
|
||
- 类型：`ThemeProps`
|
||
- 子参数：
|
||
- **theme.headFontFace**：标题字体（默认 `'Calibri Light'`）
|
||
- **theme.bodyFontFace**：正文字体（默认 `'Calibri'`）
|
||
|
||
- **title**：演示文稿标题
|
||
- 类型：`string`
|
||
|
||
- **masterSlide**：当前母版
|
||
- 类型：`PresSlide`
|
||
- 说明：当前演示文稿的母版幻灯片对象
|
||
|
||
- **presLayout**：布局信息
|
||
- 类型：`PresLayout`
|
||
- 说明：只读，包含 `name`（布局名称）、`width`（宽度，英寸）、`height`（高度，英寸）
|