图表

《Excelize 权威指南》图书出版，网上购买方式：人民邮电出版社 |异步社区 |天猫 |京东 |当当 |微店 |抖音 |拼多多

添加图表

func (f *File) AddChart(sheet, cell string, chart *ChartOptions, combo ...*ChartOptions) error

根据给定的工作表名称、单元格坐标和图表样式属性插入图表。

下面是 Excelize 支持创建的图表类型 Type：

在 Office Excel 中图表数据区域 Series 指定了绘制哪些数据的信息集合、图例项（系列）和水平（分类）轴标签。

下面是 Excelize 中 Series 的可选参数：

参数 Legend 提供对图例项的属性设置方法，下面是 Excelize 中 Legend 的可选参数：

其中参数 Position 默认值为 right。下面是该参数的可选值：

其中参数 ShowLegendKey 默认值为 false。

通过可选 Title 对象的 Name 参数设置图表标题，标题将会在图表上方显示。参数 Name 支持使用公式表示，例如 Sheet1!$A$1，图表标题的默认值为空。

参数 ShowBlanksAs 提供“隐藏和清空单元格”设置，默认值为：gap 即“空单元格显示为”：“空距”。下面是该参数的可选值：

参数 BubbleSize 用于设置气泡图和三维气泡图的气泡大小。该参数是可选的，其取值范围是 1-300 (默认缺省值为 100)

参数 HoleSize 用于设置圆环图的圆环内径大小。该参数是可选的，其取值范围是 1-90 (默认缺省值为 75)

参数 VaryColors 用于指定是否设置图表数据系列格式为自动填充颜色，默认值为 true。

参数 Format 提供对图表偏移、缩放、高宽比设置和打印属性等参数的设置，其参数与在 AddPicture 函数中所使用的相同。

通过可选 PlotArea 对象设置绘图区域格式，可选参数如下：

通过参数 XAxis 和 YAxis 参数设置坐标轴选项。

下面是 XAxis 参数的可选值：

下面是 YAxis 参数的可选值：

通过可选 Dimension 对象设置图表的大小，可选参数如下：

参数 combo 用来指定创建组合图表，该图表将两个或多个图表类型组合在一个图表中。例如，在 Sheet1!$E$1:$L$15 区域创建一个 簇状柱形图 - 折线图：

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{}{
        {nil, "Apple", "Orange", "Pear"},
        {"Small", 2, 3, 3},
        {"Normal", 5, 2, 4},
        {"Large", 6, 7, 8},
    } {
        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
        }
    }
    enable, disable := true, false
    if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "Sheet1!$A$2",
                Categories: "Sheet1!$B$1:$D$1",
                Values:     "Sheet1!$B$2:$D$2",
            },
        },
        Format: excelize.GraphicOptions{
            ScaleX:          1,
            ScaleY:          1,
            OffsetX:         15,
            OffsetY:         10,
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
        },
        Title: []excelize.RichTextRun{
            {
                Text: "簇状柱形图 - 折线图",
            },
        },
        Legend: excelize.ChartLegend{
            Position: "left",
        },
        PlotArea: excelize.ChartPlotArea{
            ShowCatName:     false,
            ShowLeaderLines: false,
            ShowPercent:     true,
            ShowSerName:     true,
            ShowVal:         true,
        },
    }, &excelize.Chart{
        Type: excelize.Line,
        Series: []excelize.ChartSeries{
            {
                Name:       "Sheet1!$A$4",
                Categories: "Sheet1!$B$1:$D$1",
                Values:     "Sheet1!$B$4:$D$4",
                Marker: excelize.ChartMarker{
                    Symbol: "none", Size: 10,
                },
            },
        },
        Format: excelize.GraphicOptions{
            ScaleX:          1,
            ScaleY:          1,
            OffsetX:         15,
            OffsetY:         10,
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
        },
        Legend: excelize.ChartLegend{
            Position: "right",
        },
        PlotArea: excelize.ChartPlotArea{
            ShowCatName:     false,
            ShowLeaderLines: false,
            ShowPercent:     true,
            ShowSerName:     true,
            ShowVal:         true,
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    // 保存工作簿
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

创建图表工作表

func (f *File) AddChartSheet(sheet string, chart *ChartOptions, combo ...*ChartOptions) error

根据给定的工作表名称和图表样式属性创建图表工作表，图表样式属性的定义与 AddChart 函数相同。Excel 中的图表工作表是仅包含图表的工作表。

删除图表

func (f *File) DeleteChart(sheet, cell string) error

根据给定的工作表名称和单元格坐标删除图表。