204 lines
5.2 KiB
Markdown
204 lines
5.2 KiB
Markdown
# 表格参数 (Table Props)
|
||
|
||
表格参数来自 `TableProps`（继承 `TextBaseProps`、`PositionProps`）和 `TableCellProps`（继承 `TextBaseProps`），用于 `slide.addTable()` 方法。
|
||
|
||
---
|
||
|
||
## 位置属性 (PositionProps)
|
||
|
||
- **x**：水平位置
|
||
- 类型：`Coord`（`number | `${number}%``）
|
||
- 单位：英寸（number）或百分比（`'50%'`）
|
||
|
||
- **y**：垂直位置
|
||
- 类型：`Coord`
|
||
- 单位：英寸或百分比
|
||
|
||
- **w**：宽度
|
||
- 类型：`Coord`
|
||
- 单位：英寸或百分比
|
||
|
||
- **h**：高度
|
||
- 类型：`Coord`
|
||
- 单位：英寸或百分比
|
||
|
||
---
|
||
|
||
## 表格专有属性 (TableProps)
|
||
|
||
- **autoPage**：是否启用自动分页
|
||
- 类型：`boolean`
|
||
- 说明：内容溢出时自动创建新幻灯片
|
||
- 默认值：`false`
|
||
|
||
- **autoPageCharWeight**：自动分页字符权重
|
||
- 类型：`number`
|
||
- 取值范围：`-1.0`–`1.0`
|
||
- 默认值：`0.0`
|
||
- 说明：调整每行字符数，正值使行更长
|
||
|
||
- **autoPageLineWeight**：自动分页行权重
|
||
- 类型：`number`
|
||
- 取值范围：`-1.0`–`1.0`
|
||
- 默认值：`0.0`
|
||
- 说明：调整每页行数，正值使表格更高
|
||
|
||
- **autoPageRepeatHeader**：自动分页时重复表头
|
||
- 类型：`boolean`
|
||
- 默认值：`false`
|
||
- 始于：v3.3.0
|
||
|
||
- **autoPageHeaderRows**：表头行数
|
||
- 类型：`number`
|
||
- 说明：`autoPageRepeatHeader` 为 `true` 时需设置
|
||
- 默认值：`1`
|
||
- 示例：`2`（在前两行在新页上重复）
|
||
- 始于：v3.3.0
|
||
|
||
- **autoPageSlideStartY**：自动分页新幻灯片的起始 Y 位置
|
||
- 类型：`number`
|
||
- 默认值：幻灯片上边距
|
||
|
||
- **border**：表格边框
|
||
- 类型：`BorderProps | [BorderProps, BorderProps, BorderProps, BorderProps]`
|
||
- 取值范围：单个值应用于所有四边；数组按上右下左（TRBL）顺序应用于各边
|
||
|
||
- **colW**：列宽
|
||
- 类型：`number | number[]`
|
||
- 单位：英寸
|
||
- 说明：单个值均匀分配；数组按列依次应用
|
||
- 默认值：基于 `w` 的等宽列
|
||
|
||
- **fill**：单元格填充
|
||
- 类型：`ShapeFillProps`
|
||
- 子参数：
|
||
- **fill.color**：填充颜色
|
||
- 类型：`Color`
|
||
- **fill.transparency**：透明度
|
||
- 类型：`number`
|
||
- 取值范围：`0`–`100`
|
||
- 默认值：`0`
|
||
- **fill.type**：填充类型
|
||
- 类型：`'none' | 'solid'`
|
||
- 默认值：`'solid'`
|
||
|
||
- **margin**：单元格边距
|
||
- 类型：`Margin`（`number | [number, number, number, number]`）
|
||
- 单位：pt
|
||
- 说明：影响所有单元格，可被单元格级选项覆盖
|
||
- 默认值：PowerPoint 默认边距
|
||
|
||
- **objectName**：对象名称
|
||
- 类型：`string`
|
||
- 说明：替代默认的 "Object N" 名称
|
||
- 默认值：`'Object 1'`
|
||
|
||
- **rowH**：行高
|
||
- 类型：`number | number[]`
|
||
- 单位：英寸
|
||
- 说明：单个值均匀分配；数组按行依次应用
|
||
- 默认值：基于 `h` 的等高行
|
||
|
||
- **verbose**：详细模式（开发工具）
|
||
- 类型：`boolean`
|
||
- 说明：在控制台输出自动分页计算的详细信息
|
||
- 默认值：`false`
|
||
|
||
- **align**：水平对齐
|
||
- 类型：`'left' | 'center' | 'right' | 'justify'`
|
||
- 默认值：`'left'`
|
||
|
||
- **valign**：垂直对齐
|
||
- 类型：`'top' | 'middle' | 'bottom'`
|
||
- 默认值：`'top'`
|
||
|
||
---
|
||
|
||
## 表格行与单元格
|
||
|
||
- **TableCell**：单个单元格
|
||
- 类型：`{ text?: string | TableCell[], options?: TableCellProps }`
|
||
- 说明：`text` 可为字符串或嵌套表格；`options` 为单元格样式
|
||
|
||
- **TableRow**：表格行
|
||
- 类型：`TableCell[]`
|
||
- 说明：每行由单元格数组组成
|
||
|
||
- **TableRowSlide**：自动分页产出
|
||
- 类型：`{ rows: TableRow[] }`
|
||
|
||
---
|
||
|
||
## 表格单元格属性 (TableCellProps)
|
||
|
||
继承 `TextBaseProps`。
|
||
|
||
- **autoPageCharWeight**：自动分页字符权重
|
||
- 类型：`number`
|
||
- 取值范围：`-1.0`–`1.0`
|
||
- 默认值：`0.0`
|
||
|
||
- **autoPageLineWeight**：自动分页行权重
|
||
- 类型：`number`
|
||
- 取值范围：`-1.0`–`1.0`
|
||
- 默认值：`0.0`
|
||
|
||
- **border**：单元格边框
|
||
- 类型：`BorderProps | [BorderProps, BorderProps, BorderProps, BorderProps]`
|
||
- 说明：单个值应用于所有四边；数组按上右下左（TRBL）顺序
|
||
|
||
- **colspan**：列合并
|
||
- 类型：`number`
|
||
- 说明：跨列数
|
||
|
||
- **fill**：单元格填充
|
||
- 类型：`ShapeFillProps`
|
||
|
||
- **hyperlink**：单元格超链接
|
||
- 类型：`HyperlinkProps`
|
||
- 子参数：
|
||
- **hyperlink.slide**：链接到页码
|
||
- 类型：`number`
|
||
- **hyperlink.url**：链接 URL
|
||
- 类型：`string`
|
||
- **hyperlink.tooltip**：超链接提示
|
||
- 类型：`string`
|
||
|
||
- **margin**：单元格边距
|
||
- 类型：`Margin`
|
||
- 单位：pt
|
||
- 默认值：`0`
|
||
|
||
- **rowspan**：行合并
|
||
- 类型：`number`
|
||
- 说明：跨行数
|
||
|
||
---
|
||
|
||
## BorderProps
|
||
|
||
用于 `border` 属性的类型定义。
|
||
|
||
- **type**：边框类型
|
||
- 类型：`'none' | 'dash' | 'solid'`
|
||
- 默认值：`'solid'`
|
||
|
||
- **color**：边框颜色
|
||
- 类型：`HexColor`
|
||
- 格式：6 位十六进制（无 `#`）
|
||
- 默认值：`'666666'`
|
||
|
||
- **pt**：边框粗细
|
||
- 类型：`number`
|
||
- 单位：pt
|
||
- 默认值：`1`
|
||
|
||
---
|
||
|
||
## 已废弃参数 (TableProps)
|
||
|
||
| 已废弃参数 | 替代参数 | 废弃版本 |
|
||
|---|---|---|
|
||
| `addHeaderToEach` | `autoPageRepeatHeader` | v3.3.0 |
|
||
| `newSlideStartY` | `autoPageSlideStartY` | v3.3.0 |
|