Golang Excelize 2.8.0 发布 - 强大的开源电子表格（Excel）文档处理库

Excelize 2.8.0 的发布确实带来了许多重要的改进和新功能。以下是一些关键变更的示例代码，帮助大家快速了解如何使用部分新特性。

1. 获取和删除表格

新增的 GetTables 和 DeleteTable 函数使得表格操作更加方便。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f, err := excelize.OpenFile("book1.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 获取所有表格
    tables, err := f.GetTables("Sheet1")
    if err != nil {
        fmt.Println(err)
        return
    }
    for _, table := range tables {
        fmt.Println(table)
    }
    // 删除指定表格
    if err := f.DeleteTable("Sheet1", "Table1"); err != nil {
        fmt.Println(err)
    }
}

2. 获取样式定义

GetStyle 函数允许你获取单元格的样式定义。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    styleID, err := f.NewStyle(&excelize.Style{
        Font: &excelize.Font{Color: "1265BE", Bold: true},
    })
    if err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetCellStyle("Sheet1", "A1", "A1", styleID); err != nil {
        fmt.Println(err)
        return
    }
    // 获取样式定义
    style, err := f.GetStyle(styleID)
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Printf("%+v\n", style)
}

3. 新增公式函数

此版本新增了10个公式函数，例如 VALUETOTEXT。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 在单元格中设置公式
    if err := f.SetCellFormula("Sheet1", "A1", "VALUETOTEXT(123)"); err != nil {
        fmt.Println(err)
        return
    }
    // 计算公式
    result, err := f.CalcCellValue("Sheet1", "A1")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println(result) // 输出: 123
}

4. 表单控件支持

新增的 AddFormControl 等函数允许在Excel中添加表单控件。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    if err := f.AddFormControl("Sheet1", excelize.FormControl{
        Cell: "A1",
        Type: excelize.FormControlButton,
        Text: "Click Me",
    }); err != nil {
        fmt.Println(err)
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

5. 带富文本标题的图表

AddChart 现在支持为图表设置格式化和富文本标题。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    for idx, row := range [][]interface{}{
        {"Apple", "Orange"},
        {1, 2},
        {3, 4},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        if err := f.SetSheetRow("Sheet1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
        Type: excelize.Col3DClustered,
        Series: []excelize.ChartSeries{
            {
                Name:       "Sheet1!$A$1",
                Categories: "Sheet1!$A$2:$A$3",
                Values:     "Sheet1!$B$2:$B$3",
            },
        },
        Title: []excelize.RichTextRun{
            {Text: "Sales ", Font: &excelize.Font{Bold: true, Color: "1265BE"}},
            {Text: "Report", Font: &excelize.Font{Italic: true, Color: "CC0000"}},
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

6. 新增形状类型检查

AddShape 函数现在会检查形状类型，如果未指定将返回错误。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 正确的形状添加
    if err := f.AddShape("Sheet1", &excelize.Shape{
        Cell: "A1",
        Type: excelize.ShapeOval,
    }); err != nil {
        fmt.Println(err)
    }
    // 未指定类型将返回错误
    if err := f.AddShape("Sheet1", &excelize.Shape{
        Cell: "B1",
    }); err != nil {
        fmt.Println(err) // 输出错误: shape type is required
    }
}

这些示例展示了Excelize 2.8.0中部分重要新功能的使用方法。更多详细信息和完整API请参考官方文档。