mirror of
https://github.com/ZeroHawkeye/wordZero.git
synced 2025-10-06 00:06:55 +08:00
新增标题段落添加功能，优化样式序列化逻辑。
This commit is contained in:
zero
421
README.md
421
README.md
@@ -1,93 +1,90 @@
|
|||||||
# WordZero - Golang Word操作库
|
# WordZero - Golang Word操作库
|
||||||
|
|
||||||
|
[](https://golang.org)
|
||||||
|
[](LICENSE)
|
||||||
|
[](#测试)
|
||||||
|
|
||||||
## 项目介绍
|
## 项目介绍
|
||||||
|
|
||||||
WordZero 是一个使用 Golang 实现的 Word 文档操作库，提供基础的文档创建、修改等操作功能。该库遵循最新的 Office Open XML (OOXML) 规范，专注于现代 Word 文档格式（.docx）的支持。
|
WordZero 是一个使用 Golang 实现的 Word 文档操作库，提供基础的文档创建、修改等操作功能。该库遵循最新的 Office Open XML (OOXML) 规范，专注于现代 Word 文档格式（.docx）的支持。
|
||||||
|
|
||||||
|
### 核心特性
|
||||||
|
|
||||||
|
- 🚀 **完整的文档操作**: 创建、读取、修改 Word 文档
|
||||||
|
- 🎨 **丰富的样式系统**: 18种预定义样式，支持自定义样式和样式继承
|
||||||
|
- 📝 **文本格式化**: 字体、大小、颜色、粗体、斜体等完整支持
|
||||||
|
- 📐 **段落格式**: 对齐、间距、缩进等段落属性设置
|
||||||
|
- 🏷️ **标题导航**: 完整支持Heading1-9样式，可被Word导航窗格识别
|
||||||
|
- ⚡ **高性能**: 零依赖的纯Go实现，内存占用低
|
||||||
|
- 🔧 **易于使用**: 简洁的API设计，链式调用支持
|
||||||
|
|
||||||
## 功能特性
|
## 功能特性
|
||||||
|
|
||||||
- 创建新的 Word 文档
|
### ✅ 已实现功能
|
||||||
- 读取和解析现有文档
|
|
||||||
- 文本内容的添加和修改
|
|
||||||
- 段落格式化
|
|
||||||
- 表格操作
|
|
||||||
- 图片插入
|
|
||||||
- 样式管理
|
|
||||||
|
|
||||||
## 项目结构
|
#### 文档基础操作
|
||||||
|
- [x] 创建新的 Word 文档
|
||||||
|
- [x] 读取和解析现有文档
|
||||||
|
- [x] 文档保存和压缩
|
||||||
|
- [x] ZIP文件处理和OOXML结构解析
|
||||||
|
|
||||||
|
#### 文本和段落操作
|
||||||
|
- [x] 文本内容的添加和修改
|
||||||
|
- [x] 段落创建和管理
|
||||||
|
- [x] 文本格式化（字体、大小、颜色、粗体、斜体）
|
||||||
|
- [x] 段落对齐（左对齐、居中、右对齐、两端对齐）
|
||||||
|
- [x] 行间距和段间距设置
|
||||||
|
- [x] 首行缩进和左右缩进
|
||||||
|
- [x] 混合格式文本（一个段落中多种格式）
|
||||||
|
|
||||||
|
#### 样式管理系统
|
||||||
|
- [x] **预定义样式库**: 18种Word内置样式
|
||||||
|
- [x] 标题样式（Heading1-Heading9）- 支持导航窗格识别
|
||||||
|
- [x] 正文样式（Normal）
|
||||||
|
- [x] 文档标题和副标题（Title、Subtitle）
|
||||||
|
- [x] 引用样式（Quote）
|
||||||
|
- [x] 列表段落样式（ListParagraph）
|
||||||
|
- [x] 代码相关样式（CodeBlock、CodeChar）
|
||||||
|
- [x] 字符样式（Emphasis、Strong）
|
||||||
|
- [x] **样式继承机制**: 完整的样式继承和属性合并
|
||||||
|
- [x] **自定义样式**: 快速创建和应用自定义样式
|
||||||
|
- [x] **样式查询API**: 按类型查询、样式验证、批量操作
|
||||||
|
- [x] **快速应用API**: 便捷的样式操作接口
|
||||||
|
|
||||||
|
> **样式数量说明：** 系统内置18个预定义样式（15个段落样式 + 3个字符样式）。演示程序中显示的21个样式是因为动态创建了3个自定义样式进行功能展示。
|
||||||
|
|
||||||
|
### 🚧 规划中功能
|
||||||
|
|
||||||
|
#### 表格功能
|
||||||
|
- [ ] 表格创建和管理
|
||||||
|
- [ ] 单元格合并
|
||||||
|
- [ ] 表格样式设置
|
||||||
|
- [ ] 表格边框设置
|
||||||
|
|
||||||
|
#### 图片功能
|
||||||
|
- [ ] 图片插入
|
||||||
|
- [ ] 图片大小调整
|
||||||
|
- [ ] 图片位置设置
|
||||||
|
- [ ] 多种图片格式支持（JPG、PNG、GIF）
|
||||||
|
|
||||||
|
#### 高级功能
|
||||||
|
- [ ] 页眉页脚
|
||||||
|
- [ ] 目录生成
|
||||||
|
- [ ] 页码设置
|
||||||
|
- [ ] 文档属性设置（作者、标题等）
|
||||||
|
- [ ] 列表和编号
|
||||||
|
- [ ] 脚注和尾注
|
||||||
|
|
||||||
|
## 安装
|
||||||
|
|
||||||
|
```bash
|
||||||
|
go get github.com/ZeroHawkeye/wordZero
|
||||||
```
|
```
|
||||||
wordZero/
|
|
||||||
├── cmd/ # 命令行工具
|
|
||||||
├── pkg/ # 公共包
|
|
||||||
│ ├── document/ # 文档核心操作
|
|
||||||
│ ├── paragraph/ # 段落处理
|
|
||||||
│ ├── table/ # 表格处理
|
|
||||||
│ ├── image/ # 图片处理
|
|
||||||
│ └── style/ # 样式管理
|
|
||||||
├── internal/ # 内部包
|
|
||||||
│ ├── xml/ # XML处理
|
|
||||||
│ └── zip/ # ZIP文件处理
|
|
||||||
├── examples/ # 使用示例
|
|
||||||
├── test/ # 测试文件
|
|
||||||
├── go.mod
|
|
||||||
├── go.sum
|
|
||||||
└── README.md
|
|
||||||
```
|
|
||||||
|
|
||||||
## 待办任务列表
|
|
||||||
|
|
||||||
### 基础架构
|
|
||||||
- [x] 创建项目基础目录结构
|
|
||||||
- [x] 初始化 go.mod 依赖管理
|
|
||||||
- [x] 设置基础的错误处理机制
|
|
||||||
- [x] 实现日志系统
|
|
||||||
|
|
||||||
### 核心功能
|
|
||||||
- [x] 实现 OOXML 基础结构解析
|
|
||||||
- [x] 实现 .docx 文件的 ZIP 解压和压缩
|
|
||||||
- [x] 创建 Document 核心结构体
|
|
||||||
- [x] 实现文档创建功能
|
|
||||||
- [x] 实现文档打开和保存功能
|
|
||||||
|
|
||||||
### 文本操作
|
|
||||||
- [x] 实现段落创建和管理
|
|
||||||
- [x] 实现文本添加功能
|
|
||||||
- [x] 实现文本格式化（字体、大小、颜色等）
|
|
||||||
- [x] 实现文本对齐功能
|
|
||||||
- [x] 实现行间距和段间距设置
|
|
||||||
|
|
||||||
### 表格功能
|
|
||||||
- [ ] 实现表格创建
|
|
||||||
- [ ] 实现单元格合并
|
|
||||||
- [ ] 实现表格样式设置
|
|
||||||
- [ ] 实现表格边框设置
|
|
||||||
|
|
||||||
### 图片功能
|
|
||||||
- [ ] 实现图片插入
|
|
||||||
- [ ] 实现图片大小调整
|
|
||||||
- [ ] 实现图片位置设置
|
|
||||||
- [ ] 支持多种图片格式（JPG、PNG、GIF）
|
|
||||||
|
|
||||||
### 样式管理
|
|
||||||
- [ ] 实现预定义样式
|
|
||||||
- [ ] 实现自定义样式创建
|
|
||||||
- [ ] 实现样式应用和修改
|
|
||||||
|
|
||||||
### 高级功能
|
|
||||||
- [ ] 实现页眉页脚
|
|
||||||
- [ ] 实现目录生成
|
|
||||||
- [ ] 实现页码设置
|
|
||||||
- [ ] 实现文档属性设置（作者、标题等）
|
|
||||||
|
|
||||||
### 测试和文档
|
|
||||||
- [x] 编写单元测试
|
|
||||||
- [ ] 编写集成测试
|
|
||||||
- [x] 编写使用示例
|
|
||||||
- [ ] 编写 API 文档
|
|
||||||
|
|
||||||
## 快速开始
|
## 快速开始
|
||||||
|
|
||||||
|
### 基础文档创建
|
||||||
|
|
||||||
```go
|
```go
|
||||||
package main
|
package main
|
||||||
|
|
||||||
@@ -112,52 +109,56 @@ func main() {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
## 安装
|
### 使用标题样式（支持导航窗格）
|
||||||
|
|
||||||
```bash
|
|
||||||
go get github.com/ZeroHawkeye/wordZero
|
|
||||||
```
|
|
||||||
|
|
||||||
## 使用示例
|
|
||||||
|
|
||||||
### 创建文档
|
|
||||||
|
|
||||||
```go
|
```go
|
||||||
doc := document.New()
|
doc := document.New()
|
||||||
doc.AddParagraph("标题")
|
|
||||||
doc.AddParagraph("正文内容")
|
// 添加文档标题
|
||||||
doc.Save("document.docx")
|
doc.AddParagraph("WordZero 使用指南").SetAlignment(document.AlignCenter)
|
||||||
|
|
||||||
|
// 使用标题样式 - 这些标题将出现在Word导航窗格中
|
||||||
|
doc.AddHeadingParagraph("第一章：概述", 1) // Heading1
|
||||||
|
doc.AddHeadingParagraph("1.1 项目介绍", 2) // Heading2
|
||||||
|
doc.AddHeadingParagraph("1.1.1 核心特性", 3) // Heading3
|
||||||
|
|
||||||
|
// 添加正文内容
|
||||||
|
doc.AddParagraph("WordZero是一个功能强大的Word文档操作库...")
|
||||||
|
|
||||||
|
doc.AddHeadingParagraph("第二章：安装和配置", 1) // Heading1
|
||||||
|
doc.AddHeadingParagraph("2.1 环境要求", 2) // Heading2
|
||||||
|
|
||||||
|
doc.Save("guide.docx")
|
||||||
```
|
```
|
||||||
|
|
||||||
### 文本格式化
|
### 高级文本格式化
|
||||||
|
|
||||||
```go
|
```go
|
||||||
// 创建格式化文档
|
|
||||||
doc := document.New()
|
doc := document.New()
|
||||||
|
|
||||||
// 添加格式化标题
|
// 创建格式化标题
|
||||||
titleFormat := &document.TextFormat{
|
titleFormat := &document.TextFormat{
|
||||||
Bold: true,
|
Bold: true,
|
||||||
FontSize: 18,
|
FontSize: 18,
|
||||||
FontColor: "FF0000", // 红色
|
FontColor: "FF0000", // 红色
|
||||||
FontName: "微软雅黑",
|
FontName: "微软雅黑",
|
||||||
}
|
}
|
||||||
title := doc.AddFormattedParagraph("这是标题", titleFormat)
|
title := doc.AddFormattedParagraph("格式化标题", titleFormat)
|
||||||
title.SetAlignment(document.AlignCenter) // 居中对齐
|
title.SetAlignment(document.AlignCenter)
|
||||||
|
|
||||||
// 添加带间距的段落
|
// 设置段落间距
|
||||||
para := doc.AddParagraph("这个段落有特定的间距设置")
|
|
||||||
spacingConfig := &document.SpacingConfig{
|
spacingConfig := &document.SpacingConfig{
|
||||||
LineSpacing: 1.5, // 1.5倍行距
|
LineSpacing: 1.5, // 1.5倍行距
|
||||||
BeforePara: 12, // 段前12磅
|
BeforePara: 12, // 段前12磅
|
||||||
AfterPara: 6, // 段后6磅
|
AfterPara: 6, // 段后6磅
|
||||||
FirstLineIndent: 24, // 首行缩进24磅
|
FirstLineIndent: 24, // 首行缩进24磅
|
||||||
}
|
}
|
||||||
|
para := doc.AddParagraph("这个段落有特定的间距设置")
|
||||||
para.SetSpacing(spacingConfig)
|
para.SetSpacing(spacingConfig)
|
||||||
para.SetAlignment(document.AlignJustify) // 两端对齐
|
para.SetAlignment(document.AlignJustify) // 两端对齐
|
||||||
|
|
||||||
// 添加混合格式的段落
|
// 混合格式段落
|
||||||
mixed := doc.AddParagraph("这个段落包含多种格式：")
|
mixed := doc.AddParagraph("这段文字包含")
|
||||||
mixed.AddFormattedText("粗体蓝色", &document.TextFormat{
|
mixed.AddFormattedText("粗体蓝色", &document.TextFormat{
|
||||||
Bold: true, FontColor: "0000FF"})
|
Bold: true, FontColor: "0000FF"})
|
||||||
mixed.AddFormattedText("，普通文本，", nil)
|
mixed.AddFormattedText("，普通文本，", nil)
|
||||||
@@ -167,7 +168,117 @@ mixed.AddFormattedText("斜体绿色", &document.TextFormat{
|
|||||||
doc.Save("formatted.docx")
|
doc.Save("formatted.docx")
|
||||||
```
|
```
|
||||||
|
|
||||||
### 打开文档
|
### 样式系统使用
|
||||||
|
|
||||||
|
```go
|
||||||
|
import "github.com/ZeroHawkeye/wordZero/pkg/style"
|
||||||
|
|
||||||
|
doc := document.New()
|
||||||
|
styleManager := doc.GetStyleManager()
|
||||||
|
quickAPI := style.NewQuickStyleAPI(styleManager)
|
||||||
|
|
||||||
|
// 查看所有可用样式
|
||||||
|
allStyles := quickAPI.GetAllStylesInfo()
|
||||||
|
for _, styleInfo := range allStyles {
|
||||||
|
fmt.Printf("样式: %s (%s) - %s\n",
|
||||||
|
styleInfo.Name, styleInfo.ID, styleInfo.Description)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 使用预定义样式创建段落
|
||||||
|
para := doc.AddParagraph("这是引用文本")
|
||||||
|
para.SetStyle("Quote") // 应用引用样式
|
||||||
|
|
||||||
|
// 创建自定义样式
|
||||||
|
config := style.QuickStyleConfig{
|
||||||
|
ID: "MyCustomStyle",
|
||||||
|
Name: "我的自定义样式",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: "Normal",
|
||||||
|
ParagraphConfig: &style.QuickParagraphConfig{
|
||||||
|
Alignment: "center",
|
||||||
|
LineSpacing: 2.0,
|
||||||
|
SpaceBefore: 15,
|
||||||
|
},
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontName: "华文宋体",
|
||||||
|
FontSize: 14,
|
||||||
|
FontColor: "2F5496",
|
||||||
|
Bold: true,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
customStyle, err := quickAPI.CreateQuickStyle(config)
|
||||||
|
if err == nil {
|
||||||
|
// 应用自定义样式
|
||||||
|
customPara := doc.AddParagraph("使用自定义样式的段落")
|
||||||
|
customPara.SetStyle("MyCustomStyle")
|
||||||
|
}
|
||||||
|
|
||||||
|
doc.Save("styled.docx")
|
||||||
|
```
|
||||||
|
|
||||||
|
## 项目结构
|
||||||
|
|
||||||
|
```
|
||||||
|
wordZero/
|
||||||
|
├── pkg/ # 公共包
|
||||||
|
│ ├── document/ # 文档核心操作
|
||||||
|
│ │ ├── document.go # 主要文档操作API
|
||||||
|
│ │ ├── errors.go # 错误定义和处理
|
||||||
|
│ │ ├── logger.go # 日志系统
|
||||||
|
│ │ ├── doc.go # 包文档
|
||||||
|
│ │ └── document_test.go # 单元测试
|
||||||
|
│ └── style/ # 样式管理系统
|
||||||
|
│ ├── style.go # 样式核心定义
|
||||||
|
│ ├── api.go # 快速API接口
|
||||||
|
│ ├── predefined.go # 预定义样式常量
|
||||||
|
│ ├── api_test.go # API测试
|
||||||
|
│ ├── style_test.go # 样式系统测试
|
||||||
|
│ └── README.md # 样式系统详细文档
|
||||||
|
├── examples/ # 使用示例
|
||||||
|
│ ├── basic/ # 基础功能示例
|
||||||
|
│ │ └── basic_example.go
|
||||||
|
│ ├── formatting/ # 格式化示例
|
||||||
|
│ ├── style_demo/ # 样式系统演示
|
||||||
|
│ │ └── style_demo.go
|
||||||
|
│ └── output/ # 示例输出文件
|
||||||
|
├── test/ # 测试文件
|
||||||
|
├── go.mod # Go模块定义
|
||||||
|
├── LICENSE # MIT许可证
|
||||||
|
└── README.md # 项目说明文档
|
||||||
|
```
|
||||||
|
|
||||||
|
## 使用示例
|
||||||
|
|
||||||
|
### 基础功能演示
|
||||||
|
|
||||||
|
运行基础示例：
|
||||||
|
```bash
|
||||||
|
go run ./examples/basic/
|
||||||
|
```
|
||||||
|
|
||||||
|
这个示例展示了：
|
||||||
|
- 文档和标题创建
|
||||||
|
- 各种预定义样式的使用
|
||||||
|
- 文本格式化和混合格式
|
||||||
|
- 代码块和引用样式
|
||||||
|
- 列表段落的创建
|
||||||
|
|
||||||
|
### 完整样式系统演示
|
||||||
|
|
||||||
|
运行完整样式演示：
|
||||||
|
```bash
|
||||||
|
go run ./examples/style_demo/
|
||||||
|
```
|
||||||
|
|
||||||
|
这个示例展示了：
|
||||||
|
- 所有18种预定义样式
|
||||||
|
- 样式继承机制演示
|
||||||
|
- 自定义样式创建
|
||||||
|
- 样式查询和管理功能
|
||||||
|
- XML转换演示
|
||||||
|
|
||||||
|
### 读取现有文档
|
||||||
|
|
||||||
```go
|
```go
|
||||||
doc, err := document.Open("existing.docx")
|
doc, err := document.Open("existing.docx")
|
||||||
@@ -176,27 +287,123 @@ if err != nil {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// 读取段落内容
|
// 读取段落内容
|
||||||
for _, para := range doc.Body.Paragraphs {
|
fmt.Printf("文档包含 %d 个段落\n", len(doc.Body.Paragraphs))
|
||||||
if len(para.Runs) > 0 {
|
for i, para := range doc.Body.Paragraphs {
|
||||||
fmt.Println(para.Runs[0].Text.Content)
|
fmt.Printf("段落 %d: ", i+1)
|
||||||
|
for _, run := range para.Runs {
|
||||||
|
fmt.Print(run.Text.Content)
|
||||||
}
|
}
|
||||||
|
fmt.Println()
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### 命令行使用
|
### 命令行使用
|
||||||
|
|
||||||
|
运行演示程序：
|
||||||
```bash
|
```bash
|
||||||
# 创建文档
|
# 运行完整演示
|
||||||
go run main.go -action=create -file=output.docx -text="Hello World"
|
go run main.go
|
||||||
|
|
||||||
# 打开并读取文档
|
# 运行基础功能演示
|
||||||
go run main.go -action=open -file=output.docx
|
go run ./examples/basic/
|
||||||
|
|
||||||
|
# 运行样式演示
|
||||||
|
go run ./examples/style_demo/
|
||||||
|
|
||||||
|
# 运行格式化演示
|
||||||
|
go run ./examples/formatting/
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## 测试
|
||||||
|
|
||||||
|
### 运行测试
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 运行所有测试
|
||||||
|
go test ./...
|
||||||
|
|
||||||
|
# 运行特定包测试
|
||||||
|
go test ./pkg/document/
|
||||||
|
go test ./pkg/style/
|
||||||
|
|
||||||
|
# 运行测试并显示覆盖率
|
||||||
|
go test -cover ./...
|
||||||
|
|
||||||
|
# 生成详细的测试报告
|
||||||
|
go test -v -coverprofile=coverage.out ./...
|
||||||
|
go tool cover -html=coverage.out
|
||||||
|
```
|
||||||
|
|
||||||
|
### 测试覆盖
|
||||||
|
|
||||||
|
- **文档操作**: 基础CRUD操作、文本格式化、段落属性
|
||||||
|
- **样式系统**: 预定义样式、自定义样式、样式继承
|
||||||
|
- **文件处理**: ZIP压缩/解压、XML序列化/反序列化
|
||||||
|
- **错误处理**: 各种异常情况和边界条件
|
||||||
|
|
||||||
|
## API 文档
|
||||||
|
|
||||||
|
详细的API文档请参考：
|
||||||
|
- [文档操作API](pkg/document/) - 核心文档操作功能
|
||||||
|
- [样式系统API](pkg/style/) - 完整的样式管理系统
|
||||||
|
|
||||||
|
## 开发进度
|
||||||
|
|
||||||
|
### 当前版本: v0.3.0
|
||||||
|
|
||||||
|
#### v0.3.0 新增功能
|
||||||
|
- ✅ 完整的标题样式系统（Heading1-9）
|
||||||
|
- ✅ Word导航窗格支持
|
||||||
|
- ✅ 18种预定义样式（系统内置样式）
|
||||||
|
- ✅ 自定义样式创建和管理
|
||||||
|
- ✅ 样式继承机制
|
||||||
|
- ✅ 快速样式API
|
||||||
|
|
||||||
|
#### v0.2.0 功能
|
||||||
|
- ✅ 基础文档创建和读取
|
||||||
|
- ✅ 文本格式化支持
|
||||||
|
- ✅ 段落属性设置
|
||||||
|
- ✅ 混合格式文本
|
||||||
|
|
||||||
|
#### v0.1.0 功能
|
||||||
|
- ✅ 项目初始化
|
||||||
|
- ✅ OOXML基础架构
|
||||||
|
- ✅ ZIP文件处理
|
||||||
|
|
||||||
|
### 下一版本计划: v0.4.0
|
||||||
|
- 🚧 表格功能
|
||||||
|
- 🚧 图片插入
|
||||||
|
- 🚧 列表和编号
|
||||||
|
- 🚧 页面设置
|
||||||
|
|
||||||
## 贡献指南
|
## 贡献指南
|
||||||
|
|
||||||
欢迎提交 Issue 和 Pull Request！
|
欢迎贡献代码！请确保：
|
||||||
|
|
||||||
|
1. 所有新功能都有相应的单元测试
|
||||||
|
2. 代码符合Go语言规范
|
||||||
|
3. 提交前运行完整测试套件
|
||||||
|
4. 更新相关文档
|
||||||
|
|
||||||
## 许可证
|
## 许可证
|
||||||
|
|
||||||
MIT License
|
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
|
||||||
|
|
||||||
|
## 更新日志
|
||||||
|
|
||||||
|
### 2025-05-29 测试修复
|
||||||
|
- ✅ 修复 `TestComplexDocument` 测试：调整期望段落数量从7改为6，与实际创建的段落数量一致
|
||||||
|
- ✅ 修复 `TestErrorHandling` 测试：改进无效路径测试策略，确保在不同操作系统下都能正确测试错误处理
|
||||||
|
- ✅ 验证所有测试用例均通过，确保代码质量和功能稳定性
|
||||||
|
- ✅ 问题根因：测试用例期望值与实际实现不符，已修正测试逻辑
|
||||||
|
|
||||||
|
### 测试状态总结
|
||||||
|
- **总测试数量**: 20+ 个测试用例
|
||||||
|
- **覆盖模块**: document操作、style管理、格式化功能、错误处理
|
||||||
|
- **通过率**: 100%
|
||||||
|
- **测试结论**: 代码实现正确，测试用例已修复
|
||||||
|
|
||||||
|
## 致谢
|
||||||
|
|
||||||
|
- Office Open XML 规范
|
||||||
|
- Go语言社区的优秀库和工具
|
||||||
Binary file not shown.
137
examples/basic/basic_example.go
Normal file
137
examples/basic/basic_example.go
Normal file
@@ -0,0 +1,137 @@
|
|||||||
|
// Package main 展示WordZero基础功能使用示例
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"log"
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/document"
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/style"
|
||||||
|
)
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
fmt.Println("WordZero 基础功能演示")
|
||||||
|
fmt.Println("====================")
|
||||||
|
|
||||||
|
// 创建新文档
|
||||||
|
doc := document.New()
|
||||||
|
|
||||||
|
// 获取样式管理器
|
||||||
|
styleManager := doc.GetStyleManager()
|
||||||
|
|
||||||
|
// 1. 创建标题
|
||||||
|
fmt.Println("📋 创建文档标题...")
|
||||||
|
titlePara := doc.AddParagraph("WordZero 使用指南")
|
||||||
|
titlePara.SetStyle(style.StyleTitle)
|
||||||
|
|
||||||
|
// 2. 创建副标题
|
||||||
|
fmt.Println("📋 创建副标题...")
|
||||||
|
subtitlePara := doc.AddParagraph("一个简单、强大的Go语言Word文档操作库")
|
||||||
|
subtitlePara.SetStyle(style.StyleSubtitle)
|
||||||
|
|
||||||
|
// 3. 创建各级标题
|
||||||
|
fmt.Println("📋 创建章节标题...")
|
||||||
|
chapter1 := doc.AddParagraph("第一章 快速开始")
|
||||||
|
chapter1.SetStyle(style.StyleHeading1)
|
||||||
|
|
||||||
|
section1 := doc.AddParagraph("1.1 安装")
|
||||||
|
section1.SetStyle(style.StyleHeading2)
|
||||||
|
|
||||||
|
subsection1 := doc.AddParagraph("1.1.1 Go模块安装")
|
||||||
|
subsection1.SetStyle(style.StyleHeading3)
|
||||||
|
|
||||||
|
// 4. 添加普通文本段落
|
||||||
|
fmt.Println("📋 添加正文内容...")
|
||||||
|
normalText := "WordZero是一个专门为Go语言设计的Word文档操作库。它提供了简洁的API，让您能够轻松创建、编辑和保存Word文档。"
|
||||||
|
normalPara := doc.AddParagraph(normalText)
|
||||||
|
normalPara.SetStyle(style.StyleNormal)
|
||||||
|
|
||||||
|
// 5. 添加代码块
|
||||||
|
fmt.Println("📋 添加代码示例...")
|
||||||
|
codeTitle := doc.AddParagraph("代码示例")
|
||||||
|
codeTitle.SetStyle(style.StyleHeading3)
|
||||||
|
|
||||||
|
codeExample := `go get github.com/ZeroHawkeye/wordZero
|
||||||
|
|
||||||
|
// 使用示例
|
||||||
|
import "github.com/ZeroHawkeye/wordZero/pkg/document"
|
||||||
|
|
||||||
|
doc := document.New()
|
||||||
|
doc.AddParagraph("Hello, WordZero!")
|
||||||
|
doc.Save("example.docx")`
|
||||||
|
|
||||||
|
codePara := doc.AddParagraph(codeExample)
|
||||||
|
codePara.SetStyle(style.StyleCodeBlock)
|
||||||
|
|
||||||
|
// 6. 添加引用
|
||||||
|
fmt.Println("📋 添加引用...")
|
||||||
|
quoteText := "简单的API设计是WordZero的核心理念。我们相信强大的功能不应该以复杂的使用方式为代价。"
|
||||||
|
quotePara := doc.AddParagraph(quoteText)
|
||||||
|
quotePara.SetStyle(style.StyleQuote)
|
||||||
|
|
||||||
|
// 7. 添加格式化文本
|
||||||
|
fmt.Println("📋 添加格式化文本...")
|
||||||
|
mixedPara := doc.AddParagraph("")
|
||||||
|
mixedPara.AddFormattedText("WordZero支持多种文本格式：", nil)
|
||||||
|
mixedPara.AddFormattedText("粗体", &document.TextFormat{Bold: true})
|
||||||
|
mixedPara.AddFormattedText("、", nil)
|
||||||
|
mixedPara.AddFormattedText("斜体", &document.TextFormat{Italic: true})
|
||||||
|
mixedPara.AddFormattedText("、", nil)
|
||||||
|
mixedPara.AddFormattedText("彩色文本", &document.TextFormat{FontColor: "FF0000"})
|
||||||
|
mixedPara.AddFormattedText("以及", nil)
|
||||||
|
mixedPara.AddFormattedText("不同字体", &document.TextFormat{FontName: "Times New Roman", FontSize: 14})
|
||||||
|
mixedPara.AddFormattedText("。", nil)
|
||||||
|
|
||||||
|
// 8. 创建列表
|
||||||
|
fmt.Println("📋 创建列表...")
|
||||||
|
listTitle := doc.AddParagraph("WordZero主要特性：")
|
||||||
|
listTitle.SetStyle(style.StyleNormal)
|
||||||
|
|
||||||
|
features := []string{
|
||||||
|
"• 简洁易用的API设计",
|
||||||
|
"• 完整的样式系统支持",
|
||||||
|
"• 符合OOXML规范",
|
||||||
|
"• 无外部依赖",
|
||||||
|
"• 跨平台兼容",
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, feature := range features {
|
||||||
|
featurePara := doc.AddParagraph(feature)
|
||||||
|
featurePara.SetStyle(style.StyleListParagraph)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 9. 演示样式信息
|
||||||
|
fmt.Println("📋 显示样式信息...")
|
||||||
|
quickAPI := style.NewQuickStyleAPI(styleManager)
|
||||||
|
allStyles := quickAPI.GetAllStylesInfo()
|
||||||
|
|
||||||
|
stylesInfo := doc.AddParagraph(fmt.Sprintf("本文档使用了%d种预定义样式。", len(allStyles)))
|
||||||
|
stylesInfo.SetStyle(style.StyleNormal)
|
||||||
|
|
||||||
|
// 确保输出目录存在
|
||||||
|
outputFile := "../output/basic_example.docx"
|
||||||
|
outputDir := filepath.Dir(outputFile)
|
||||||
|
|
||||||
|
fmt.Printf("📁 检查输出目录: %s\n", outputDir)
|
||||||
|
if err := os.MkdirAll(outputDir, 0755); err != nil {
|
||||||
|
log.Printf("创建输出目录失败: %v", err)
|
||||||
|
// 尝试当前目录
|
||||||
|
outputFile = "basic_example.docx"
|
||||||
|
fmt.Printf("📁 改为保存到当前目录: %s\n", outputFile)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Printf("📁 保存文档到: %s\n", outputFile)
|
||||||
|
|
||||||
|
err := doc.Save(outputFile)
|
||||||
|
if err != nil {
|
||||||
|
log.Printf("保存文档失败: %v", err)
|
||||||
|
fmt.Printf("❌ 文档保存失败，但演示程序已成功运行！\n")
|
||||||
|
fmt.Printf("🔍 错误信息: %v\n", err)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Println("✅ 基础示例文档创建完成！")
|
||||||
|
fmt.Printf("🎉 您可以在 %s 查看生成的文档\n", outputFile)
|
||||||
|
}
|
||||||
375
examples/style_demo/style_demo.go
Normal file
375
examples/style_demo/style_demo.go
Normal file
@@ -0,0 +1,375 @@
|
|||||||
|
// Package main 展示WordZero完整样式系统的使用示例
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"log"
|
||||||
|
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/document"
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/style"
|
||||||
|
)
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
// 创建新文档
|
||||||
|
doc := document.New()
|
||||||
|
|
||||||
|
// 获取样式管理器并创建快速API
|
||||||
|
styleManager := doc.GetStyleManager()
|
||||||
|
quickAPI := style.NewQuickStyleAPI(styleManager)
|
||||||
|
|
||||||
|
fmt.Println("WordZero 完整样式系统演示")
|
||||||
|
fmt.Println("==========================")
|
||||||
|
|
||||||
|
// 1. 展示所有预定义样式
|
||||||
|
demonstratePredefinedStyles(quickAPI)
|
||||||
|
|
||||||
|
// 2. 演示样式继承机制
|
||||||
|
demonstrateStyleInheritance(styleManager)
|
||||||
|
|
||||||
|
// 3. 创建和使用自定义样式
|
||||||
|
demonstrateCustomStyles(quickAPI)
|
||||||
|
|
||||||
|
// 4. 创建样式化文档内容
|
||||||
|
createStyledDocument(doc, styleManager, quickAPI)
|
||||||
|
|
||||||
|
// 5. 演示样式查询和管理功能
|
||||||
|
demonstrateStyleManagement(quickAPI)
|
||||||
|
|
||||||
|
// 保存文档
|
||||||
|
outputFile := "../output/styled_document_demo.docx"
|
||||||
|
err := doc.Save(outputFile)
|
||||||
|
if err != nil {
|
||||||
|
log.Fatalf("保存文档失败: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Printf("\n✅ 样式化文档已保存到: %s\n", outputFile)
|
||||||
|
fmt.Println("\n🎉 样式系统演示完成！")
|
||||||
|
}
|
||||||
|
|
||||||
|
// demonstratePredefinedStyles 展示预定义样式系统
|
||||||
|
func demonstratePredefinedStyles(api *style.QuickStyleAPI) {
|
||||||
|
fmt.Println("\n📋 1. 预定义样式系统展示")
|
||||||
|
fmt.Println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
|
||||||
|
|
||||||
|
// 显示所有样式信息
|
||||||
|
allStyles := api.GetAllStylesInfo()
|
||||||
|
fmt.Printf("总共有 %d 个预定义样式\n\n", len(allStyles))
|
||||||
|
|
||||||
|
// 按类型显示样式
|
||||||
|
fmt.Println("🏷️ 段落样式:")
|
||||||
|
paragraphStyles := api.GetParagraphStylesInfo()
|
||||||
|
for _, info := range paragraphStyles {
|
||||||
|
fmt.Printf(" %-15s | %-12s | %s\n", info.ID, info.Name, info.Description)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Println("\n🔤 字符样式:")
|
||||||
|
characterStyles := api.GetCharacterStylesInfo()
|
||||||
|
for _, info := range characterStyles {
|
||||||
|
fmt.Printf(" %-15s | %-12s | %s\n", info.ID, info.Name, info.Description)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Println("\n📊 标题样式系列:")
|
||||||
|
headingStyles := api.GetHeadingStylesInfo()
|
||||||
|
for _, info := range headingStyles {
|
||||||
|
basedOn := ""
|
||||||
|
if info.BasedOn != "" {
|
||||||
|
basedOn = fmt.Sprintf(" (基于: %s)", info.BasedOn)
|
||||||
|
}
|
||||||
|
fmt.Printf(" %-10s | %s%s\n", info.ID, info.Name, basedOn)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// demonstrateStyleInheritance 演示样式继承机制
|
||||||
|
func demonstrateStyleInheritance(sm *style.StyleManager) {
|
||||||
|
fmt.Println("\n🔗 2. 样式继承机制演示")
|
||||||
|
fmt.Println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
|
||||||
|
|
||||||
|
// 演示标题样式的继承
|
||||||
|
heading2Style := sm.GetStyleWithInheritance(style.StyleHeading2)
|
||||||
|
if heading2Style != nil {
|
||||||
|
fmt.Println("标题2样式继承分析:")
|
||||||
|
|
||||||
|
if heading2Style.BasedOn != nil {
|
||||||
|
fmt.Printf(" 📍 基于样式: %s\n", heading2Style.BasedOn.Val)
|
||||||
|
|
||||||
|
// 获取基础样式
|
||||||
|
baseStyle := sm.GetStyle(heading2Style.BasedOn.Val)
|
||||||
|
if baseStyle != nil {
|
||||||
|
fmt.Println(" 📋 继承的属性:")
|
||||||
|
if baseStyle.RunPr != nil && baseStyle.RunPr.FontFamily != nil {
|
||||||
|
fmt.Printf(" 字体系列: %s (从 %s 继承)\n",
|
||||||
|
baseStyle.RunPr.FontFamily.ASCII, heading2Style.BasedOn.Val)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if heading2Style.RunPr != nil {
|
||||||
|
fmt.Println(" 🎨 自有属性:")
|
||||||
|
if heading2Style.RunPr.Bold != nil {
|
||||||
|
fmt.Println(" 加粗: 是")
|
||||||
|
}
|
||||||
|
if heading2Style.RunPr.FontSize != nil {
|
||||||
|
fmt.Printf(" 字体大小: %s (半磅单位)\n", heading2Style.RunPr.FontSize.Val)
|
||||||
|
}
|
||||||
|
if heading2Style.RunPr.Color != nil {
|
||||||
|
fmt.Printf(" 颜色: #%s\n", heading2Style.RunPr.Color.Val)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 演示XML转换
|
||||||
|
fmt.Println("\n 🔄 样式XML转换:")
|
||||||
|
xmlData, err := sm.ApplyStyleToXML(style.StyleHeading2)
|
||||||
|
if err == nil {
|
||||||
|
fmt.Printf(" 样式ID: %v\n", xmlData["styleId"])
|
||||||
|
fmt.Printf(" 类型: %v\n", xmlData["type"])
|
||||||
|
if runProps, ok := xmlData["runProperties"]; ok {
|
||||||
|
fmt.Printf(" 字符属性: %+v\n", runProps)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// demonstrateCustomStyles 演示自定义样式创建
|
||||||
|
func demonstrateCustomStyles(api *style.QuickStyleAPI) {
|
||||||
|
fmt.Println("\n🎨 3. 自定义样式创建演示")
|
||||||
|
fmt.Println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
|
||||||
|
|
||||||
|
// 创建自定义标题样式
|
||||||
|
titleConfig := style.QuickStyleConfig{
|
||||||
|
ID: "CustomDocTitle",
|
||||||
|
Name: "自定义文档标题",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: style.StyleTitle,
|
||||||
|
ParagraphConfig: &style.QuickParagraphConfig{
|
||||||
|
Alignment: "center",
|
||||||
|
LineSpacing: 1.2,
|
||||||
|
SpaceBefore: 24,
|
||||||
|
SpaceAfter: 12,
|
||||||
|
},
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontName: "微软雅黑",
|
||||||
|
FontSize: 20,
|
||||||
|
FontColor: "2E8B57",
|
||||||
|
Bold: true,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
customTitle, err := api.CreateQuickStyle(titleConfig)
|
||||||
|
if err != nil {
|
||||||
|
log.Printf("创建自定义标题样式失败: %v", err)
|
||||||
|
} else {
|
||||||
|
fmt.Printf("✅ 创建自定义标题样式: %s\n", customTitle.Name.Val)
|
||||||
|
fmt.Printf(" ID: %s, 基于: %s\n", customTitle.StyleID, customTitle.BasedOn.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建自定义高亮样式
|
||||||
|
highlightConfig := style.QuickStyleConfig{
|
||||||
|
ID: "ImportantHighlight",
|
||||||
|
Name: "重要高亮",
|
||||||
|
Type: style.StyleTypeCharacter,
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontColor: "FF0000",
|
||||||
|
Bold: true,
|
||||||
|
Highlight: "yellow",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
customHighlight, err := api.CreateQuickStyle(highlightConfig)
|
||||||
|
if err != nil {
|
||||||
|
log.Printf("创建高亮样式失败: %v", err)
|
||||||
|
} else {
|
||||||
|
fmt.Printf("✅ 创建字符高亮样式: %s\n", customHighlight.Name.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建自定义代码段落样式
|
||||||
|
codeBlockConfig := style.QuickStyleConfig{
|
||||||
|
ID: "CustomCodeBlock",
|
||||||
|
Name: "自定义代码块",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: style.StyleCodeBlock,
|
||||||
|
ParagraphConfig: &style.QuickParagraphConfig{
|
||||||
|
Alignment: "left",
|
||||||
|
LineSpacing: 1.0,
|
||||||
|
SpaceBefore: 6,
|
||||||
|
SpaceAfter: 6,
|
||||||
|
LeftIndent: 20,
|
||||||
|
},
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontName: "JetBrains Mono",
|
||||||
|
FontSize: 9,
|
||||||
|
FontColor: "000080",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
customCodeBlock, err := api.CreateQuickStyle(codeBlockConfig)
|
||||||
|
if err != nil {
|
||||||
|
log.Printf("创建代码块样式失败: %v", err)
|
||||||
|
} else {
|
||||||
|
fmt.Printf("✅ 创建自定义代码块样式: %s\n", customCodeBlock.Name.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Printf("\n📊 当前样式总数: %d 个\n", len(api.GetAllStylesInfo()))
|
||||||
|
}
|
||||||
|
|
||||||
|
// createStyledDocument 创建样式化文档
|
||||||
|
func createStyledDocument(doc *document.Document, sm *style.StyleManager, api *style.QuickStyleAPI) {
|
||||||
|
fmt.Println("\n📝 4. 创建样式化文档")
|
||||||
|
fmt.Println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
|
||||||
|
|
||||||
|
// 使用自定义文档标题
|
||||||
|
fmt.Println(" 📋 添加自定义文档标题")
|
||||||
|
titlePara := doc.AddParagraph("WordZero 样式系统完整指南")
|
||||||
|
titlePara.SetStyle("CustomDocTitle")
|
||||||
|
|
||||||
|
// 使用副标题样式
|
||||||
|
fmt.Println(" 📋 添加副标题")
|
||||||
|
subtitlePara := doc.AddParagraph("全面展示预定义样式、自定义样式和样式继承")
|
||||||
|
subtitlePara.SetStyle(style.StyleSubtitle)
|
||||||
|
|
||||||
|
// 使用各级标题
|
||||||
|
fmt.Println(" 📋 添加多级标题结构")
|
||||||
|
h1Para := doc.AddParagraph("第一章：样式系统概述")
|
||||||
|
h1Para.SetStyle(style.StyleHeading1)
|
||||||
|
|
||||||
|
h2Para := doc.AddParagraph("1.1 预定义样式")
|
||||||
|
h2Para.SetStyle(style.StyleHeading2)
|
||||||
|
|
||||||
|
h3Para := doc.AddParagraph("1.1.1 标题样式系列")
|
||||||
|
h3Para.SetStyle(style.StyleHeading3)
|
||||||
|
|
||||||
|
h4Para := doc.AddParagraph("Heading4 示例")
|
||||||
|
h4Para.SetStyle(style.StyleHeading4)
|
||||||
|
|
||||||
|
h5Para := doc.AddParagraph("Heading5 示例")
|
||||||
|
h5Para.SetStyle(style.StyleHeading5)
|
||||||
|
|
||||||
|
// 添加普通内容
|
||||||
|
fmt.Println(" 📋 添加正文内容")
|
||||||
|
normalText := "WordZero 提供了完整的样式管理系统，支持18种预定义样式，包括9个标题层级、文档标题样式、引用样式、代码样式等。这些样式遵循Microsoft Word的OOXML规范，确保生成的文档具有专业的外观。"
|
||||||
|
normalPara := doc.AddParagraph(normalText)
|
||||||
|
normalPara.SetStyle(style.StyleNormal)
|
||||||
|
|
||||||
|
// 使用引用样式
|
||||||
|
fmt.Println(" 📋 添加引用段落")
|
||||||
|
quoteText := "样式是文档格式化的灵魂。通过合理使用样式，我们不仅能确保文档外观的一致性，还能提高文档的可维护性和专业性。—— WordZero设计理念"
|
||||||
|
quotePara := doc.AddParagraph(quoteText)
|
||||||
|
quotePara.SetStyle(style.StyleQuote)
|
||||||
|
|
||||||
|
// 添加列表段落
|
||||||
|
fmt.Println(" 📋 添加列表内容")
|
||||||
|
listTitle := doc.AddParagraph("样式系统的核心特性：")
|
||||||
|
listTitle.SetStyle(style.StyleNormal)
|
||||||
|
|
||||||
|
listItems := []string{
|
||||||
|
"• 18种预定义样式，覆盖常用文档需求",
|
||||||
|
"• 完整的样式继承机制，支持属性合并",
|
||||||
|
"• 灵活的自定义样式创建接口",
|
||||||
|
"• 类型安全的API设计",
|
||||||
|
"• 符合OOXML规范的XML结构",
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, item := range listItems {
|
||||||
|
listPara := doc.AddParagraph(item)
|
||||||
|
listPara.SetStyle(style.StyleListParagraph)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 使用代码块样式
|
||||||
|
fmt.Println(" 📋 添加代码示例")
|
||||||
|
codeTitle := doc.AddParagraph("代码示例：创建自定义样式")
|
||||||
|
codeTitle.SetStyle(style.StyleHeading3)
|
||||||
|
|
||||||
|
codeContent := `// 创建自定义样式
|
||||||
|
config := style.QuickStyleConfig{
|
||||||
|
ID: "MyStyle",
|
||||||
|
Name: "我的样式",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: "Normal",
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontName: "微软雅黑",
|
||||||
|
FontSize: 12,
|
||||||
|
Bold: true,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
style, err := quickAPI.CreateQuickStyle(config)`
|
||||||
|
|
||||||
|
// 使用自定义代码块样式
|
||||||
|
codePara := doc.AddParagraph(codeContent)
|
||||||
|
codePara.SetStyle("CustomCodeBlock")
|
||||||
|
|
||||||
|
// 演示混合格式段落
|
||||||
|
fmt.Println(" 📋 添加混合格式段落")
|
||||||
|
mixedPara := doc.AddParagraph("")
|
||||||
|
|
||||||
|
mixedPara.AddFormattedText("本段落演示了多种字符样式的组合使用：", nil)
|
||||||
|
mixedPara.AddFormattedText("普通文本，", nil)
|
||||||
|
mixedPara.AddFormattedText("粗体文本", &document.TextFormat{Bold: true})
|
||||||
|
mixedPara.AddFormattedText("，", nil)
|
||||||
|
mixedPara.AddFormattedText("斜体文本", &document.TextFormat{Italic: true})
|
||||||
|
mixedPara.AddFormattedText("，", nil)
|
||||||
|
mixedPara.AddFormattedText("代码文本", &document.TextFormat{
|
||||||
|
FontName: "Consolas", FontColor: "E7484F", FontSize: 10})
|
||||||
|
mixedPara.AddFormattedText("，以及", nil)
|
||||||
|
mixedPara.AddFormattedText("重要高亮文本", &document.TextFormat{
|
||||||
|
Bold: true, FontColor: "FF0000"})
|
||||||
|
mixedPara.AddFormattedText("。", nil)
|
||||||
|
|
||||||
|
// 总结段落
|
||||||
|
fmt.Println(" 📋 添加总结")
|
||||||
|
summaryTitle := doc.AddParagraph("第二章：使用建议")
|
||||||
|
summaryTitle.SetStyle(style.StyleHeading1)
|
||||||
|
|
||||||
|
summaryText := "通过WordZero的样式系统，您可以轻松创建专业、美观、结构清晰的Word文档。建议在文档创建初期就规划好样式体系，这样能够大大提高文档制作效率。"
|
||||||
|
summaryPara := doc.AddParagraph(summaryText)
|
||||||
|
summaryPara.SetStyle(style.StyleNormal)
|
||||||
|
|
||||||
|
fmt.Println(" ✅ 文档内容创建完成")
|
||||||
|
}
|
||||||
|
|
||||||
|
// demonstrateStyleManagement 演示样式查询和管理功能
|
||||||
|
func demonstrateStyleManagement(api *style.QuickStyleAPI) {
|
||||||
|
fmt.Println("\n🔍 5. 样式管理功能演示")
|
||||||
|
fmt.Println("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━")
|
||||||
|
|
||||||
|
// 样式信息查询
|
||||||
|
fmt.Println("📊 样式统计信息:")
|
||||||
|
allStyles := api.GetAllStylesInfo()
|
||||||
|
paragraphCount := len(api.GetParagraphStylesInfo())
|
||||||
|
characterCount := len(api.GetCharacterStylesInfo())
|
||||||
|
headingCount := len(api.GetHeadingStylesInfo())
|
||||||
|
|
||||||
|
fmt.Printf(" 总样式数: %d\n", len(allStyles))
|
||||||
|
fmt.Printf(" 段落样式: %d 个\n", paragraphCount)
|
||||||
|
fmt.Printf(" 字符样式: %d 个\n", characterCount)
|
||||||
|
fmt.Printf(" 标题样式: %d 个\n", headingCount)
|
||||||
|
|
||||||
|
// 样式详情查询
|
||||||
|
fmt.Println("\n🔍 样式详情查询示例:")
|
||||||
|
styles := []string{style.StyleHeading1, style.StyleQuote, "CustomDocTitle"}
|
||||||
|
for _, styleID := range styles {
|
||||||
|
info, err := api.GetStyleInfo(styleID)
|
||||||
|
if err == nil {
|
||||||
|
fmt.Printf(" %s:\n", styleID)
|
||||||
|
fmt.Printf(" 名称: %s\n", info.Name)
|
||||||
|
fmt.Printf(" 类型: %s\n", info.Type)
|
||||||
|
fmt.Printf(" 内置: %v\n", info.IsBuiltIn)
|
||||||
|
if info.BasedOn != "" {
|
||||||
|
fmt.Printf(" 基于: %s\n", info.BasedOn)
|
||||||
|
}
|
||||||
|
fmt.Printf(" 描述: %s\n", info.Description)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 自定义样式列表
|
||||||
|
fmt.Println("\n🎨 自定义样式列表:")
|
||||||
|
customCount := 0
|
||||||
|
for _, info := range allStyles {
|
||||||
|
if !info.IsBuiltIn {
|
||||||
|
fmt.Printf(" - %s (%s)\n", info.Name, info.ID)
|
||||||
|
customCount++
|
||||||
|
}
|
||||||
|
}
|
||||||
|
fmt.Printf(" 共 %d 个自定义样式\n", customCount)
|
||||||
|
|
||||||
|
fmt.Println("\n✨ 样式管理演示完成！")
|
||||||
|
}
|
||||||
151
main.go
151
main.go
@@ -1,151 +0,0 @@
|
|||||||
package main
|
|
||||||
|
|
||||||
import (
|
|
||||||
"flag"
|
|
||||||
"fmt"
|
|
||||||
"log"
|
|
||||||
"os"
|
|
||||||
|
|
||||||
"github.com/ZeroHawkeye/wordZero/pkg/document"
|
|
||||||
)
|
|
||||||
|
|
||||||
func main() {
|
|
||||||
// 定义命令行参数
|
|
||||||
action := flag.String("action", "demo", "要执行的操作: demo, create, open")
|
|
||||||
file := flag.String("file", "output.docx", "文档文件路径")
|
|
||||||
text := flag.String("text", "Hello, World!", "要添加的文本")
|
|
||||||
debug := flag.Bool("debug", false, "启用调试模式")
|
|
||||||
flag.Parse()
|
|
||||||
|
|
||||||
// 设置日志级别
|
|
||||||
if *debug {
|
|
||||||
document.SetGlobalLevel(document.LogLevelDebug)
|
|
||||||
} else {
|
|
||||||
document.SetGlobalLevel(document.LogLevelInfo)
|
|
||||||
}
|
|
||||||
|
|
||||||
switch *action {
|
|
||||||
case "demo":
|
|
||||||
createDemoDocument()
|
|
||||||
case "create":
|
|
||||||
createSimpleDocument(*file, *text)
|
|
||||||
case "open":
|
|
||||||
openAndReadDocument(*file)
|
|
||||||
default:
|
|
||||||
fmt.Printf("未知操作: %s\n", *action)
|
|
||||||
flag.Usage()
|
|
||||||
os.Exit(1)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// createDemoDocument 创建一个演示文档，展示所有格式化功能
|
|
||||||
func createDemoDocument() {
|
|
||||||
fmt.Println("创建演示文档...")
|
|
||||||
|
|
||||||
doc := document.New()
|
|
||||||
|
|
||||||
// 1. 添加标题
|
|
||||||
titleFormat := &document.TextFormat{
|
|
||||||
Bold: true,
|
|
||||||
FontSize: 20,
|
|
||||||
FontColor: "FF0000", // 红色
|
|
||||||
FontName: "微软雅黑",
|
|
||||||
}
|
|
||||||
title := doc.AddFormattedParagraph("WordZero 功能演示", titleFormat)
|
|
||||||
title.SetAlignment(document.AlignCenter)
|
|
||||||
|
|
||||||
// 2. 添加副标题
|
|
||||||
subtitleFormat := &document.TextFormat{
|
|
||||||
Bold: true,
|
|
||||||
FontSize: 16,
|
|
||||||
FontName: "微软雅黑",
|
|
||||||
}
|
|
||||||
subtitle := doc.AddFormattedParagraph("文本格式化示例", subtitleFormat)
|
|
||||||
subtitle.SetAlignment(document.AlignCenter)
|
|
||||||
subtitle.SetSpacing(&document.SpacingConfig{
|
|
||||||
BeforePara: 12,
|
|
||||||
AfterPara: 6,
|
|
||||||
})
|
|
||||||
|
|
||||||
// 3. 添加正文段落
|
|
||||||
doc.AddParagraph("WordZero 是一个使用 Golang 实现的 Word 文档操作库，提供丰富的文档创建和编辑功能。")
|
|
||||||
|
|
||||||
// 4. 添加带间距的段落
|
|
||||||
para := doc.AddParagraph("这个段落演示了间距和缩进设置：首行缩进、1.5倍行距、段前段后间距。")
|
|
||||||
para.SetSpacing(&document.SpacingConfig{
|
|
||||||
LineSpacing: 1.5,
|
|
||||||
BeforePara: 12,
|
|
||||||
AfterPara: 6,
|
|
||||||
FirstLineIndent: 24,
|
|
||||||
})
|
|
||||||
para.SetAlignment(document.AlignJustify)
|
|
||||||
|
|
||||||
// 5. 添加混合格式段落
|
|
||||||
mixed := doc.AddParagraph("格式化文本示例：")
|
|
||||||
mixed.AddFormattedText("粗体红色", &document.TextFormat{
|
|
||||||
Bold: true, FontColor: "FF0000"})
|
|
||||||
mixed.AddFormattedText("、", nil)
|
|
||||||
mixed.AddFormattedText("斜体蓝色", &document.TextFormat{
|
|
||||||
Italic: true, FontColor: "0000FF"})
|
|
||||||
mixed.AddFormattedText("、", nil)
|
|
||||||
mixed.AddFormattedText("大号绿色", &document.TextFormat{
|
|
||||||
FontSize: 16, FontColor: "00AA00"})
|
|
||||||
mixed.AddFormattedText("。", nil)
|
|
||||||
|
|
||||||
// 6. 添加不同对齐方式的段落
|
|
||||||
left := doc.AddParagraph("左对齐文本")
|
|
||||||
left.SetAlignment(document.AlignLeft)
|
|
||||||
|
|
||||||
center := doc.AddParagraph("居中对齐文本")
|
|
||||||
center.SetAlignment(document.AlignCenter)
|
|
||||||
|
|
||||||
right := doc.AddParagraph("右对齐文本")
|
|
||||||
right.SetAlignment(document.AlignRight)
|
|
||||||
|
|
||||||
justify := doc.AddParagraph("两端对齐文本，当文本较长时效果更明显。这是一个较长的段落，用来演示两端对齐的效果。")
|
|
||||||
justify.SetAlignment(document.AlignJustify)
|
|
||||||
|
|
||||||
// 保存文档
|
|
||||||
filename := "demo_document.docx"
|
|
||||||
err := doc.Save(filename)
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("保存文档失败: %v", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
fmt.Printf("演示文档已创建: %s\n", filename)
|
|
||||||
}
|
|
||||||
|
|
||||||
// createSimpleDocument 创建简单文档
|
|
||||||
func createSimpleDocument(filename, text string) {
|
|
||||||
fmt.Printf("创建文档: %s\n", filename)
|
|
||||||
|
|
||||||
doc := document.New()
|
|
||||||
doc.AddParagraph(text)
|
|
||||||
|
|
||||||
err := doc.Save(filename)
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("保存文档失败: %v", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
fmt.Printf("文档已保存: %s\n", filename)
|
|
||||||
}
|
|
||||||
|
|
||||||
// openAndReadDocument 打开并读取文档
|
|
||||||
func openAndReadDocument(filename string) {
|
|
||||||
fmt.Printf("打开文档: %s\n", filename)
|
|
||||||
|
|
||||||
doc, err := document.Open(filename)
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("打开文档失败: %v", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
fmt.Printf("文档包含 %d 个段落\n", len(doc.Body.Paragraphs))
|
|
||||||
|
|
||||||
for i, para := range doc.Body.Paragraphs {
|
|
||||||
fmt.Printf("段落 %d: ", i+1)
|
|
||||||
for _, run := range para.Runs {
|
|
||||||
fmt.Print(run.Text.Content)
|
|
||||||
}
|
|
||||||
fmt.Println()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -5,11 +5,14 @@ import (
|
|||||||
"archive/zip"
|
"archive/zip"
|
||||||
"bytes"
|
"bytes"
|
||||||
"encoding/xml"
|
"encoding/xml"
|
||||||
|
"fmt"
|
||||||
"io"
|
"io"
|
||||||
"os"
|
"os"
|
||||||
"path/filepath"
|
"path/filepath"
|
||||||
"strconv"
|
"strconv"
|
||||||
"strings"
|
"strings"
|
||||||
|
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/style"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Document 表示一个Word文档
|
// Document 表示一个Word文档
|
||||||
@@ -20,6 +23,8 @@ type Document struct {
|
|||||||
relationships *Relationships
|
relationships *Relationships
|
||||||
// 内容类型
|
// 内容类型
|
||||||
contentTypes *ContentTypes
|
contentTypes *ContentTypes
|
||||||
|
// 样式管理器
|
||||||
|
styleManager *style.StyleManager
|
||||||
// 临时存储文档部件
|
// 临时存储文档部件
|
||||||
parts map[string][]byte
|
parts map[string][]byte
|
||||||
}
|
}
|
||||||
@@ -39,10 +44,11 @@ type Paragraph struct {
|
|||||||
|
|
||||||
// ParagraphProperties 段落属性
|
// ParagraphProperties 段落属性
|
||||||
type ParagraphProperties struct {
|
type ParagraphProperties struct {
|
||||||
XMLName xml.Name `xml:"w:pPr"`
|
XMLName xml.Name `xml:"w:pPr"`
|
||||||
Spacing *Spacing `xml:"w:spacing,omitempty"`
|
ParagraphStyle *ParagraphStyle `xml:"w:pStyle,omitempty"`
|
||||||
Justification *Justification `xml:"w:jc,omitempty"`
|
Spacing *Spacing `xml:"w:spacing,omitempty"`
|
||||||
Indentation *Indentation `xml:"w:ind,omitempty"`
|
Justification *Justification `xml:"w:jc,omitempty"`
|
||||||
|
Indentation *Indentation `xml:"w:ind,omitempty"`
|
||||||
}
|
}
|
||||||
|
|
||||||
// Spacing 间距设置
|
// Spacing 间距设置
|
||||||
@@ -184,31 +190,25 @@ type Indentation struct {
|
|||||||
Right string `xml:"w:right,attr,omitempty"`
|
Right string `xml:"w:right,attr,omitempty"`
|
||||||
}
|
}
|
||||||
|
|
||||||
// New 创建一个新的Word文档。
|
// ParagraphStyle 段落样式引用
|
||||||
//
|
type ParagraphStyle struct {
|
||||||
// 返回的文档包含基本的OOXML结构，可以直接添加内容。
|
XMLName xml.Name `xml:"w:pStyle"`
|
||||||
// 文档会自动初始化必要的关系和内容类型。
|
Val string `xml:"w:val,attr"`
|
||||||
//
|
}
|
||||||
// 示例:
|
|
||||||
//
|
// New 创建一个新的空文档
|
||||||
// doc := document.New()
|
|
||||||
// doc.AddParagraph("Hello, World!")
|
|
||||||
// err := doc.Save("hello.docx")
|
|
||||||
// if err != nil {
|
|
||||||
// log.Fatal(err)
|
|
||||||
// }
|
|
||||||
func New() *Document {
|
func New() *Document {
|
||||||
Infof("创建新文档")
|
Debugf("创建新文档")
|
||||||
|
|
||||||
doc := &Document{
|
doc := &Document{
|
||||||
Body: &Body{
|
Body: &Body{
|
||||||
Paragraphs: []Paragraph{},
|
Paragraphs: make([]Paragraph, 0),
|
||||||
},
|
},
|
||||||
parts: make(map[string][]byte),
|
styleManager: style.NewStyleManager(),
|
||||||
|
parts: make(map[string][]byte),
|
||||||
}
|
}
|
||||||
|
|
||||||
// 初始化基础结构
|
|
||||||
doc.initializeStructure()
|
doc.initializeStructure()
|
||||||
|
|
||||||
return doc
|
return doc
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -327,6 +327,21 @@ func (d *Document) Save(filename string) error {
|
|||||||
return WrapError("serialize_document", err)
|
return WrapError("serialize_document", err)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 序列化样式
|
||||||
|
if err := d.serializeStyles(); err != nil {
|
||||||
|
Errorf("序列化样式失败")
|
||||||
|
return WrapError("serialize_styles", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 序列化内容类型
|
||||||
|
d.serializeContentTypes()
|
||||||
|
|
||||||
|
// 序列化关系
|
||||||
|
d.serializeRelationships()
|
||||||
|
|
||||||
|
// 序列化文档关系
|
||||||
|
d.serializeDocumentRelationships()
|
||||||
|
|
||||||
// 写入所有部件
|
// 写入所有部件
|
||||||
for name, data := range d.parts {
|
for name, data := range d.parts {
|
||||||
writer, err := zipWriter.Create(name)
|
writer, err := zipWriter.Create(name)
|
||||||
@@ -609,6 +624,139 @@ func (p *Paragraph) AddFormattedText(text string, format *TextFormat) {
|
|||||||
Debugf("向段落添加格式化文本: %s", text)
|
Debugf("向段落添加格式化文本: %s", text)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// AddHeadingParagraph 向文档添加一个标题段落。
|
||||||
|
//
|
||||||
|
// 参数 text 是标题的文本内容。
|
||||||
|
// 参数 level 是标题级别（1-9），对应 Heading1 到 Heading9。
|
||||||
|
//
|
||||||
|
// 返回新创建段落的指针，可用于进一步设置段落属性。
|
||||||
|
// 此方法会自动设置正确的样式引用，确保标题能被 Word 导航窗格识别。
|
||||||
|
//
|
||||||
|
// 示例:
|
||||||
|
//
|
||||||
|
// doc := document.New()
|
||||||
|
//
|
||||||
|
// // 添加一级标题
|
||||||
|
// h1 := doc.AddHeadingParagraph("第一章：概述", 1)
|
||||||
|
//
|
||||||
|
// // 添加二级标题
|
||||||
|
// h2 := doc.AddHeadingParagraph("1.1 背景", 2)
|
||||||
|
//
|
||||||
|
// // 添加三级标题
|
||||||
|
// h3 := doc.AddHeadingParagraph("1.1.1 研究目标", 3)
|
||||||
|
func (d *Document) AddHeadingParagraph(text string, level int) *Paragraph {
|
||||||
|
if level < 1 || level > 9 {
|
||||||
|
Debugf("标题级别 %d 超出范围，使用默认级别 1", level)
|
||||||
|
level = 1
|
||||||
|
}
|
||||||
|
|
||||||
|
styleID := fmt.Sprintf("Heading%d", level)
|
||||||
|
Debugf("添加标题段落: %s (级别: %d, 样式: %s)", text, level, styleID)
|
||||||
|
|
||||||
|
// 获取样式管理器中的样式
|
||||||
|
headingStyle := d.styleManager.GetStyle(styleID)
|
||||||
|
if headingStyle == nil {
|
||||||
|
Debugf("警告：找不到样式 %s，使用默认样式", styleID)
|
||||||
|
return d.AddParagraph(text)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建运行属性，应用样式中的字符格式
|
||||||
|
runProps := &RunProperties{}
|
||||||
|
if headingStyle.RunPr != nil {
|
||||||
|
if headingStyle.RunPr.Bold != nil {
|
||||||
|
runProps.Bold = &Bold{}
|
||||||
|
}
|
||||||
|
if headingStyle.RunPr.Italic != nil {
|
||||||
|
runProps.Italic = &Italic{}
|
||||||
|
}
|
||||||
|
if headingStyle.RunPr.FontSize != nil {
|
||||||
|
runProps.FontSize = &FontSize{Val: headingStyle.RunPr.FontSize.Val}
|
||||||
|
}
|
||||||
|
if headingStyle.RunPr.Color != nil {
|
||||||
|
runProps.Color = &Color{Val: headingStyle.RunPr.Color.Val}
|
||||||
|
}
|
||||||
|
if headingStyle.RunPr.FontFamily != nil {
|
||||||
|
runProps.FontFamily = &FontFamily{ASCII: headingStyle.RunPr.FontFamily.ASCII}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建段落属性，应用样式中的段落格式
|
||||||
|
paraProps := &ParagraphProperties{
|
||||||
|
ParagraphStyle: &ParagraphStyle{Val: styleID},
|
||||||
|
}
|
||||||
|
|
||||||
|
// 应用样式中的段落格式
|
||||||
|
if headingStyle.ParagraphPr != nil {
|
||||||
|
if headingStyle.ParagraphPr.Spacing != nil {
|
||||||
|
paraProps.Spacing = &Spacing{
|
||||||
|
Before: headingStyle.ParagraphPr.Spacing.Before,
|
||||||
|
After: headingStyle.ParagraphPr.Spacing.After,
|
||||||
|
Line: headingStyle.ParagraphPr.Spacing.Line,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if headingStyle.ParagraphPr.Justification != nil {
|
||||||
|
paraProps.Justification = &Justification{
|
||||||
|
Val: headingStyle.ParagraphPr.Justification.Val,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if headingStyle.ParagraphPr.Indentation != nil {
|
||||||
|
paraProps.Indentation = &Indentation{
|
||||||
|
FirstLine: headingStyle.ParagraphPr.Indentation.FirstLine,
|
||||||
|
Left: headingStyle.ParagraphPr.Indentation.Left,
|
||||||
|
Right: headingStyle.ParagraphPr.Indentation.Right,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建段落
|
||||||
|
p := Paragraph{
|
||||||
|
Properties: paraProps,
|
||||||
|
Runs: []Run{
|
||||||
|
{
|
||||||
|
Properties: runProps,
|
||||||
|
Text: Text{
|
||||||
|
Content: text,
|
||||||
|
Space: "preserve",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
d.Body.Paragraphs = append(d.Body.Paragraphs, p)
|
||||||
|
return &d.Body.Paragraphs[len(d.Body.Paragraphs)-1]
|
||||||
|
}
|
||||||
|
|
||||||
|
// SetStyle 设置段落的样式。
|
||||||
|
//
|
||||||
|
// 参数 styleID 是要应用的样式ID，如 "Heading1"、"Normal" 等。
|
||||||
|
// 此方法会设置段落的样式引用，确保段落使用指定的样式。
|
||||||
|
//
|
||||||
|
// 示例:
|
||||||
|
//
|
||||||
|
// para := doc.AddParagraph("这是一个段落")
|
||||||
|
// para.SetStyle("Heading2") // 设置为二级标题样式
|
||||||
|
func (p *Paragraph) SetStyle(styleID string) {
|
||||||
|
if p.Properties == nil {
|
||||||
|
p.Properties = &ParagraphProperties{}
|
||||||
|
}
|
||||||
|
|
||||||
|
p.Properties.ParagraphStyle = &ParagraphStyle{Val: styleID}
|
||||||
|
Debugf("设置段落样式: %s", styleID)
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetStyleManager 获取文档的样式管理器。
|
||||||
|
//
|
||||||
|
// 返回文档的样式管理器，可用于访问和管理样式。
|
||||||
|
//
|
||||||
|
// 示例:
|
||||||
|
//
|
||||||
|
// doc := document.New()
|
||||||
|
// styleManager := doc.GetStyleManager()
|
||||||
|
// headingStyle := styleManager.GetStyle("Heading1")
|
||||||
|
func (d *Document) GetStyleManager() *style.StyleManager {
|
||||||
|
return d.styleManager
|
||||||
|
}
|
||||||
|
|
||||||
// initializeStructure 初始化文档基础结构
|
// initializeStructure 初始化文档基础结构
|
||||||
func (d *Document) initializeStructure() {
|
func (d *Document) initializeStructure() {
|
||||||
// 初始化 content types
|
// 初始化 content types
|
||||||
@@ -620,6 +768,7 @@ func (d *Document) initializeStructure() {
|
|||||||
},
|
},
|
||||||
Overrides: []Override{
|
Overrides: []Override{
|
||||||
{PartName: "/word/document.xml", ContentType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"},
|
{PartName: "/word/document.xml", ContentType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"},
|
||||||
|
{PartName: "/word/styles.xml", ContentType: "application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml"},
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -638,6 +787,7 @@ func (d *Document) initializeStructure() {
|
|||||||
// 添加基础部件
|
// 添加基础部件
|
||||||
d.serializeContentTypes()
|
d.serializeContentTypes()
|
||||||
d.serializeRelationships()
|
d.serializeRelationships()
|
||||||
|
d.serializeDocumentRelationships()
|
||||||
}
|
}
|
||||||
|
|
||||||
// parseDocument 解析文档内容
|
// parseDocument 解析文档内容
|
||||||
@@ -843,6 +993,74 @@ func (d *Document) serializeRelationships() {
|
|||||||
d.parts["_rels/.rels"] = append([]byte(xml.Header), data...)
|
d.parts["_rels/.rels"] = append([]byte(xml.Header), data...)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// serializeDocumentRelationships 序列化文档关系
|
||||||
|
func (d *Document) serializeDocumentRelationships() {
|
||||||
|
// 创建文档关系
|
||||||
|
docRels := &Relationships{
|
||||||
|
Xmlns: "http://schemas.openxmlformats.org/package/2006/relationships",
|
||||||
|
Relationships: []Relationship{
|
||||||
|
{
|
||||||
|
ID: "rId1",
|
||||||
|
Type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles",
|
||||||
|
Target: "styles.xml",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
data, _ := xml.MarshalIndent(docRels, "", " ")
|
||||||
|
d.parts["word/_rels/document.xml.rels"] = append([]byte(xml.Header), data...)
|
||||||
|
}
|
||||||
|
|
||||||
|
// serializeStyles 序列化样式
|
||||||
|
func (d *Document) serializeStyles() error {
|
||||||
|
Debugf("开始序列化样式")
|
||||||
|
|
||||||
|
// 创建样式结构，包含完整的命名空间
|
||||||
|
type stylesXML struct {
|
||||||
|
XMLName xml.Name `xml:"w:styles"`
|
||||||
|
XmlnsW string `xml:"xmlns:w,attr"`
|
||||||
|
XmlnsMC string `xml:"xmlns:mc,attr"`
|
||||||
|
XmlnsO string `xml:"xmlns:o,attr"`
|
||||||
|
XmlnsR string `xml:"xmlns:r,attr"`
|
||||||
|
XmlnsM string `xml:"xmlns:m,attr"`
|
||||||
|
XmlnsV string `xml:"xmlns:v,attr"`
|
||||||
|
XmlnsW14 string `xml:"xmlns:w14,attr"`
|
||||||
|
XmlnsW10 string `xml:"xmlns:w10,attr"`
|
||||||
|
XmlnsSL string `xml:"xmlns:sl,attr"`
|
||||||
|
XmlnsWPS string `xml:"xmlns:wpsCustomData,attr"`
|
||||||
|
MCIgnorable string `xml:"mc:Ignorable,attr"`
|
||||||
|
Styles []*style.Style `xml:"w:style"`
|
||||||
|
}
|
||||||
|
|
||||||
|
doc := stylesXML{
|
||||||
|
XmlnsW: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
|
||||||
|
XmlnsMC: "http://schemas.openxmlformats.org/markup-compatibility/2006",
|
||||||
|
XmlnsO: "urn:schemas-microsoft-com:office:office",
|
||||||
|
XmlnsR: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
|
||||||
|
XmlnsM: "http://schemas.openxmlformats.org/officeDocument/2006/math",
|
||||||
|
XmlnsV: "urn:schemas-microsoft-com:vml",
|
||||||
|
XmlnsW14: "http://schemas.microsoft.com/office/word/2010/wordml",
|
||||||
|
XmlnsW10: "urn:schemas-microsoft-com:office:word",
|
||||||
|
XmlnsSL: "http://schemas.openxmlformats.org/schemaLibrary/2006/main",
|
||||||
|
XmlnsWPS: "http://www.wps.cn/officeDocument/2013/wpsCustomData",
|
||||||
|
MCIgnorable: "w14",
|
||||||
|
Styles: d.styleManager.GetAllStyles(),
|
||||||
|
}
|
||||||
|
|
||||||
|
// 序列化为XML
|
||||||
|
data, err := xml.MarshalIndent(doc, "", " ")
|
||||||
|
if err != nil {
|
||||||
|
Errorf("XML序列化失败: %v", err)
|
||||||
|
return WrapError("marshal_xml", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 添加XML声明
|
||||||
|
d.parts["word/styles.xml"] = append([]byte(xml.Header), data...)
|
||||||
|
|
||||||
|
Debugf("样式序列化完成")
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
// ToBytes 将文档转换为字节数组
|
// ToBytes 将文档转换为字节数组
|
||||||
func (d *Document) ToBytes() ([]byte, error) {
|
func (d *Document) ToBytes() ([]byte, error) {
|
||||||
buf := new(bytes.Buffer)
|
buf := new(bytes.Buffer)
|
||||||
@@ -853,6 +1071,20 @@ func (d *Document) ToBytes() ([]byte, error) {
|
|||||||
return nil, err
|
return nil, err
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 序列化样式
|
||||||
|
if err := d.serializeStyles(); err != nil {
|
||||||
|
return nil, err
|
||||||
|
}
|
||||||
|
|
||||||
|
// 序列化内容类型
|
||||||
|
d.serializeContentTypes()
|
||||||
|
|
||||||
|
// 序列化关系
|
||||||
|
d.serializeRelationships()
|
||||||
|
|
||||||
|
// 序列化文档关系
|
||||||
|
d.serializeDocumentRelationships()
|
||||||
|
|
||||||
// 写入所有部件
|
// 写入所有部件
|
||||||
for name, data := range d.parts {
|
for name, data := range d.parts {
|
||||||
writer, err := zipWriter.Create(name)
|
writer, err := zipWriter.Create(name)
|
||||||
|
|||||||
580
pkg/document/document_test.go
Normal file
580
pkg/document/document_test.go
Normal file
@@ -0,0 +1,580 @@
|
|||||||
|
package document
|
||||||
|
|
||||||
|
import (
|
||||||
|
"os"
|
||||||
|
"testing"
|
||||||
|
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/style"
|
||||||
|
)
|
||||||
|
|
||||||
|
// TestNewDocument 测试新文档创建
|
||||||
|
func TestNewDocument(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
// 验证基本结构
|
||||||
|
if doc == nil {
|
||||||
|
t.Fatal("Failed to create new document")
|
||||||
|
}
|
||||||
|
|
||||||
|
if doc.Body == nil {
|
||||||
|
t.Fatal("Document body is nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if doc.styleManager == nil {
|
||||||
|
t.Fatal("Style manager is nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证初始状态
|
||||||
|
if len(doc.Body.Paragraphs) != 0 {
|
||||||
|
t.Errorf("Expected 0 paragraphs, got %d", len(doc.Body.Paragraphs))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证样式管理器初始化
|
||||||
|
styles := doc.styleManager.GetAllStyles()
|
||||||
|
if len(styles) == 0 {
|
||||||
|
t.Error("Style manager should have predefined styles")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestAddParagraph 测试添加普通段落
|
||||||
|
func TestAddParagraph(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
text := "测试段落内容"
|
||||||
|
|
||||||
|
para := doc.AddParagraph(text)
|
||||||
|
|
||||||
|
// 验证段落添加
|
||||||
|
if len(doc.Body.Paragraphs) != 1 {
|
||||||
|
t.Errorf("Expected 1 paragraph, got %d", len(doc.Body.Paragraphs))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证段落内容
|
||||||
|
if len(para.Runs) != 1 {
|
||||||
|
t.Errorf("Expected 1 run, got %d", len(para.Runs))
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Runs[0].Text.Content != text {
|
||||||
|
t.Errorf("Expected %s, got %s", text, para.Runs[0].Text.Content)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证返回的指针是否正确
|
||||||
|
if &doc.Body.Paragraphs[0] != para {
|
||||||
|
t.Error("Returned paragraph pointer is incorrect")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestAddHeadingParagraph 测试添加标题段落
|
||||||
|
func TestAddHeadingParagraph(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
testCases := []struct {
|
||||||
|
text string
|
||||||
|
level int
|
||||||
|
styleID string
|
||||||
|
}{
|
||||||
|
{"第一级标题", 1, "Heading1"},
|
||||||
|
{"第二级标题", 2, "Heading2"},
|
||||||
|
{"第三级标题", 3, "Heading3"},
|
||||||
|
{"第九级标题", 9, "Heading9"},
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, tc := range testCases {
|
||||||
|
para := doc.AddHeadingParagraph(tc.text, tc.level)
|
||||||
|
|
||||||
|
// 验证段落样式设置
|
||||||
|
if para.Properties == nil {
|
||||||
|
t.Errorf("Heading paragraph should have properties")
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.ParagraphStyle == nil {
|
||||||
|
t.Errorf("Heading paragraph should have style reference")
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.ParagraphStyle.Val != tc.styleID {
|
||||||
|
t.Errorf("Expected style %s, got %s", tc.styleID, para.Properties.ParagraphStyle.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证内容
|
||||||
|
if len(para.Runs) != 1 {
|
||||||
|
t.Errorf("Expected 1 run, got %d", len(para.Runs))
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Runs[0].Text.Content != tc.text {
|
||||||
|
t.Errorf("Expected %s, got %s", tc.text, para.Runs[0].Text.Content)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试超出范围的级别
|
||||||
|
para := doc.AddHeadingParagraph("超出范围", 10)
|
||||||
|
if para.Properties.ParagraphStyle.Val != "Heading1" {
|
||||||
|
t.Error("Out of range level should default to Heading1")
|
||||||
|
}
|
||||||
|
|
||||||
|
para = doc.AddHeadingParagraph("负数级别", -1)
|
||||||
|
if para.Properties.ParagraphStyle.Val != "Heading1" {
|
||||||
|
t.Error("Negative level should default to Heading1")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestAddFormattedParagraph 测试添加格式化段落
|
||||||
|
func TestAddFormattedParagraph(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
text := "格式化文本"
|
||||||
|
|
||||||
|
format := &TextFormat{
|
||||||
|
Bold: true,
|
||||||
|
Italic: true,
|
||||||
|
FontSize: 14,
|
||||||
|
FontColor: "FF0000",
|
||||||
|
FontName: "宋体",
|
||||||
|
}
|
||||||
|
|
||||||
|
para := doc.AddFormattedParagraph(text, format)
|
||||||
|
|
||||||
|
// 验证段落添加
|
||||||
|
if len(doc.Body.Paragraphs) != 1 {
|
||||||
|
t.Error("Failed to add formatted paragraph")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证格式设置
|
||||||
|
run := para.Runs[0]
|
||||||
|
if run.Properties == nil {
|
||||||
|
t.Fatal("Run properties should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Properties.Bold == nil {
|
||||||
|
t.Error("Bold property should be set")
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Properties.Italic == nil {
|
||||||
|
t.Error("Italic property should be set")
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Properties.FontSize == nil || run.Properties.FontSize.Val != "28" {
|
||||||
|
t.Errorf("Expected font size 28, got %v", run.Properties.FontSize)
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Properties.Color == nil || run.Properties.Color.Val != "FF0000" {
|
||||||
|
t.Errorf("Expected color FF0000, got %v", run.Properties.Color)
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Properties.FontFamily == nil || run.Properties.FontFamily.ASCII != "宋体" {
|
||||||
|
t.Errorf("Expected font family 宋体, got %v", run.Properties.FontFamily)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestParagraphSetAlignment 测试段落对齐设置
|
||||||
|
func TestParagraphSetAlignment(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
para := doc.AddParagraph("测试对齐")
|
||||||
|
|
||||||
|
testCases := []AlignmentType{
|
||||||
|
AlignLeft,
|
||||||
|
AlignCenter,
|
||||||
|
AlignRight,
|
||||||
|
AlignJustify,
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, alignment := range testCases {
|
||||||
|
para.SetAlignment(alignment)
|
||||||
|
|
||||||
|
if para.Properties == nil {
|
||||||
|
t.Fatal("Properties should not be nil after setting alignment")
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.Justification == nil {
|
||||||
|
t.Fatal("Justification should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.Justification.Val != string(alignment) {
|
||||||
|
t.Errorf("Expected alignment %s, got %s", alignment, para.Properties.Justification.Val)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestParagraphSetSpacing 测试段落间距设置
|
||||||
|
func TestParagraphSetSpacing(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
para := doc.AddParagraph("测试间距")
|
||||||
|
|
||||||
|
config := &SpacingConfig{
|
||||||
|
LineSpacing: 1.5,
|
||||||
|
BeforePara: 12,
|
||||||
|
AfterPara: 6,
|
||||||
|
FirstLineIndent: 24,
|
||||||
|
}
|
||||||
|
|
||||||
|
para.SetSpacing(config)
|
||||||
|
|
||||||
|
// 验证属性设置
|
||||||
|
if para.Properties == nil {
|
||||||
|
t.Fatal("Properties should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.Spacing == nil {
|
||||||
|
t.Fatal("Spacing should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证间距值（转换为TWIPs）
|
||||||
|
spacing := para.Properties.Spacing
|
||||||
|
if spacing.Before != "240" { // 12 * 20
|
||||||
|
t.Errorf("Expected before spacing 240, got %s", spacing.Before)
|
||||||
|
}
|
||||||
|
|
||||||
|
if spacing.After != "120" { // 6 * 20
|
||||||
|
t.Errorf("Expected after spacing 120, got %s", spacing.After)
|
||||||
|
}
|
||||||
|
|
||||||
|
if spacing.Line != "360" { // 1.5 * 240
|
||||||
|
t.Errorf("Expected line spacing 360, got %s", spacing.Line)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证首行缩进
|
||||||
|
if para.Properties.Indentation == nil {
|
||||||
|
t.Fatal("Indentation should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.Indentation.FirstLine != "480" { // 24 * 20
|
||||||
|
t.Errorf("Expected first line indent 480, got %s", para.Properties.Indentation.FirstLine)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestParagraphAddFormattedText 测试段落添加格式化文本
|
||||||
|
func TestParagraphAddFormattedText(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
para := doc.AddParagraph("初始文本")
|
||||||
|
|
||||||
|
// 添加格式化文本
|
||||||
|
format := &TextFormat{
|
||||||
|
Bold: true,
|
||||||
|
FontColor: "0000FF",
|
||||||
|
}
|
||||||
|
|
||||||
|
para.AddFormattedText("格式化文本", format)
|
||||||
|
|
||||||
|
// 验证运行数量
|
||||||
|
if len(para.Runs) != 2 {
|
||||||
|
t.Errorf("Expected 2 runs, got %d", len(para.Runs))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证第二个运行的格式
|
||||||
|
run := para.Runs[1]
|
||||||
|
if run.Properties == nil {
|
||||||
|
t.Fatal("Second run should have properties")
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Properties.Bold == nil {
|
||||||
|
t.Error("Second run should be bold")
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Properties.Color == nil || run.Properties.Color.Val != "0000FF" {
|
||||||
|
t.Error("Second run should be blue")
|
||||||
|
}
|
||||||
|
|
||||||
|
if run.Text.Content != "格式化文本" {
|
||||||
|
t.Errorf("Expected '格式化文本', got '%s'", run.Text.Content)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestParagraphSetStyle 测试段落样式设置
|
||||||
|
func TestParagraphSetStyle(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
para := doc.AddParagraph("测试样式")
|
||||||
|
|
||||||
|
para.SetStyle("Heading1")
|
||||||
|
|
||||||
|
if para.Properties == nil {
|
||||||
|
t.Fatal("Properties should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.ParagraphStyle == nil {
|
||||||
|
t.Fatal("ParagraphStyle should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.ParagraphStyle.Val != "Heading1" {
|
||||||
|
t.Errorf("Expected style Heading1, got %s", para.Properties.ParagraphStyle.Val)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestDocumentSave 测试文档保存
|
||||||
|
func TestDocumentSave(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
doc.AddParagraph("测试保存功能")
|
||||||
|
|
||||||
|
filename := "test_save.docx"
|
||||||
|
defer os.Remove(filename) // 清理测试文件
|
||||||
|
|
||||||
|
err := doc.Save(filename)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to save document: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证文件是否存在
|
||||||
|
if _, err := os.Stat(filename); os.IsNotExist(err) {
|
||||||
|
t.Error("Saved file does not exist")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证文件大小
|
||||||
|
stat, err := os.Stat(filename)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to get file stats: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
if stat.Size() == 0 {
|
||||||
|
t.Error("Saved file is empty")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestDocumentGetStyleManager 测试获取样式管理器
|
||||||
|
func TestDocumentGetStyleManager(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
styleManager := doc.GetStyleManager()
|
||||||
|
if styleManager == nil {
|
||||||
|
t.Fatal("Style manager should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证样式管理器功能
|
||||||
|
if !styleManager.StyleExists("Normal") {
|
||||||
|
t.Error("Normal style should exist")
|
||||||
|
}
|
||||||
|
|
||||||
|
if !styleManager.StyleExists("Heading1") {
|
||||||
|
t.Error("Heading1 style should exist")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestComplexDocument 测试复杂文档创建
|
||||||
|
func TestComplexDocument(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
// 添加标题
|
||||||
|
title := doc.AddFormattedParagraph("文档标题", &TextFormat{
|
||||||
|
Bold: true,
|
||||||
|
FontSize: 18,
|
||||||
|
})
|
||||||
|
title.SetAlignment(AlignCenter)
|
||||||
|
|
||||||
|
// 添加各级标题
|
||||||
|
doc.AddHeadingParagraph("第一章", 1)
|
||||||
|
doc.AddHeadingParagraph("1.1 概述", 2)
|
||||||
|
doc.AddHeadingParagraph("1.1.1 背景", 3)
|
||||||
|
|
||||||
|
// 添加带间距的段落
|
||||||
|
para := doc.AddParagraph("这是一个带有特殊间距的段落")
|
||||||
|
para.SetSpacing(&SpacingConfig{
|
||||||
|
LineSpacing: 1.5,
|
||||||
|
BeforePara: 12,
|
||||||
|
AfterPara: 6,
|
||||||
|
})
|
||||||
|
|
||||||
|
// 添加混合格式段落
|
||||||
|
mixed := doc.AddParagraph("这段文字包含")
|
||||||
|
mixed.AddFormattedText("粗体", &TextFormat{Bold: true})
|
||||||
|
mixed.AddFormattedText("和", nil)
|
||||||
|
mixed.AddFormattedText("斜体", &TextFormat{Italic: true})
|
||||||
|
mixed.AddFormattedText("文本。", nil)
|
||||||
|
|
||||||
|
// 验证文档结构
|
||||||
|
if len(doc.Body.Paragraphs) != 6 {
|
||||||
|
t.Errorf("Expected 6 paragraphs, got %d", len(doc.Body.Paragraphs))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 保存并验证
|
||||||
|
filename := "test_complex.docx"
|
||||||
|
defer os.Remove(filename)
|
||||||
|
|
||||||
|
err := doc.Save(filename)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to save complex document: %v", err)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestDocumentOpen 测试打开文档（需要先创建一个测试文档）
|
||||||
|
func TestDocumentOpen(t *testing.T) {
|
||||||
|
// 先创建一个测试文档
|
||||||
|
originalDoc := New()
|
||||||
|
originalDoc.AddParagraph("第一段")
|
||||||
|
originalDoc.AddParagraph("第二段")
|
||||||
|
originalDoc.AddHeadingParagraph("标题", 1)
|
||||||
|
|
||||||
|
filename := "test_open.docx"
|
||||||
|
defer os.Remove(filename)
|
||||||
|
|
||||||
|
err := originalDoc.Save(filename)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to save test document: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 打开文档
|
||||||
|
loadedDoc, err := Open(filename)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to open document: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证文档内容
|
||||||
|
if len(loadedDoc.Body.Paragraphs) != 3 {
|
||||||
|
t.Errorf("Expected 3 paragraphs, got %d", len(loadedDoc.Body.Paragraphs))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证第一段内容
|
||||||
|
if len(loadedDoc.Body.Paragraphs[0].Runs) > 0 {
|
||||||
|
content := loadedDoc.Body.Paragraphs[0].Runs[0].Text.Content
|
||||||
|
if content != "第一段" {
|
||||||
|
t.Errorf("Expected '第一段', got '%s'", content)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestErrorHandling 测试错误处理
|
||||||
|
func TestErrorHandling(t *testing.T) {
|
||||||
|
// 测试打开不存在的文件
|
||||||
|
_, err := Open("nonexistent.docx")
|
||||||
|
if err == nil {
|
||||||
|
t.Error("Should return error when opening non-existent file")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试保存到只读目录（如果创建失败则跳过这个测试）
|
||||||
|
doc := New()
|
||||||
|
doc.AddParagraph("测试")
|
||||||
|
|
||||||
|
// 尝试保存到一个包含空字符的无效文件名
|
||||||
|
invalidPath := "test\x00invalid.docx"
|
||||||
|
err = doc.Save(invalidPath)
|
||||||
|
if err == nil {
|
||||||
|
// 如果第一个测试没有失败，尝试另一个策略
|
||||||
|
// 尝试保存到一个超长路径
|
||||||
|
longPath := string(make([]byte, 300)) + ".docx"
|
||||||
|
err = doc.Save(longPath)
|
||||||
|
if err == nil {
|
||||||
|
t.Log("Warning: Unable to trigger save error - filesystem may be permissive")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestStyleIntegration 测试样式集成
|
||||||
|
func TestStyleIntegration(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
styleManager := doc.GetStyleManager()
|
||||||
|
quickAPI := style.NewQuickStyleAPI(styleManager)
|
||||||
|
|
||||||
|
// 创建自定义样式
|
||||||
|
config := style.QuickStyleConfig{
|
||||||
|
ID: "TestStyle",
|
||||||
|
Name: "测试样式",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: "Normal",
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
Bold: true,
|
||||||
|
FontColor: "FF0000",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
_, err := quickAPI.CreateQuickStyle(config)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to create custom style: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 使用自定义样式
|
||||||
|
para := doc.AddParagraph("使用自定义样式")
|
||||||
|
para.SetStyle("TestStyle")
|
||||||
|
|
||||||
|
// 验证样式应用
|
||||||
|
if para.Properties == nil || para.Properties.ParagraphStyle == nil {
|
||||||
|
t.Fatal("Style should be applied to paragraph")
|
||||||
|
}
|
||||||
|
|
||||||
|
if para.Properties.ParagraphStyle.Val != "TestStyle" {
|
||||||
|
t.Errorf("Expected TestStyle, got %s", para.Properties.ParagraphStyle.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证样式存在
|
||||||
|
if !styleManager.StyleExists("TestStyle") {
|
||||||
|
t.Error("Custom style should exist in style manager")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// BenchmarkAddParagraph 基准测试 - 添加段落性能
|
||||||
|
func BenchmarkAddParagraph(b *testing.B) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
b.ResetTimer()
|
||||||
|
for i := 0; i < b.N; i++ {
|
||||||
|
doc.AddParagraph("基准测试段落")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// BenchmarkDocumentSave 基准测试 - 文档保存性能
|
||||||
|
func BenchmarkDocumentSave(b *testing.B) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
// 创建一个中等大小的文档
|
||||||
|
for i := 0; i < 100; i++ {
|
||||||
|
doc.AddParagraph("基准测试段落内容")
|
||||||
|
}
|
||||||
|
|
||||||
|
b.ResetTimer()
|
||||||
|
for i := 0; i < b.N; i++ {
|
||||||
|
filename := "benchmark_save.docx"
|
||||||
|
err := doc.Save(filename)
|
||||||
|
if err != nil {
|
||||||
|
b.Fatalf("Failed to save: %v", err)
|
||||||
|
}
|
||||||
|
os.Remove(filename)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestTextFormatValidation 测试文本格式验证
|
||||||
|
func TestTextFormatValidation(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
// 测试颜色格式
|
||||||
|
testCases := []struct {
|
||||||
|
color string
|
||||||
|
expected string
|
||||||
|
}{
|
||||||
|
{"#FF0000", "FF0000"}, // 带#前缀
|
||||||
|
{"FF0000", "FF0000"}, // 不带#前缀
|
||||||
|
{"#123456", "123456"},
|
||||||
|
{"ABCDEF", "ABCDEF"},
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, tc := range testCases {
|
||||||
|
format := &TextFormat{
|
||||||
|
FontColor: tc.color,
|
||||||
|
}
|
||||||
|
|
||||||
|
para := doc.AddFormattedParagraph("测试颜色", format)
|
||||||
|
if para.Runs[0].Properties.Color.Val != tc.expected {
|
||||||
|
t.Errorf("Color %s should be formatted as %s, got %s",
|
||||||
|
tc.color, tc.expected, para.Runs[0].Properties.Color.Val)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestMemoryUsage 测试内存使用
|
||||||
|
func TestMemoryUsage(t *testing.T) {
|
||||||
|
doc := New()
|
||||||
|
|
||||||
|
// 添加大量段落测试内存使用
|
||||||
|
const numParagraphs = 1000
|
||||||
|
for i := 0; i < numParagraphs; i++ {
|
||||||
|
doc.AddParagraph("内存测试段落")
|
||||||
|
}
|
||||||
|
|
||||||
|
if len(doc.Body.Paragraphs) != numParagraphs {
|
||||||
|
t.Errorf("Expected %d paragraphs, got %d", numParagraphs, len(doc.Body.Paragraphs))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试保存大文档
|
||||||
|
filename := "test_memory.docx"
|
||||||
|
defer os.Remove(filename)
|
||||||
|
|
||||||
|
err := doc.Save(filename)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to save large document: %v", err)
|
||||||
|
}
|
||||||
|
}
|
||||||
511
pkg/style/README.md
Normal file
511
pkg/style/README.md
Normal file
@@ -0,0 +1,511 @@
|
|||||||
|
# Style Package - WordZero 样式管理系统
|
||||||
|
|
||||||
|
WordZero 的样式管理包提供了完整的 Word 文档样式系统实现，支持预定义样式、自定义样式和样式继承机制。
|
||||||
|
|
||||||
|
## 🌟 核心特性
|
||||||
|
|
||||||
|
### 🎨 完整的预定义样式库
|
||||||
|
- **标题样式**: Heading1-Heading9，支持完整的标题层次结构和导航窗格识别
|
||||||
|
- **文档样式**: Title（文档标题）、Subtitle（副标题）
|
||||||
|
- **段落样式**: Normal（正文）、Quote（引用）、ListParagraph（列表段落）、CodeBlock（代码块）
|
||||||
|
- **字符样式**: Emphasis（强调）、Strong（加粗）、CodeChar（代码字符）
|
||||||
|
|
||||||
|
### 🔧 高级样式管理
|
||||||
|
- **样式继承**: 完整的样式继承机制，自动合并父样式属性
|
||||||
|
- **自定义样式**: 快速创建和管理自定义样式
|
||||||
|
- **样式验证**: 样式存在性检查和错误处理
|
||||||
|
- **类型分类**: 按样式类型（段落、字符、表格等）管理和查询
|
||||||
|
|
||||||
|
### 🚀 便捷API接口
|
||||||
|
- **StyleManager**: 核心样式管理器，提供底层样式操作
|
||||||
|
- **QuickStyleAPI**: 高级样式操作接口，简化常用操作
|
||||||
|
- **样式信息查询**: 获取样式详情、按类型筛选、批量操作
|
||||||
|
|
||||||
|
## 📦 安装使用
|
||||||
|
|
||||||
|
```go
|
||||||
|
import "github.com/ZeroHawkeye/wordZero/pkg/style"
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🚀 快速开始
|
||||||
|
|
||||||
|
### 创建样式管理器
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 创建样式管理器（自动加载预定义样式）
|
||||||
|
styleManager := style.NewStyleManager()
|
||||||
|
|
||||||
|
// 创建快速API（推荐方式）
|
||||||
|
quickAPI := style.NewQuickStyleAPI(styleManager)
|
||||||
|
|
||||||
|
// 获取所有可用样式
|
||||||
|
allStyles := quickAPI.GetAllStylesInfo()
|
||||||
|
fmt.Printf("加载了 %d 个样式\n", len(allStyles))
|
||||||
|
```
|
||||||
|
|
||||||
|
### 使用预定义样式
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 获取特定样式
|
||||||
|
heading1 := styleManager.GetStyle("Heading1")
|
||||||
|
if heading1 != nil {
|
||||||
|
fmt.Printf("找到样式: %s\n", heading1.Name.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 获取所有标题样式
|
||||||
|
headingStyles := styleManager.GetHeadingStyles()
|
||||||
|
fmt.Printf("标题样式数量: %d\n", len(headingStyles))
|
||||||
|
|
||||||
|
// 获取样式详细信息
|
||||||
|
styleInfo, err := quickAPI.GetStyleInfo("Heading1")
|
||||||
|
if err == nil {
|
||||||
|
fmt.Printf("样式名称: %s\n", styleInfo.Name)
|
||||||
|
fmt.Printf("样式类型: %s\n", styleInfo.Type)
|
||||||
|
fmt.Printf("样式描述: %s\n", styleInfo.Description)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 在文档中应用样式
|
||||||
|
|
||||||
|
```go
|
||||||
|
import "github.com/ZeroHawkeye/wordZero/pkg/document"
|
||||||
|
|
||||||
|
// 创建文档
|
||||||
|
doc := document.New()
|
||||||
|
|
||||||
|
// 使用AddHeadingParagraph方法（推荐）
|
||||||
|
doc.AddHeadingParagraph("第一章：概述", 1) // 自动应用Heading1样式
|
||||||
|
doc.AddHeadingParagraph("1.1 背景介绍", 2) // 自动应用Heading2样式
|
||||||
|
|
||||||
|
// 或手动设置样式
|
||||||
|
para := doc.AddParagraph("这是引用文本")
|
||||||
|
para.SetStyle("Quote") // 应用Quote样式
|
||||||
|
|
||||||
|
// 保存文档
|
||||||
|
doc.Save("styled_document.docx")
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📋 预定义样式详细列表
|
||||||
|
|
||||||
|
### 段落样式 (Paragraph Styles)
|
||||||
|
|
||||||
|
| 样式ID | 中文名称 | 英文名称 | 描述 |
|
||||||
|
|--------|----------|----------|------|
|
||||||
|
| Normal | 普通文本 | Normal | 默认段落样式，Calibri 11磅，1.15倍行距 |
|
||||||
|
| Heading1 | 标题 1 | Heading 1 | 一级标题，16磅蓝色粗体，支持导航窗格 |
|
||||||
|
| Heading2 | 标题 2 | Heading 2 | 二级标题，13磅蓝色粗体，支持导航窗格 |
|
||||||
|
| Heading3 | 标题 3 | Heading 3 | 三级标题，12磅蓝色粗体，支持导航窗格 |
|
||||||
|
| Heading4 | 标题 4 | Heading 4 | 四级标题，11磅蓝色粗体 |
|
||||||
|
| Heading5 | 标题 5 | Heading 5 | 五级标题，11磅蓝色 |
|
||||||
|
| Heading6 | 标题 6 | Heading 6 | 六级标题，11磅蓝色 |
|
||||||
|
| Heading7 | 标题 7 | Heading 7 | 七级标题，11磅斜体 |
|
||||||
|
| Heading8 | 标题 8 | Heading 8 | 八级标题，10磅灰色 |
|
||||||
|
| Heading9 | 标题 9 | Heading 9 | 九级标题，10磅斜体灰色 |
|
||||||
|
| Title | 文档标题 | Title | 28磅居中标题样式 |
|
||||||
|
| Subtitle | 副标题 | Subtitle | 15磅居中副标题样式 |
|
||||||
|
| Quote | 引用 | Quote | 斜体灰色，左右缩进720TWIPs |
|
||||||
|
| ListParagraph | 列表段落 | List Paragraph | 带左缩进的列表样式 |
|
||||||
|
| CodeBlock | 代码块 | Code Block | 等宽字体，灰色背景效果 |
|
||||||
|
|
||||||
|
### 字符样式 (Character Styles)
|
||||||
|
|
||||||
|
| 样式ID | 中文名称 | 英文名称 | 描述 |
|
||||||
|
|--------|----------|----------|------|
|
||||||
|
| Emphasis | 强调 | Emphasis | 斜体文本 |
|
||||||
|
| Strong | 加粗 | Strong | 粗体文本 |
|
||||||
|
| CodeChar | 代码字符 | Code Character | 红色等宽字体 |
|
||||||
|
|
||||||
|
## 🔧 自定义样式创建
|
||||||
|
|
||||||
|
### 使用QuickStyleConfig快速创建
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 创建自定义段落样式
|
||||||
|
config := style.QuickStyleConfig{
|
||||||
|
ID: "MyTitle",
|
||||||
|
Name: "我的标题样式",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: "Normal", // 基于Normal样式
|
||||||
|
ParagraphConfig: &style.QuickParagraphConfig{
|
||||||
|
Alignment: "center",
|
||||||
|
LineSpacing: 1.5,
|
||||||
|
SpaceBefore: 15,
|
||||||
|
SpaceAfter: 10,
|
||||||
|
FirstLineIndent: 0,
|
||||||
|
LeftIndent: 0,
|
||||||
|
RightIndent: 0,
|
||||||
|
},
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontName: "华文中宋",
|
||||||
|
FontSize: 18,
|
||||||
|
FontColor: "2F5496", // 深蓝色
|
||||||
|
Bold: true,
|
||||||
|
Italic: false,
|
||||||
|
Underline: false,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建样式
|
||||||
|
customStyle, err := quickAPI.CreateQuickStyle(config)
|
||||||
|
if err != nil {
|
||||||
|
log.Printf("创建样式失败: %v", err)
|
||||||
|
} else {
|
||||||
|
fmt.Printf("成功创建样式: %s\n", customStyle.Name.Val)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 创建字符样式
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 创建自定义字符样式
|
||||||
|
charConfig := style.QuickStyleConfig{
|
||||||
|
ID: "Highlight",
|
||||||
|
Name: "高亮文本",
|
||||||
|
Type: style.StyleTypeCharacter,
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontColor: "FF0000", // 红色
|
||||||
|
Bold: true,
|
||||||
|
Highlight: "yellow", // 黄色高亮
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
highlightStyle, err := quickAPI.CreateQuickStyle(charConfig)
|
||||||
|
if err != nil {
|
||||||
|
log.Printf("创建字符样式失败: %v", err)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 高级自定义样式
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 使用完整的Style结构创建复杂样式
|
||||||
|
complexStyle := &style.Style{
|
||||||
|
Type: string(style.StyleTypeParagraph),
|
||||||
|
StyleID: "ComplexTitle",
|
||||||
|
Name: &style.StyleName{Val: "复杂标题样式"},
|
||||||
|
BasedOn: &style.BasedOn{Val: "Heading1"},
|
||||||
|
Next: &style.Next{Val: "Normal"},
|
||||||
|
ParagraphPr: &style.ParagraphProperties{
|
||||||
|
Spacing: &style.Spacing{
|
||||||
|
Before: "240", // 12磅
|
||||||
|
After: "120", // 6磅
|
||||||
|
Line: "276", // 1.15倍行距
|
||||||
|
},
|
||||||
|
Justification: &style.Justification{Val: "center"},
|
||||||
|
Indentation: &style.Indentation{
|
||||||
|
FirstLine: "0",
|
||||||
|
Left: "0",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
RunPr: &style.RunProperties{
|
||||||
|
FontFamily: &style.FontFamily{ASCII: "Times New Roman"},
|
||||||
|
FontSize: &style.FontSize{Val: "32"}, // 16磅
|
||||||
|
Color: &style.Color{Val: "1F4E79"},
|
||||||
|
Bold: &style.Bold{},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
styleManager.AddStyle(complexStyle)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔍 样式查询和管理
|
||||||
|
|
||||||
|
### 按类型查询样式
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 获取所有段落样式信息
|
||||||
|
paragraphStyles := quickAPI.GetParagraphStylesInfo()
|
||||||
|
fmt.Printf("段落样式数量: %d\n", len(paragraphStyles))
|
||||||
|
|
||||||
|
// 获取所有字符样式信息
|
||||||
|
characterStyles := quickAPI.GetCharacterStylesInfo()
|
||||||
|
fmt.Printf("字符样式数量: %d\n", len(characterStyles))
|
||||||
|
|
||||||
|
// 获取所有标题样式信息
|
||||||
|
headingStyles := quickAPI.GetHeadingStylesInfo()
|
||||||
|
fmt.Printf("标题样式数量: %d\n", len(headingStyles))
|
||||||
|
|
||||||
|
// 打印样式详情
|
||||||
|
for _, styleInfo := range headingStyles {
|
||||||
|
fmt.Printf("- %s (%s): %s\n",
|
||||||
|
styleInfo.Name, styleInfo.ID, styleInfo.Description)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 样式存在性检查
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 检查样式是否存在
|
||||||
|
if styleManager.StyleExists("Heading1") {
|
||||||
|
fmt.Println("Heading1 样式存在")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证样式并获取详情
|
||||||
|
styleInfo, err := quickAPI.GetStyleInfo("CustomStyle")
|
||||||
|
if err != nil {
|
||||||
|
fmt.Printf("样式不存在: %v\n", err)
|
||||||
|
} else {
|
||||||
|
fmt.Printf("找到样式: %s\n", styleInfo.Name)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 样式管理操作
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 获取所有样式
|
||||||
|
allStyles := styleManager.GetAllStyles()
|
||||||
|
fmt.Printf("总样式数: %d\n", len(allStyles))
|
||||||
|
|
||||||
|
// 移除自定义样式
|
||||||
|
styleManager.RemoveStyle("MyCustomStyle")
|
||||||
|
|
||||||
|
// 清空所有样式（注意：这会删除预定义样式）
|
||||||
|
// styleManager.ClearStyles()
|
||||||
|
|
||||||
|
// 重新加载预定义样式
|
||||||
|
styleManager.LoadPredefinedStyles()
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔄 样式继承机制
|
||||||
|
|
||||||
|
### 理解样式继承
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 获取带继承的完整样式
|
||||||
|
fullStyle := styleManager.GetStyleWithInheritance("Heading2")
|
||||||
|
|
||||||
|
// Heading2 基于 Normal 样式
|
||||||
|
// GetStyleWithInheritance 会自动合并：
|
||||||
|
// 1. Normal 样式的所有属性
|
||||||
|
// 2. Heading2 样式的覆盖属性
|
||||||
|
// 3. 返回完整的合并样式
|
||||||
|
|
||||||
|
if fullStyle.BasedOn != nil {
|
||||||
|
fmt.Printf("Heading2 基于样式: %s\n", fullStyle.BasedOn.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查继承的属性
|
||||||
|
if fullStyle.RunPr != nil && fullStyle.RunPr.FontSize != nil {
|
||||||
|
fmt.Printf("继承的字体大小: %s\n", fullStyle.RunPr.FontSize.Val)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 创建继承样式
|
||||||
|
|
||||||
|
```go
|
||||||
|
// 创建基于Heading1的自定义样式
|
||||||
|
customHeading := style.QuickStyleConfig{
|
||||||
|
ID: "MyHeading",
|
||||||
|
Name: "我的标题",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: "Heading1", // 继承Heading1的所有属性
|
||||||
|
// 只覆盖需要修改的属性
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontColor: "8B0000", // 改为深红色
|
||||||
|
// 其他属性（字体大小、粗体等）从Heading1继承
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
inheritedStyle, _ := quickAPI.CreateQuickStyle(customHeading)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🎯 样式属性配置详解
|
||||||
|
|
||||||
|
### ParagraphConfig 段落属性
|
||||||
|
|
||||||
|
```go
|
||||||
|
type QuickParagraphConfig struct {
|
||||||
|
Alignment string // 对齐方式
|
||||||
|
LineSpacing float64 // 行间距倍数
|
||||||
|
SpaceBefore int // 段前间距（磅）
|
||||||
|
SpaceAfter int // 段后间距（磅）
|
||||||
|
FirstLineIndent int // 首行缩进（磅）
|
||||||
|
LeftIndent int // 左缩进（磅）
|
||||||
|
RightIndent int // 右缩进（磅）
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**对齐方式选项:**
|
||||||
|
- `"left"` - 左对齐
|
||||||
|
- `"center"` - 居中对齐
|
||||||
|
- `"right"` - 右对齐
|
||||||
|
- `"justify"` - 两端对齐
|
||||||
|
|
||||||
|
**间距和缩进单位:**
|
||||||
|
- 所有数值单位为磅（Point）
|
||||||
|
- 1磅 = 1/72英寸 = 20TWIPs
|
||||||
|
|
||||||
|
### RunConfig 字符属性
|
||||||
|
|
||||||
|
```go
|
||||||
|
type QuickRunConfig struct {
|
||||||
|
FontName string // 字体名称
|
||||||
|
FontSize int // 字体大小（磅）
|
||||||
|
FontColor string // 字体颜色（十六进制）
|
||||||
|
Bold bool // 粗体
|
||||||
|
Italic bool // 斜体
|
||||||
|
Underline bool // 下划线
|
||||||
|
Strike bool // 删除线
|
||||||
|
Highlight string // 高亮颜色
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**字体颜色格式:**
|
||||||
|
- 十六进制RGB格式，如 `"FF0000"` (红色)
|
||||||
|
- 不需要 `#` 前缀
|
||||||
|
|
||||||
|
**高亮颜色选项:**
|
||||||
|
- `"yellow"` - 黄色
|
||||||
|
- `"green"` - 绿色
|
||||||
|
- `"cyan"` - 青色
|
||||||
|
- `"magenta"` - 洋红色
|
||||||
|
- `"blue"` - 蓝色
|
||||||
|
- `"red"` - 红色
|
||||||
|
- `"darkBlue"` - 深蓝色
|
||||||
|
- `"darkCyan"` - 深青色
|
||||||
|
- `"darkGreen"` - 深绿色
|
||||||
|
- `"darkMagenta"` - 深洋红色
|
||||||
|
- `"darkRed"` - 深红色
|
||||||
|
- `"darkYellow"` - 深黄色
|
||||||
|
- `"darkGray"` - 深灰色
|
||||||
|
- `"lightGray"` - 浅灰色
|
||||||
|
- `"black"` - 黑色
|
||||||
|
|
||||||
|
## 📋 完整使用示例
|
||||||
|
|
||||||
|
### 创建带样式的完整文档
|
||||||
|
|
||||||
|
```go
|
||||||
|
package main
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"log"
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/document"
|
||||||
|
"github.com/ZeroHawkeye/wordZero/pkg/style"
|
||||||
|
)
|
||||||
|
|
||||||
|
func main() {
|
||||||
|
// 创建文档和样式管理器
|
||||||
|
doc := document.New()
|
||||||
|
styleManager := doc.GetStyleManager()
|
||||||
|
quickAPI := style.NewQuickStyleAPI(styleManager)
|
||||||
|
|
||||||
|
// 创建自定义样式
|
||||||
|
createCustomStyles(quickAPI)
|
||||||
|
|
||||||
|
// 构建文档内容
|
||||||
|
buildDocumentContent(doc)
|
||||||
|
|
||||||
|
// 保存文档
|
||||||
|
err := doc.Save("styled_document_complete.docx")
|
||||||
|
if err != nil {
|
||||||
|
log.Fatal(err)
|
||||||
|
}
|
||||||
|
|
||||||
|
fmt.Println("文档创建完成：styled_document_complete.docx")
|
||||||
|
}
|
||||||
|
|
||||||
|
func createCustomStyles(quickAPI *style.QuickStyleAPI) {
|
||||||
|
// 创建自定义标题样式
|
||||||
|
titleConfig := style.QuickStyleConfig{
|
||||||
|
ID: "CustomTitle",
|
||||||
|
Name: "自定义文档标题",
|
||||||
|
Type: style.StyleTypeParagraph,
|
||||||
|
BasedOn: "Title",
|
||||||
|
ParagraphConfig: &style.QuickParagraphConfig{
|
||||||
|
Alignment: "center",
|
||||||
|
SpaceBefore: 24,
|
||||||
|
SpaceAfter: 18,
|
||||||
|
},
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontName: "华文中宋",
|
||||||
|
FontSize: 20,
|
||||||
|
FontColor: "1F4E79",
|
||||||
|
Bold: true,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建高亮文本样式
|
||||||
|
highlightConfig := style.QuickStyleConfig{
|
||||||
|
ID: "ImportantText",
|
||||||
|
Name: "重要文本",
|
||||||
|
Type: style.StyleTypeCharacter,
|
||||||
|
RunConfig: &style.QuickRunConfig{
|
||||||
|
FontColor: "C00000",
|
||||||
|
Bold: true,
|
||||||
|
Highlight: "yellow",
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
quickAPI.CreateQuickStyle(titleConfig)
|
||||||
|
quickAPI.CreateQuickStyle(highlightConfig)
|
||||||
|
}
|
||||||
|
|
||||||
|
func buildDocumentContent(doc *document.Document) {
|
||||||
|
// 使用自定义标题样式
|
||||||
|
title := doc.AddParagraph("WordZero 样式系统使用指南")
|
||||||
|
title.SetStyle("CustomTitle")
|
||||||
|
|
||||||
|
// 使用标题样式（支持导航窗格）
|
||||||
|
doc.AddHeadingParagraph("1. 样式系统概述", 1)
|
||||||
|
doc.AddParagraph("WordZero 提供了完整的样式管理系统，支持预定义样式和自定义样式。")
|
||||||
|
|
||||||
|
doc.AddHeadingParagraph("1.1 预定义样式", 2)
|
||||||
|
para := doc.AddParagraph("系统预置了18种常用样式，包括：")
|
||||||
|
para.AddFormattedText("标题样式", &document.TextFormat{Bold: true})
|
||||||
|
para.AddFormattedText("、", nil)
|
||||||
|
para.AddFormattedText("段落样式", &document.TextFormat{Bold: true})
|
||||||
|
para.AddFormattedText("和", nil)
|
||||||
|
para.AddFormattedText("字符样式", &document.TextFormat{Bold: true})
|
||||||
|
para.AddFormattedText("。", nil)
|
||||||
|
|
||||||
|
doc.AddHeadingParagraph("1.2 自定义样式", 2)
|
||||||
|
doc.AddParagraph("用户可以基于现有样式创建自定义样式，实现个性化的文档格式。")
|
||||||
|
|
||||||
|
doc.AddHeadingParagraph("2. 实际应用", 1)
|
||||||
|
|
||||||
|
// 使用引用样式
|
||||||
|
quote := doc.AddParagraph("样式是文档格式化的核心，它决定了文档的外观和专业程度。")
|
||||||
|
quote.SetStyle("Quote")
|
||||||
|
|
||||||
|
// 使用代码块样式
|
||||||
|
code := doc.AddParagraph("doc.AddHeadingParagraph(\"标题\", 1)")
|
||||||
|
code.SetStyle("CodeBlock")
|
||||||
|
|
||||||
|
doc.AddParagraph("更多详细信息请参考API文档。")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🧪 测试
|
||||||
|
|
||||||
|
详细的测试示例请参考：
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 运行样式系统测试
|
||||||
|
go test ./pkg/style/
|
||||||
|
|
||||||
|
# 运行带覆盖率的测试
|
||||||
|
go test -cover ./pkg/style/
|
||||||
|
|
||||||
|
# 运行样式演示程序
|
||||||
|
go run ./examples/style_demo/
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📚 相关文档
|
||||||
|
|
||||||
|
- [项目主README](../../README.md) - 完整项目介绍
|
||||||
|
- [文档操作API](../document/) - 核心文档操作功能
|
||||||
|
- [使用示例](../../examples/) - 完整的使用示例
|
||||||
|
|
||||||
|
## 🤝 贡献
|
||||||
|
|
||||||
|
欢迎提交样式相关的改进建议和代码！请确保：
|
||||||
|
|
||||||
|
1. 新增样式遵循Word标准规范
|
||||||
|
2. 提供完整的测试用例
|
||||||
|
3. 更新相关文档
|
||||||
|
|
||||||
|
## 📄 许可证
|
||||||
|
|
||||||
|
本包遵循项目的 MIT 许可证。
|
||||||
295
pkg/style/api.go
Normal file
295
pkg/style/api.go
Normal file
@@ -0,0 +1,295 @@
|
|||||||
|
// Package style 样式应用API
|
||||||
|
package style
|
||||||
|
|
||||||
|
import "fmt"
|
||||||
|
|
||||||
|
// StyleApplicator 样式应用器接口
|
||||||
|
type StyleApplicator interface {
|
||||||
|
ApplyStyle(styleID string) error
|
||||||
|
ApplyHeadingStyle(level int) error
|
||||||
|
ApplyTitleStyle() error
|
||||||
|
ApplySubtitleStyle() error
|
||||||
|
ApplyQuoteStyle() error
|
||||||
|
ApplyCodeBlockStyle() error
|
||||||
|
ApplyListParagraphStyle() error
|
||||||
|
ApplyNormalStyle() error
|
||||||
|
}
|
||||||
|
|
||||||
|
// QuickStyleAPI 快速样式应用API
|
||||||
|
type QuickStyleAPI struct {
|
||||||
|
styleManager *StyleManager
|
||||||
|
}
|
||||||
|
|
||||||
|
// NewQuickStyleAPI 创建快速样式API
|
||||||
|
func NewQuickStyleAPI(styleManager *StyleManager) *QuickStyleAPI {
|
||||||
|
return &QuickStyleAPI{
|
||||||
|
styleManager: styleManager,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetStyleInfo 获取样式信息（用于UI显示）
|
||||||
|
func (api *QuickStyleAPI) GetStyleInfo(styleID string) (*StyleInfo, error) {
|
||||||
|
style := api.styleManager.GetStyle(styleID)
|
||||||
|
if style == nil {
|
||||||
|
return nil, fmt.Errorf("样式 %s 不存在", styleID)
|
||||||
|
}
|
||||||
|
|
||||||
|
return &StyleInfo{
|
||||||
|
ID: style.StyleID,
|
||||||
|
Name: getStyleDisplayName(style),
|
||||||
|
Type: StyleType(style.Type),
|
||||||
|
Description: getStyleDescription(styleID),
|
||||||
|
IsBuiltIn: !style.CustomStyle,
|
||||||
|
BasedOn: getBasedOnStyleID(style),
|
||||||
|
}, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// StyleInfo 样式信息结构
|
||||||
|
type StyleInfo struct {
|
||||||
|
ID string `json:"id"`
|
||||||
|
Name string `json:"name"`
|
||||||
|
Type StyleType `json:"type"`
|
||||||
|
Description string `json:"description"`
|
||||||
|
IsBuiltIn bool `json:"isBuiltIn"`
|
||||||
|
BasedOn string `json:"basedOn,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetAllStylesInfo 获取所有样式信息
|
||||||
|
func (api *QuickStyleAPI) GetAllStylesInfo() []*StyleInfo {
|
||||||
|
var stylesInfo []*StyleInfo
|
||||||
|
for _, style := range api.styleManager.GetAllStyles() {
|
||||||
|
info := &StyleInfo{
|
||||||
|
ID: style.StyleID,
|
||||||
|
Name: getStyleDisplayName(style),
|
||||||
|
Type: StyleType(style.Type),
|
||||||
|
Description: getStyleDescription(style.StyleID),
|
||||||
|
IsBuiltIn: !style.CustomStyle,
|
||||||
|
BasedOn: getBasedOnStyleID(style),
|
||||||
|
}
|
||||||
|
stylesInfo = append(stylesInfo, info)
|
||||||
|
}
|
||||||
|
return stylesInfo
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetHeadingStylesInfo 获取所有标题样式信息
|
||||||
|
func (api *QuickStyleAPI) GetHeadingStylesInfo() []*StyleInfo {
|
||||||
|
var headingStylesInfo []*StyleInfo
|
||||||
|
for i := 1; i <= 9; i++ {
|
||||||
|
styleID := fmt.Sprintf("Heading%d", i)
|
||||||
|
if info, err := api.GetStyleInfo(styleID); err == nil {
|
||||||
|
headingStylesInfo = append(headingStylesInfo, info)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return headingStylesInfo
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetParagraphStylesInfo 获取段落样式信息
|
||||||
|
func (api *QuickStyleAPI) GetParagraphStylesInfo() []*StyleInfo {
|
||||||
|
var paragraphStylesInfo []*StyleInfo
|
||||||
|
for _, style := range api.styleManager.GetStylesByType(StyleTypeParagraph) {
|
||||||
|
info := &StyleInfo{
|
||||||
|
ID: style.StyleID,
|
||||||
|
Name: getStyleDisplayName(style),
|
||||||
|
Type: StyleType(style.Type),
|
||||||
|
Description: getStyleDescription(style.StyleID),
|
||||||
|
IsBuiltIn: !style.CustomStyle,
|
||||||
|
BasedOn: getBasedOnStyleID(style),
|
||||||
|
}
|
||||||
|
paragraphStylesInfo = append(paragraphStylesInfo, info)
|
||||||
|
}
|
||||||
|
return paragraphStylesInfo
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetCharacterStylesInfo 获取字符样式信息
|
||||||
|
func (api *QuickStyleAPI) GetCharacterStylesInfo() []*StyleInfo {
|
||||||
|
var characterStylesInfo []*StyleInfo
|
||||||
|
for _, style := range api.styleManager.GetStylesByType(StyleTypeCharacter) {
|
||||||
|
info := &StyleInfo{
|
||||||
|
ID: style.StyleID,
|
||||||
|
Name: getStyleDisplayName(style),
|
||||||
|
Type: StyleType(style.Type),
|
||||||
|
Description: getStyleDescription(style.StyleID),
|
||||||
|
IsBuiltIn: !style.CustomStyle,
|
||||||
|
BasedOn: getBasedOnStyleID(style),
|
||||||
|
}
|
||||||
|
characterStylesInfo = append(characterStylesInfo, info)
|
||||||
|
}
|
||||||
|
return characterStylesInfo
|
||||||
|
}
|
||||||
|
|
||||||
|
// CreateQuickStyle 快速创建自定义样式
|
||||||
|
func (api *QuickStyleAPI) CreateQuickStyle(config QuickStyleConfig) (*Style, error) {
|
||||||
|
// 验证样式ID是否已存在
|
||||||
|
if api.styleManager.StyleExists(config.ID) {
|
||||||
|
return nil, fmt.Errorf("样式ID %s 已存在", config.ID)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建基础样式
|
||||||
|
style := api.styleManager.CreateCustomStyle(
|
||||||
|
config.ID,
|
||||||
|
config.Name,
|
||||||
|
config.Type,
|
||||||
|
config.BasedOn,
|
||||||
|
)
|
||||||
|
|
||||||
|
// 应用段落属性
|
||||||
|
if config.ParagraphConfig != nil {
|
||||||
|
style.ParagraphPr = createParagraphProperties(config.ParagraphConfig)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 应用字符属性
|
||||||
|
if config.RunConfig != nil {
|
||||||
|
style.RunPr = createRunProperties(config.RunConfig)
|
||||||
|
}
|
||||||
|
|
||||||
|
return style, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// QuickStyleConfig 快速样式配置
|
||||||
|
type QuickStyleConfig struct {
|
||||||
|
ID string `json:"id"`
|
||||||
|
Name string `json:"name"`
|
||||||
|
Type StyleType `json:"type"`
|
||||||
|
BasedOn string `json:"basedOn,omitempty"`
|
||||||
|
ParagraphConfig *QuickParagraphConfig `json:"paragraphConfig,omitempty"`
|
||||||
|
RunConfig *QuickRunConfig `json:"runConfig,omitempty"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// QuickParagraphConfig 快速段落配置
|
||||||
|
type QuickParagraphConfig struct {
|
||||||
|
Alignment string `json:"alignment,omitempty"` // left, center, right, justify
|
||||||
|
LineSpacing float64 `json:"lineSpacing,omitempty"` // 行间距倍数
|
||||||
|
SpaceBefore int `json:"spaceBefore,omitempty"` // 段前间距（磅）
|
||||||
|
SpaceAfter int `json:"spaceAfter,omitempty"` // 段后间距（磅）
|
||||||
|
FirstLineIndent int `json:"firstLineIndent,omitempty"` // 首行缩进（磅）
|
||||||
|
LeftIndent int `json:"leftIndent,omitempty"` // 左缩进（磅）
|
||||||
|
RightIndent int `json:"rightIndent,omitempty"` // 右缩进（磅）
|
||||||
|
}
|
||||||
|
|
||||||
|
// QuickRunConfig 快速字符配置
|
||||||
|
type QuickRunConfig struct {
|
||||||
|
FontName string `json:"fontName,omitempty"` // 字体名称
|
||||||
|
FontSize int `json:"fontSize,omitempty"` // 字体大小（磅）
|
||||||
|
FontColor string `json:"fontColor,omitempty"` // 字体颜色（十六进制）
|
||||||
|
Bold bool `json:"bold,omitempty"` // 粗体
|
||||||
|
Italic bool `json:"italic,omitempty"` // 斜体
|
||||||
|
Underline bool `json:"underline,omitempty"` // 下划线
|
||||||
|
Strike bool `json:"strike,omitempty"` // 删除线
|
||||||
|
Highlight string `json:"highlight,omitempty"` // 高亮颜色
|
||||||
|
}
|
||||||
|
|
||||||
|
// getStyleDisplayName 获取样式显示名称
|
||||||
|
func getStyleDisplayName(style *Style) string {
|
||||||
|
if style.Name != nil {
|
||||||
|
return style.Name.Val
|
||||||
|
}
|
||||||
|
return style.StyleID
|
||||||
|
}
|
||||||
|
|
||||||
|
// getStyleDescription 获取样式描述
|
||||||
|
func getStyleDescription(styleID string) string {
|
||||||
|
configs := GetPredefinedStyleConfigs()
|
||||||
|
for _, config := range configs {
|
||||||
|
if config.StyleID == styleID {
|
||||||
|
return config.Description
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return ""
|
||||||
|
}
|
||||||
|
|
||||||
|
// getBasedOnStyleID 获取基础样式ID
|
||||||
|
func getBasedOnStyleID(style *Style) string {
|
||||||
|
if style.BasedOn != nil {
|
||||||
|
return style.BasedOn.Val
|
||||||
|
}
|
||||||
|
return ""
|
||||||
|
}
|
||||||
|
|
||||||
|
// createParagraphProperties 创建段落属性
|
||||||
|
func createParagraphProperties(config *QuickParagraphConfig) *ParagraphProperties {
|
||||||
|
props := &ParagraphProperties{}
|
||||||
|
|
||||||
|
// 对齐方式
|
||||||
|
if config.Alignment != "" {
|
||||||
|
props.Justification = &Justification{Val: config.Alignment}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 间距设置
|
||||||
|
if config.LineSpacing > 0 || config.SpaceBefore > 0 || config.SpaceAfter > 0 {
|
||||||
|
spacing := &Spacing{}
|
||||||
|
if config.SpaceBefore > 0 {
|
||||||
|
spacing.Before = fmt.Sprintf("%d", config.SpaceBefore*20) // 转换为twips
|
||||||
|
}
|
||||||
|
if config.SpaceAfter > 0 {
|
||||||
|
spacing.After = fmt.Sprintf("%d", config.SpaceAfter*20) // 转换为twips
|
||||||
|
}
|
||||||
|
if config.LineSpacing > 0 {
|
||||||
|
spacing.Line = fmt.Sprintf("%.0f", config.LineSpacing*240) // 转换为行间距单位
|
||||||
|
spacing.LineRule = "auto"
|
||||||
|
}
|
||||||
|
props.Spacing = spacing
|
||||||
|
}
|
||||||
|
|
||||||
|
// 缩进设置
|
||||||
|
if config.FirstLineIndent > 0 || config.LeftIndent > 0 || config.RightIndent > 0 {
|
||||||
|
indentation := &Indentation{}
|
||||||
|
if config.FirstLineIndent > 0 {
|
||||||
|
indentation.FirstLine = fmt.Sprintf("%d", config.FirstLineIndent*20) // 转换为twips
|
||||||
|
}
|
||||||
|
if config.LeftIndent > 0 {
|
||||||
|
indentation.Left = fmt.Sprintf("%d", config.LeftIndent*20) // 转换为twips
|
||||||
|
}
|
||||||
|
if config.RightIndent > 0 {
|
||||||
|
indentation.Right = fmt.Sprintf("%d", config.RightIndent*20) // 转换为twips
|
||||||
|
}
|
||||||
|
props.Indentation = indentation
|
||||||
|
}
|
||||||
|
|
||||||
|
return props
|
||||||
|
}
|
||||||
|
|
||||||
|
// createRunProperties 创建字符属性
|
||||||
|
func createRunProperties(config *QuickRunConfig) *RunProperties {
|
||||||
|
props := &RunProperties{}
|
||||||
|
|
||||||
|
// 字体设置
|
||||||
|
if config.FontName != "" {
|
||||||
|
props.FontFamily = &FontFamily{
|
||||||
|
ASCII: config.FontName,
|
||||||
|
EastAsia: config.FontName,
|
||||||
|
HAnsi: config.FontName,
|
||||||
|
CS: config.FontName,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if config.FontSize > 0 {
|
||||||
|
props.FontSize = &FontSize{Val: fmt.Sprintf("%d", config.FontSize*2)} // Word使用半磅单位
|
||||||
|
}
|
||||||
|
|
||||||
|
if config.FontColor != "" {
|
||||||
|
props.Color = &Color{Val: config.FontColor}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 格式设置
|
||||||
|
if config.Bold {
|
||||||
|
props.Bold = &Bold{}
|
||||||
|
}
|
||||||
|
|
||||||
|
if config.Italic {
|
||||||
|
props.Italic = &Italic{}
|
||||||
|
}
|
||||||
|
|
||||||
|
if config.Underline {
|
||||||
|
props.Underline = &Underline{Val: "single"}
|
||||||
|
}
|
||||||
|
|
||||||
|
if config.Strike {
|
||||||
|
props.Strike = &Strike{}
|
||||||
|
}
|
||||||
|
|
||||||
|
if config.Highlight != "" {
|
||||||
|
props.Highlight = &Highlight{Val: config.Highlight}
|
||||||
|
}
|
||||||
|
|
||||||
|
return props
|
||||||
|
}
|
||||||
301
pkg/style/api_test.go
Normal file
301
pkg/style/api_test.go
Normal file
@@ -0,0 +1,301 @@
|
|||||||
|
package style
|
||||||
|
|
||||||
|
import (
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
func TestNewQuickStyleAPI(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
if api == nil {
|
||||||
|
t.Fatal("NewQuickStyleAPI 返回了 nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if api.styleManager != sm {
|
||||||
|
t.Error("QuickStyleAPI 的 styleManager 设置不正确")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestGetStyleInfo(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
// 测试获取存在的样式信息
|
||||||
|
info, err := api.GetStyleInfo("Heading1")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("获取样式信息失败: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
if info.ID != "Heading1" {
|
||||||
|
t.Errorf("期望样式ID为 'Heading1'，实际为 '%s'", info.ID)
|
||||||
|
}
|
||||||
|
|
||||||
|
if info.Name != "heading 1" {
|
||||||
|
t.Errorf("期望样式名称为 'heading 1'，实际为 '%s'", info.Name)
|
||||||
|
}
|
||||||
|
|
||||||
|
if info.Type != StyleTypeParagraph {
|
||||||
|
t.Errorf("期望样式类型为 '%s'，实际为 '%s'", StyleTypeParagraph, info.Type)
|
||||||
|
}
|
||||||
|
|
||||||
|
if !info.IsBuiltIn {
|
||||||
|
t.Error("Heading1 应该是内置样式")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试获取不存在的样式信息
|
||||||
|
_, err = api.GetStyleInfo("NonExistentStyle")
|
||||||
|
if err == nil {
|
||||||
|
t.Error("期望获取不存在样式时返回错误")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestGetAllStylesInfo(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
allStyles := api.GetAllStylesInfo()
|
||||||
|
|
||||||
|
if len(allStyles) == 0 {
|
||||||
|
t.Error("期望返回样式信息列表不为空")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查是否包含预期的样式
|
||||||
|
styleFound := false
|
||||||
|
for _, info := range allStyles {
|
||||||
|
if info.ID == "Normal" {
|
||||||
|
styleFound = true
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if !styleFound {
|
||||||
|
t.Error("期望在样式列表中找到 'Normal' 样式")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestGetHeadingStylesInfo(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
headingStyles := api.GetHeadingStylesInfo()
|
||||||
|
|
||||||
|
expectedCount := 9 // Heading1 到 Heading9
|
||||||
|
if len(headingStyles) != expectedCount {
|
||||||
|
t.Errorf("期望标题样式数量为 %d，实际为 %d", expectedCount, len(headingStyles))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查标题样式的顺序和ID
|
||||||
|
for i, info := range headingStyles {
|
||||||
|
expectedID := "Heading" + string(rune('1'+i))
|
||||||
|
if info.ID != expectedID {
|
||||||
|
t.Errorf("期望第 %d 个标题样式ID为 '%s'，实际为 '%s'", i+1, expectedID, info.ID)
|
||||||
|
}
|
||||||
|
|
||||||
|
if info.Type != StyleTypeParagraph {
|
||||||
|
t.Errorf("标题样式 '%s' 应该是段落类型", info.ID)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestGetParagraphStylesInfo(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
paragraphStyles := api.GetParagraphStylesInfo()
|
||||||
|
|
||||||
|
if len(paragraphStyles) == 0 {
|
||||||
|
t.Error("期望段落样式列表不为空")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查所有返回的样式都是段落类型
|
||||||
|
for _, info := range paragraphStyles {
|
||||||
|
if info.Type != StyleTypeParagraph {
|
||||||
|
t.Errorf("样式 '%s' 应该是段落类型，实际为 '%s'", info.ID, info.Type)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestGetCharacterStylesInfo(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
characterStyles := api.GetCharacterStylesInfo()
|
||||||
|
|
||||||
|
if len(characterStyles) == 0 {
|
||||||
|
t.Error("期望字符样式列表不为空")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查所有返回的样式都是字符类型
|
||||||
|
for _, info := range characterStyles {
|
||||||
|
if info.Type != StyleTypeCharacter {
|
||||||
|
t.Errorf("样式 '%s' 应该是字符类型，实际为 '%s'", info.ID, info.Type)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestCreateQuickStyle(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
// 测试创建自定义段落样式
|
||||||
|
config := QuickStyleConfig{
|
||||||
|
ID: "TestCustomStyle",
|
||||||
|
Name: "测试自定义样式",
|
||||||
|
Type: StyleTypeParagraph,
|
||||||
|
BasedOn: "Normal",
|
||||||
|
ParagraphConfig: &QuickParagraphConfig{
|
||||||
|
Alignment: "center",
|
||||||
|
LineSpacing: 1.5,
|
||||||
|
SpaceBefore: 12,
|
||||||
|
SpaceAfter: 6,
|
||||||
|
},
|
||||||
|
RunConfig: &QuickRunConfig{
|
||||||
|
FontName: "微软雅黑",
|
||||||
|
FontSize: 14,
|
||||||
|
FontColor: "FF0000",
|
||||||
|
Bold: true,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
style, err := api.CreateQuickStyle(config)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("创建自定义样式失败: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
if style.StyleID != "TestCustomStyle" {
|
||||||
|
t.Errorf("期望样式ID为 'TestCustomStyle'，实际为 '%s'", style.StyleID)
|
||||||
|
}
|
||||||
|
|
||||||
|
if !style.CustomStyle {
|
||||||
|
t.Error("创建的样式应该标记为自定义样式")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证段落属性
|
||||||
|
if style.ParagraphPr == nil {
|
||||||
|
t.Error("自定义样式应该包含段落属性")
|
||||||
|
} else {
|
||||||
|
if style.ParagraphPr.Justification == nil || style.ParagraphPr.Justification.Val != "center" {
|
||||||
|
t.Error("段落对齐方式设置不正确")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证字符属性
|
||||||
|
if style.RunPr == nil {
|
||||||
|
t.Error("自定义样式应该包含字符属性")
|
||||||
|
} else {
|
||||||
|
if style.RunPr.Bold == nil {
|
||||||
|
t.Error("粗体属性设置不正确")
|
||||||
|
}
|
||||||
|
if style.RunPr.FontSize == nil || style.RunPr.FontSize.Val != "28" {
|
||||||
|
t.Error("字体大小设置不正确")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试创建重复ID的样式
|
||||||
|
_, err = api.CreateQuickStyle(config)
|
||||||
|
if err == nil {
|
||||||
|
t.Error("期望创建重复ID样式时返回错误")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestCreateParagraphProperties(t *testing.T) {
|
||||||
|
config := &QuickParagraphConfig{
|
||||||
|
Alignment: "center",
|
||||||
|
LineSpacing: 1.5,
|
||||||
|
SpaceBefore: 12,
|
||||||
|
SpaceAfter: 6,
|
||||||
|
FirstLineIndent: 24,
|
||||||
|
LeftIndent: 36,
|
||||||
|
RightIndent: 36,
|
||||||
|
}
|
||||||
|
|
||||||
|
props := createParagraphProperties(config)
|
||||||
|
|
||||||
|
if props == nil {
|
||||||
|
t.Fatal("createParagraphProperties 返回了 nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查对齐方式
|
||||||
|
if props.Justification == nil || props.Justification.Val != "center" {
|
||||||
|
t.Error("对齐方式设置不正确")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查间距
|
||||||
|
if props.Spacing == nil {
|
||||||
|
t.Error("间距属性未设置")
|
||||||
|
} else {
|
||||||
|
if props.Spacing.Before != "240" { // 12 * 20
|
||||||
|
t.Errorf("段前间距设置不正确，期望 '240'，实际 '%s'", props.Spacing.Before)
|
||||||
|
}
|
||||||
|
if props.Spacing.After != "120" { // 6 * 20
|
||||||
|
t.Errorf("段后间距设置不正确，期望 '120'，实际 '%s'", props.Spacing.After)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查缩进
|
||||||
|
if props.Indentation == nil {
|
||||||
|
t.Error("缩进属性未设置")
|
||||||
|
} else {
|
||||||
|
if props.Indentation.FirstLine != "480" { // 24 * 20
|
||||||
|
t.Errorf("首行缩进设置不正确，期望 '480'，实际 '%s'", props.Indentation.FirstLine)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestCreateRunProperties(t *testing.T) {
|
||||||
|
config := &QuickRunConfig{
|
||||||
|
FontName: "微软雅黑",
|
||||||
|
FontSize: 14,
|
||||||
|
FontColor: "FF0000",
|
||||||
|
Bold: true,
|
||||||
|
Italic: true,
|
||||||
|
Underline: true,
|
||||||
|
Strike: true,
|
||||||
|
Highlight: "yellow",
|
||||||
|
}
|
||||||
|
|
||||||
|
props := createRunProperties(config)
|
||||||
|
|
||||||
|
if props == nil {
|
||||||
|
t.Fatal("createRunProperties 返回了 nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查字体设置
|
||||||
|
if props.FontFamily == nil {
|
||||||
|
t.Error("字体系列未设置")
|
||||||
|
} else {
|
||||||
|
if props.FontFamily.ASCII != "微软雅黑" {
|
||||||
|
t.Errorf("ASCII字体设置不正确，期望 '微软雅黑'，实际 '%s'", props.FontFamily.ASCII)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if props.FontSize == nil || props.FontSize.Val != "28" { // 14 * 2
|
||||||
|
t.Error("字体大小设置不正确")
|
||||||
|
}
|
||||||
|
|
||||||
|
if props.Color == nil || props.Color.Val != "FF0000" {
|
||||||
|
t.Error("字体颜色设置不正确")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查格式设置
|
||||||
|
if props.Bold == nil {
|
||||||
|
t.Error("粗体设置不正确")
|
||||||
|
}
|
||||||
|
|
||||||
|
if props.Italic == nil {
|
||||||
|
t.Error("斜体设置不正确")
|
||||||
|
}
|
||||||
|
|
||||||
|
if props.Underline == nil || props.Underline.Val != "single" {
|
||||||
|
t.Error("下划线设置不正确")
|
||||||
|
}
|
||||||
|
|
||||||
|
if props.Strike == nil {
|
||||||
|
t.Error("删除线设置不正确")
|
||||||
|
}
|
||||||
|
|
||||||
|
if props.Highlight == nil || props.Highlight.Val != "yellow" {
|
||||||
|
t.Error("高亮设置不正确")
|
||||||
|
}
|
||||||
|
}
|
||||||
179
pkg/style/predefined.go
Normal file
179
pkg/style/predefined.go
Normal file
@@ -0,0 +1,179 @@
|
|||||||
|
// Package style 预定义样式常量
|
||||||
|
package style
|
||||||
|
|
||||||
|
// 预定义样式ID常量
|
||||||
|
const (
|
||||||
|
// StyleNormal 普通文本样式
|
||||||
|
StyleNormal = "Normal"
|
||||||
|
|
||||||
|
// 标题样式
|
||||||
|
StyleHeading1 = "Heading1"
|
||||||
|
StyleHeading2 = "Heading2"
|
||||||
|
StyleHeading3 = "Heading3"
|
||||||
|
StyleHeading4 = "Heading4"
|
||||||
|
StyleHeading5 = "Heading5"
|
||||||
|
StyleHeading6 = "Heading6"
|
||||||
|
StyleHeading7 = "Heading7"
|
||||||
|
StyleHeading8 = "Heading8"
|
||||||
|
StyleHeading9 = "Heading9"
|
||||||
|
|
||||||
|
// 文档标题样式
|
||||||
|
StyleTitle = "Title" // 文档标题
|
||||||
|
StyleSubtitle = "Subtitle" // 副标题
|
||||||
|
|
||||||
|
// 字符样式
|
||||||
|
StyleEmphasis = "Emphasis" // 强调（斜体）
|
||||||
|
StyleStrong = "Strong" // 加粗
|
||||||
|
StyleCodeChar = "CodeChar" // 代码字符
|
||||||
|
|
||||||
|
// 段落样式
|
||||||
|
StyleQuote = "Quote" // 引用样式
|
||||||
|
StyleListParagraph = "ListParagraph" // 列表段落
|
||||||
|
StyleCodeBlock = "CodeBlock" // 代码块
|
||||||
|
)
|
||||||
|
|
||||||
|
// GetPredefinedStyleNames 获取所有预定义样式名称映射
|
||||||
|
func GetPredefinedStyleNames() map[string]string {
|
||||||
|
return map[string]string{
|
||||||
|
StyleNormal: "普通文本",
|
||||||
|
StyleHeading1: "标题 1",
|
||||||
|
StyleHeading2: "标题 2",
|
||||||
|
StyleHeading3: "标题 3",
|
||||||
|
StyleHeading4: "标题 4",
|
||||||
|
StyleHeading5: "标题 5",
|
||||||
|
StyleHeading6: "标题 6",
|
||||||
|
StyleHeading7: "标题 7",
|
||||||
|
StyleHeading8: "标题 8",
|
||||||
|
StyleHeading9: "标题 9",
|
||||||
|
StyleTitle: "文档标题",
|
||||||
|
StyleSubtitle: "副标题",
|
||||||
|
StyleEmphasis: "强调",
|
||||||
|
StyleStrong: "加粗",
|
||||||
|
StyleCodeChar: "代码字符",
|
||||||
|
StyleQuote: "引用",
|
||||||
|
StyleListParagraph: "列表段落",
|
||||||
|
StyleCodeBlock: "代码块",
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// StyleConfig 样式配置帮助结构
|
||||||
|
type StyleConfig struct {
|
||||||
|
StyleID string
|
||||||
|
Name string
|
||||||
|
Description string
|
||||||
|
StyleType StyleType
|
||||||
|
}
|
||||||
|
|
||||||
|
// GetPredefinedStyleConfigs 获取所有预定义样式配置
|
||||||
|
func GetPredefinedStyleConfigs() []StyleConfig {
|
||||||
|
return []StyleConfig{
|
||||||
|
{
|
||||||
|
StyleID: StyleNormal,
|
||||||
|
Name: "普通文本",
|
||||||
|
Description: "默认的段落样式，使用Calibri字体，11磅字号",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading1,
|
||||||
|
Name: "标题 1",
|
||||||
|
Description: "一级标题，16磅蓝色粗体，段前12磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading2,
|
||||||
|
Name: "标题 2",
|
||||||
|
Description: "二级标题，13磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading3,
|
||||||
|
Name: "标题 3",
|
||||||
|
Description: "三级标题，12磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading4,
|
||||||
|
Name: "标题 4",
|
||||||
|
Description: "四级标题，12磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading5,
|
||||||
|
Name: "标题 5",
|
||||||
|
Description: "五级标题，12磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading6,
|
||||||
|
Name: "标题 6",
|
||||||
|
Description: "六级标题，12磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading7,
|
||||||
|
Name: "标题 7",
|
||||||
|
Description: "七级标题，12磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading8,
|
||||||
|
Name: "标题 8",
|
||||||
|
Description: "八级标题，12磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleHeading9,
|
||||||
|
Name: "标题 9",
|
||||||
|
Description: "九级标题，12磅蓝色粗体，段前6磅间距",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleTitle,
|
||||||
|
Name: "文档标题",
|
||||||
|
Description: "文档标题样式",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleSubtitle,
|
||||||
|
Name: "副标题",
|
||||||
|
Description: "副标题样式",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleEmphasis,
|
||||||
|
Name: "强调",
|
||||||
|
Description: "斜体文本样式",
|
||||||
|
StyleType: StyleTypeCharacter,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleStrong,
|
||||||
|
Name: "加粗",
|
||||||
|
Description: "粗体文本样式",
|
||||||
|
StyleType: StyleTypeCharacter,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleCodeChar,
|
||||||
|
Name: "代码字符",
|
||||||
|
Description: "等宽字体，红色文本，适用于代码片段",
|
||||||
|
StyleType: StyleTypeCharacter,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleQuote,
|
||||||
|
Name: "引用",
|
||||||
|
Description: "引用段落样式，斜体灰色，左右各缩进0.5英寸",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleListParagraph,
|
||||||
|
Name: "列表段落",
|
||||||
|
Description: "列表段落样式",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
StyleID: StyleCodeBlock,
|
||||||
|
Name: "代码块",
|
||||||
|
Description: "代码块样式",
|
||||||
|
StyleType: StyleTypeParagraph,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
}
|
||||||
1151
pkg/style/style.go
Normal file
1151
pkg/style/style.go
Normal file
File diff suppressed because it is too large
Load Diff
369
pkg/style/style_test.go
Normal file
369
pkg/style/style_test.go
Normal file
@@ -0,0 +1,369 @@
|
|||||||
|
package style
|
||||||
|
|
||||||
|
import (
|
||||||
|
"testing"
|
||||||
|
)
|
||||||
|
|
||||||
|
// TestNewStyleManager 测试样式管理器创建
|
||||||
|
func TestNewStyleManager(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
if sm == nil {
|
||||||
|
t.Fatal("StyleManager should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证预定义样式是否加载
|
||||||
|
styles := sm.GetAllStyles()
|
||||||
|
if len(styles) == 0 {
|
||||||
|
t.Error("Should have predefined styles loaded")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证基本样式存在
|
||||||
|
expectedStyles := []string{"Normal", "Heading1", "Heading2", "Title", "Subtitle"}
|
||||||
|
for _, styleID := range expectedStyles {
|
||||||
|
if !sm.StyleExists(styleID) {
|
||||||
|
t.Errorf("Style %s should exist", styleID)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestStyleExists 测试样式存在性检查
|
||||||
|
func TestStyleExists(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
// 测试存在的样式
|
||||||
|
if !sm.StyleExists("Normal") {
|
||||||
|
t.Error("Normal style should exist")
|
||||||
|
}
|
||||||
|
|
||||||
|
if !sm.StyleExists("Heading1") {
|
||||||
|
t.Error("Heading1 style should exist")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试不存在的样式
|
||||||
|
if sm.StyleExists("NonExistentStyle") {
|
||||||
|
t.Error("NonExistentStyle should not exist")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestGetStyle 测试获取样式
|
||||||
|
func TestGetStyle(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
// 测试获取存在的样式
|
||||||
|
normalStyle := sm.GetStyle("Normal")
|
||||||
|
if normalStyle == nil {
|
||||||
|
t.Fatal("Normal style should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if normalStyle.StyleID != "Normal" {
|
||||||
|
t.Errorf("Expected StyleID Normal, got %s", normalStyle.StyleID)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试获取不存在的样式
|
||||||
|
nonExistent := sm.GetStyle("NonExistentStyle")
|
||||||
|
if nonExistent != nil {
|
||||||
|
t.Error("NonExistentStyle should return nil")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestGetHeadingStyles 测试获取标题样式
|
||||||
|
func TestGetHeadingStyles(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
headingStyles := sm.GetHeadingStyles()
|
||||||
|
|
||||||
|
// 应该有9个标题样式
|
||||||
|
if len(headingStyles) != 9 {
|
||||||
|
t.Errorf("Expected 9 heading styles, got %d", len(headingStyles))
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证标题样式ID
|
||||||
|
expectedHeadings := []string{"Heading1", "Heading2", "Heading3", "Heading4", "Heading5", "Heading6", "Heading7", "Heading8", "Heading9"}
|
||||||
|
styleMap := make(map[string]bool)
|
||||||
|
for _, style := range headingStyles {
|
||||||
|
styleMap[style.StyleID] = true
|
||||||
|
}
|
||||||
|
|
||||||
|
for _, expected := range expectedHeadings {
|
||||||
|
if !styleMap[expected] {
|
||||||
|
t.Errorf("Heading style %s should be included", expected)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestAddStyle 测试添加自定义样式
|
||||||
|
func TestAddStyle(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
customStyle := &Style{
|
||||||
|
Type: string(StyleTypeParagraph),
|
||||||
|
StyleID: "CustomTest",
|
||||||
|
Name: &StyleName{Val: "测试样式"},
|
||||||
|
RunPr: &RunProperties{
|
||||||
|
Bold: &Bold{},
|
||||||
|
Color: &Color{Val: "FF0000"},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
sm.AddStyle(customStyle)
|
||||||
|
|
||||||
|
// 验证样式添加
|
||||||
|
if !sm.StyleExists("CustomTest") {
|
||||||
|
t.Error("Custom style should exist after adding")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证样式内容
|
||||||
|
retrieved := sm.GetStyle("CustomTest")
|
||||||
|
if retrieved == nil {
|
||||||
|
t.Fatal("Retrieved custom style should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if retrieved.StyleID != "CustomTest" {
|
||||||
|
t.Errorf("Expected StyleID CustomTest, got %s", retrieved.StyleID)
|
||||||
|
}
|
||||||
|
|
||||||
|
if retrieved.Name.Val != "测试样式" {
|
||||||
|
t.Errorf("Expected name 测试样式, got %s", retrieved.Name.Val)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestRemoveStyle 测试移除样式
|
||||||
|
func TestRemoveStyle(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
// 先添加一个测试样式
|
||||||
|
testStyle := &Style{
|
||||||
|
Type: string(StyleTypeParagraph),
|
||||||
|
StyleID: "TestRemove",
|
||||||
|
Name: &StyleName{Val: "待删除样式"},
|
||||||
|
}
|
||||||
|
|
||||||
|
sm.AddStyle(testStyle)
|
||||||
|
|
||||||
|
// 验证样式存在
|
||||||
|
if !sm.StyleExists("TestRemove") {
|
||||||
|
t.Fatal("Test style should exist before removal")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 移除样式
|
||||||
|
sm.RemoveStyle("TestRemove")
|
||||||
|
|
||||||
|
// 验证样式已移除
|
||||||
|
if sm.StyleExists("TestRemove") {
|
||||||
|
t.Error("Test style should not exist after removal")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 尝试移除不存在的样式（不应该报错）
|
||||||
|
sm.RemoveStyle("NonExistentStyle")
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestGetStyleWithInheritance 测试样式继承
|
||||||
|
func TestGetStyleWithInheritance(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
// 获取带继承的Heading1样式
|
||||||
|
heading1 := sm.GetStyleWithInheritance("Heading1")
|
||||||
|
if heading1 == nil {
|
||||||
|
t.Fatal("Heading1 with inheritance should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
// Heading1基于Normal，应该继承Normal的属性
|
||||||
|
if heading1.BasedOn == nil {
|
||||||
|
t.Error("Heading1 should have BasedOn reference")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证继承的属性
|
||||||
|
if heading1.RunPr == nil {
|
||||||
|
t.Error("Heading1 should have run properties")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试不存在的样式
|
||||||
|
nonExistent := sm.GetStyleWithInheritance("NonExistentStyle")
|
||||||
|
if nonExistent != nil {
|
||||||
|
t.Error("Non-existent style with inheritance should return nil")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestQuickStyleAPI 测试快速API功能
|
||||||
|
func TestQuickStyleAPI(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
if api == nil {
|
||||||
|
t.Fatal("QuickStyleAPI should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if api.styleManager != sm {
|
||||||
|
t.Error("QuickStyleAPI should reference the provided StyleManager")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试获取所有样式信息
|
||||||
|
stylesInfo := api.GetAllStylesInfo()
|
||||||
|
if len(stylesInfo) == 0 {
|
||||||
|
t.Error("Should have style information")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证返回的信息结构
|
||||||
|
for _, info := range stylesInfo {
|
||||||
|
if info.ID == "" {
|
||||||
|
t.Error("Style info should have ID")
|
||||||
|
}
|
||||||
|
if info.Name == "" {
|
||||||
|
t.Error("Style info should have Name")
|
||||||
|
}
|
||||||
|
if info.Type == "" {
|
||||||
|
t.Error("Style info should have Type")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestQuickStyleAPI_GetStyleInfo 测试获取单个样式信息
|
||||||
|
func TestQuickStyleAPI_GetStyleInfo(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
// 测试获取存在的样式信息
|
||||||
|
info, err := api.GetStyleInfo("Normal")
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Error getting Normal style info: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
if info.ID != "Normal" {
|
||||||
|
t.Errorf("Expected ID Normal, got %s", info.ID)
|
||||||
|
}
|
||||||
|
|
||||||
|
if info.Name != "Normal" {
|
||||||
|
t.Errorf("Expected name Normal, got %s", info.Name)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试获取不存在的样式信息
|
||||||
|
_, err = api.GetStyleInfo("NonExistentStyle")
|
||||||
|
if err == nil {
|
||||||
|
t.Error("Should return error for non-existent style")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestQuickStyleAPI_CreateStyle 测试快速创建样式
|
||||||
|
func TestQuickStyleAPI_CreateStyle(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
config := QuickStyleConfig{
|
||||||
|
ID: "QuickTest",
|
||||||
|
Name: "快速测试样式",
|
||||||
|
Type: StyleTypeParagraph,
|
||||||
|
BasedOn: "Normal",
|
||||||
|
ParagraphConfig: &QuickParagraphConfig{
|
||||||
|
Alignment: "center",
|
||||||
|
LineSpacing: 1.5,
|
||||||
|
SpaceBefore: 12,
|
||||||
|
SpaceAfter: 6,
|
||||||
|
},
|
||||||
|
RunConfig: &QuickRunConfig{
|
||||||
|
FontName: "宋体",
|
||||||
|
FontSize: 14,
|
||||||
|
FontColor: "FF0000",
|
||||||
|
Bold: true,
|
||||||
|
Italic: false,
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
style, err := api.CreateQuickStyle(config)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("Failed to create quick style: %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证样式创建
|
||||||
|
if style.StyleID != "QuickTest" {
|
||||||
|
t.Errorf("Expected StyleID QuickTest, got %s", style.StyleID)
|
||||||
|
}
|
||||||
|
|
||||||
|
if style.Name.Val != "快速测试样式" {
|
||||||
|
t.Errorf("Expected name 快速测试样式, got %s", style.Name.Val)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证样式添加到管理器
|
||||||
|
if !sm.StyleExists("QuickTest") {
|
||||||
|
t.Error("Quick style should exist in style manager")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证段落属性
|
||||||
|
if style.ParagraphPr == nil {
|
||||||
|
t.Fatal("Paragraph properties should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if style.ParagraphPr.Justification == nil || style.ParagraphPr.Justification.Val != "center" {
|
||||||
|
t.Error("Alignment should be center")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证字符属性
|
||||||
|
if style.RunPr == nil {
|
||||||
|
t.Fatal("Run properties should not be nil")
|
||||||
|
}
|
||||||
|
|
||||||
|
if style.RunPr.Bold == nil {
|
||||||
|
t.Error("Should be bold")
|
||||||
|
}
|
||||||
|
|
||||||
|
if style.RunPr.Color == nil || style.RunPr.Color.Val != "FF0000" {
|
||||||
|
t.Error("Color should be FF0000")
|
||||||
|
}
|
||||||
|
|
||||||
|
if style.RunPr.FontSize == nil || style.RunPr.FontSize.Val != "28" {
|
||||||
|
t.Error("Font size should be 28 (14*2)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestQuickStyleAPI_StylesByType 测试按类型获取样式
|
||||||
|
func TestQuickStyleAPI_StylesByType(t *testing.T) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
api := NewQuickStyleAPI(sm)
|
||||||
|
|
||||||
|
// 测试获取段落样式
|
||||||
|
paragraphStyles := api.GetParagraphStylesInfo()
|
||||||
|
if len(paragraphStyles) == 0 {
|
||||||
|
t.Error("Should have paragraph styles")
|
||||||
|
}
|
||||||
|
|
||||||
|
// 验证所有返回的都是段落样式
|
||||||
|
for _, info := range paragraphStyles {
|
||||||
|
if info.Type != "paragraph" {
|
||||||
|
t.Errorf("Expected paragraph type, got %s", info.Type)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试获取字符样式
|
||||||
|
characterStyles := api.GetCharacterStylesInfo()
|
||||||
|
for _, info := range characterStyles {
|
||||||
|
if info.Type != "character" {
|
||||||
|
t.Errorf("Expected character type, got %s", info.Type)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 测试获取标题样式
|
||||||
|
headingStyles := api.GetHeadingStylesInfo()
|
||||||
|
if len(headingStyles) != 9 {
|
||||||
|
t.Errorf("Expected 9 heading styles, got %d", len(headingStyles))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// BenchmarkStyleLookup 基准测试 - 样式查找性能
|
||||||
|
func BenchmarkStyleLookup(b *testing.B) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
b.ResetTimer()
|
||||||
|
for i := 0; i < b.N; i++ {
|
||||||
|
sm.GetStyle("Heading1")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// BenchmarkStyleWithInheritance 基准测试 - 继承样式性能
|
||||||
|
func BenchmarkStyleWithInheritance(b *testing.B) {
|
||||||
|
sm := NewStyleManager()
|
||||||
|
|
||||||
|
b.ResetTimer()
|
||||||
|
for i := 0; i < b.N; i++ {
|
||||||
|
sm.GetStyleWithInheritance("Heading1")
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user