WordZero provides a comprehensive style system that allows you to create professional-looking documents with consistent formatting. This chapter covers predefined styles, custom styles, and style management.

🎨 Predefined Styles

WordZero includes 18 built-in styles that are compatible with Microsoft Word:

Heading Styles

style.StyleHeading1 through style.StyleHeading9
Compatible with Word's navigation pane
Automatic table of contents generation

Document Styles

style.StyleTitle - Document title
style.StyleSubtitle - Document subtitle
style.StyleNormal - Default body text

Specialized Styles

style.StyleQuote - Block quotes
style.StyleCodeBlock - Code blocks
style.StyleCodeChar - Inline code
style.StyleListParagraph - List items
style.StyleEmphasis - Emphasized text
style.StyleStrong - Strong text

📝 Using Predefined Styles

Basic Style Application

import (
    "github.com/ZeroHawkeye/wordZero/pkg/document"
    "github.com/ZeroHawkeye/wordZero/pkg/style"
)

doc := document.New()

// Apply title style
title := doc.AddParagraph("Document Title")
title.SetStyle(style.StyleTitle)

// Apply heading styles
h1 := doc.AddParagraph("Chapter 1")
h1.SetStyle(style.StyleHeading1)

h2 := doc.AddParagraph("Section 1.1")
h2.SetStyle(style.StyleHeading2)

// Apply body text style
body := doc.AddParagraph("This is normal body text.")
body.SetStyle(style.StyleNormal)

Complete Style Example

package main

import (
    "fmt"
    "log"
    
    "github.com/ZeroHawkeye/wordZero/pkg/document"
    "github.com/ZeroHawkeye/wordZero/pkg/style"
)

func main() {
    doc := document.New()
    
    // Document title and subtitle
    title := doc.AddParagraph("WordZero Style System Guide")
    title.SetStyle(style.StyleTitle)
    
    subtitle := doc.AddParagraph("Comprehensive Style Management")
    subtitle.SetStyle(style.StyleSubtitle)
    
    // Heading hierarchy
    h1 := doc.AddParagraph("1. Introduction")
    h1.SetStyle(style.StyleHeading1)
    
    h2 := doc.AddParagraph("1.1 What are Styles?")
    h2.SetStyle(style.StyleHeading2)
    
    h3 := doc.AddParagraph("1.1.1 Style Benefits")
    h3.SetStyle(style.StyleHeading3)
    
    // Body content
    para1 := doc.AddParagraph("Styles provide consistent formatting throughout your document and enable features like automatic table of contents generation.")
    para1.SetStyle(style.StyleNormal)
    
    // Quote
    quote := doc.AddParagraph("Consistency is key to professional document presentation.")
    quote.SetStyle(style.StyleQuote)
    
    // Code example
    codeTitle := doc.AddParagraph("1.2 Code Example")
    codeTitle.SetStyle(style.StyleHeading2)
    
    code := doc.AddParagraph(`// Apply style to paragraph
para := doc.AddParagraph("Hello World")
para.SetStyle(style.StyleNormal)`)
    code.SetStyle(style.StyleCodeBlock)
    
    // List
    listTitle := doc.AddParagraph("1.3 Available Styles")
    listTitle.SetStyle(style.StyleHeading2)
    
    items := []string{
        "Title and Subtitle styles",
        "Heading styles (1-9 levels)",
        "Body text styles",
        "Code and quote styles",
    }
    
    for _, item := range items {
        listItem := doc.AddParagraph("• " + item)
        listItem.SetStyle(style.StyleListParagraph)
    }
    
    err := doc.Save("style_guide.docx")
    if err != nil {
        log.Fatalf("Failed to save: %v", err)
    }
    
    fmt.Println("Style guide created successfully!")
}

🔧 Custom Styles

Creating Custom Styles

// Create a custom style
customStyle := &style.Style{
    Name: "CustomHeading",
    Type: style.TypeParagraph,
    FontName: "Arial",
    FontSize: 16,
    Bold: true,
    FontColor: "336699",
    Alignment: style.AlignmentCenter,
}

// Register the style
doc.RegisterStyle(customStyle)

// Use the custom style
heading := doc.AddParagraph("Custom Styled Heading")
heading.SetCustomStyle("CustomHeading")

Style Properties

// Complete custom style definition
customStyle := &style.Style{
    Name:           "MyStyle",
    Type:           style.TypeParagraph,
    FontName:       "Times New Roman",
    FontSize:       12,
    Bold:           true,
    Italic:         false,
    Underline:      false,
    FontColor:      "000000",
    Alignment:      style.AlignmentLeft,
    LineSpacing:    1.5,
    SpaceBefore:    6,
    SpaceAfter:     6,
    FirstLineIndent: 0,
    LeftIndent:     0,
    RightIndent:    0,
}

📊 Style Management

Querying Styles

// Get all available styles
allStyles := doc.GetAllStyles()

// Get styles by type
headingStyles := doc.GetStylesByType(style.TypeHeading)
paragraphStyles := doc.GetStylesByType(style.TypeParagraph)

// Check if style exists
if doc.HasStyle("CustomStyle") {
    // Style exists
}

Style Validation

// Validate style before use
if err := style.ValidateStyle(customStyle); err != nil {
    log.Printf("Invalid style: %v", err)
    return
}

// Apply validated style
para.SetCustomStyle(customStyle.Name)

🎯 Style Best Practices

1. Consistent Hierarchy

// Use heading styles in order
doc.AddParagraph("Chapter").SetStyle(style.StyleHeading1)
doc.AddParagraph("Section").SetStyle(style.StyleHeading2)
doc.AddParagraph("Subsection").SetStyle(style.StyleHeading3)
// Don't skip levels (H1 → H3 without H2)

2. Semantic Styling

// Use styles based on content meaning, not appearance
doc.AddParagraph("Code Example").SetStyle(style.StyleHeading2)
doc.AddParagraph("if err != nil { return }").SetStyle(style.StyleCodeBlock)
doc.AddParagraph("Important note").SetStyle(style.StyleQuote)

3. Style Reuse

// Define styles once, use multiple times
emphasisStyle := &style.Style{
    Name: "Emphasis",
    Type: style.TypeCharacter,
    Bold: true,
    FontColor: "CC0000",
}

doc.RegisterStyle(emphasisStyle)

// Reuse throughout document
para1.SetCustomStyle("Emphasis")
para2.SetCustomStyle("Emphasis")

🔍 Style Inheritance

WordZero supports style inheritance for consistency:

// Base style
baseStyle := &style.Style{
    Name:     "BaseHeading",
    FontName: "Arial",
    Bold:     true,
}

// Derived style inherits base properties
derivedStyle := &style.Style{
    Name:        "SpecialHeading",
    BasedOn:     "BaseHeading",
    FontColor:   "336699",
    FontSize:    18,
}

doc.RegisterStyle(baseStyle)
doc.RegisterStyle(derivedStyle)

📋 Complete Style Example

Here's a comprehensive example using various styles:

package main

import (
    "fmt"
    "log"
    
    "github.com/ZeroHawkeye/wordZero/pkg/document"
    "github.com/ZeroHawkeye/wordZero/pkg/style"
)

func createStyledDocument() error {
    doc := document.New()
    
    // Create custom styles
    warningStyle := &style.Style{
        Name:      "Warning",
        Type:      style.TypeParagraph,
        Bold:      true,
        FontColor: "CC0000",
        FontSize:  12,
    }
    
    highlightStyle := &style.Style{
        Name:           "Highlight",
        Type:           style.TypeParagraph,
        FontColor:      "FFFFFF",
        BackgroundColor: "336699",
        FontSize:       11,
    }
    
    // Register custom styles
    doc.RegisterStyle(warningStyle)
    doc.RegisterStyle(highlightStyle)
    
    // Document structure
    title := doc.AddParagraph("Style System Demonstration")
    title.SetStyle(style.StyleTitle)
    
    // Section 1
    section1 := doc.AddParagraph("1. Predefined Styles")
    section1.SetStyle(style.StyleHeading1)
    
    normal := doc.AddParagraph("This paragraph uses the normal style.")
    normal.SetStyle(style.StyleNormal)
    
    quote := doc.AddParagraph("This is a quote demonstrating the quote style.")
    quote.SetStyle(style.StyleQuote)
    
    // Section 2
    section2 := doc.AddParagraph("2. Custom Styles")
    section2.SetStyle(style.StyleHeading1)
    
    warning := doc.AddParagraph("⚠️ This is a warning using custom styling!")
    warning.SetCustomStyle("Warning")
    
    highlight := doc.AddParagraph("This text is highlighted with custom background.")
    highlight.SetCustomStyle("Highlight")
    
    // Section 3 - Code example
    section3 := doc.AddParagraph("3. Code Examples")
    section3.SetStyle(style.StyleHeading1)
    
    codeBlock := doc.AddParagraph(`func main() {
    doc := document.New()
    para := doc.AddParagraph("Hello")
    para.SetStyle(style.StyleNormal)
}`)
    codeBlock.SetStyle(style.StyleCodeBlock)
    
    return doc.Save("styled_document.docx")
}

func main() {
    if err := createStyledDocument(); err != nil {
        log.Fatalf("Error: %v", err)
    }
    fmt.Println("Styled document created successfully!")
}

💡 Tips and Tricks

1. Style Naming

Use descriptive names: "WarningText" instead of "RedBold"
Follow consistent naming conventions
Use semantic names based on content purpose

2. Performance

Register custom styles once at document creation
Reuse styles rather than creating similar ones
Use predefined styles when possible

3. Compatibility

Test custom styles in Microsoft Word
Use standard fonts for better compatibility
Keep style definitions simple for best results

Next Steps

Continue learning about specific formatting features:

Text Formatting - Detailed text formatting
Table Operations - Table styling
Page Settings - Document layout

Master the style system to create professional, consistent documents!

📚 WordZero 文档

English Docs | 中文文档

🇨🇳 中文文档

🚀 开始使用

📖 核心功能

🔧 高级特性

📋 参考资料

📊 详细文档

🇺🇸 English Docs

🚀 Getting Started

📖 Core Features

🔧 Advanced Features

📋 Reference

📊 Detailed Docs

🔗 外部链接

WordZero - 简单、强大的 Go 语言 Word 文档操作库 🏠 首页 | 📖 文档 | 🚀 API | 💡 示例 | 🐛 Issues 📝 最后更新：2025年6月 | 🔧 版本：v1.0.0 | ⭐ Star on GitHub