将 README.md 拆分为多个专题文档,减少认知负荷: - 用户文档迁移到 docs/ (用户指南、元素、模板、参考等) - 开发文档迁移到 docs/development/ (架构、模块、规范) - README.md 精简至 ~290 行,仅保留概览和导航 - 删除 README_DEV.md,内容已迁移 - 归档 OpenSpec 变更 refactor-docs-progressive-disclosure
2.9 KiB
2.9 KiB
表格元素
表格元素用于在幻灯片中创建表格。
基本语法
- type: table
position: [x, y]
col_widths: [2, 2, 2] # 每列宽度(英寸)
data:
- ["表头1", "表头2", "表头3"]
- ["数据1", "数据2", "数据3"]
- ["数据4", "数据5", "数据6"]
font:
family: "Arial"
size: 14
color: "#333333"
header_font:
bold: true
color: "#ffffff"
style:
header_bg: "#4a90e2"
属性
| 属性 | 类型 | 必需 | 说明 |
|---|---|---|---|
type |
字符串 | 是 | 必须为 "table" |
position |
数组 | 是 | 表格位置 [x, y](英寸) |
col_widths |
数组 | 是 | 每列宽度(英寸) |
data |
数组 | 是 | 表格数据(二维数组) |
font |
对象 | 否 | 数据单元格字体样式 |
header_font |
对象 | 否 | 表头单元格字体样式 |
style |
对象 | 否 | 表格样式 |
字体配置
font(数据单元格)
数据单元格的字体样式:
font:
family: "Arial"
size: 14
color: "#333333"
bold: false
header_font(表头单元格)
表头单元格的字体样式。如果未定义,继承 font 的配置:
header_font:
bold: true
color: "#ffffff"
# 其他属性继承自 font
style(表格样式)
style:
header_bg: "#4a90e2" # 表头背景色
示例
基本表格
slides:
- elements:
- type: table
position: [1, 1]
col_widths: [2, 2, 2]
data:
- ["姓名", "年龄", "城市"]
- ["张三", "25", "北京"]
- ["李四", "30", "上海"]
样式化表格
slides:
- elements:
- type: table
position: [1, 1]
col_widths: [2.5, 2.5, 2.5]
data:
- ["产品", "价格", "库存"]
- ["产品A", "100元", "50"]
- ["产品B", "200元", "30"]
font:
family: "sans"
size: 14
color: "#333333"
header_font:
bold: true
color: "#ffffff"
style:
header_bg: "#3498db"
使用字体主题
metadata:
fonts:
table-font:
family: "sans"
size: 14
color: "#333333"
slides:
- elements:
- type: table
position: [1, 1]
col_widths: [2, 2, 2]
data:
- ["列1", "列2"]
- ["数据1", "数据2"]
font: "@table-font"
header_font:
parent: "@table-font"
bold: true
color: "#ffffff"
style:
header_bg: "#4a90e2"
注意事项
col_widths数组长度必须与每行的列数一致- 所有行的列数必须相同
- 第一行默认为表头