图表

添加图表

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

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

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

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

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

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

其中参数 position 默认值为 right，该参数仅在当显示图例（即 none 的值为 false）时生效。下面是该参数的可选值：

其中参数 show_legend_key 默认值为 false。

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

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

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

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

通过可选 plotarea 对象设置数据标签格式，可选参数如下：

通过参数 x_axis 和 y_axis 参数设置坐标轴选项。

下面是 x_axis 参数的可选值：

下面是 y_axis 参数的可选值：

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

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

package main
import (
    "fmt"
    "github.com/xuri/excelize/v2"
)
func main() {
    categories := map[string]string{
        "A2": "Small", "A3": "Normal", "A4": "Large",
        "B1": "Apple", "C1": "Orange", "D1": "Pear"}
    values := map[string]int{
        "B2": 2, "C2": 3, "D2": 3, "B3": 5, "C3": 2, "D3": 4, "B4": 6, "C4": 7, "D4": 8}
    f := excelize.NewFile()
    for k, v := range categories {
        f.SetCellValue("Sheet1", k, v)
    }
    for k, v := range values {
        f.SetCellValue("Sheet1", k, v)
    }
    if err := f.AddChart("Sheet1", "E1", `{
        "type": "col",
        "series": [
        {
            "name": "Sheet1!$A$2",
            "categories": "Sheet1!$B$1:$D$1",
            "values": "Sheet1!$B$2:$D$2"
        },
        {
            "name": "Sheet1!$A$3",
            "categories": "Sheet1!$B$1:$D$1",
            "values": "Sheet1!$B$3:$D$3"
        }],
        "format":
        {
            "x_scale": 1.0,
            "y_scale": 1.0,
            "x_offset": 15,
            "y_offset": 10,
            "print_obj": true,
            "lock_aspect_ratio": false,
            "locked": false
        },
        "legend":
        {
            "position": "left",
            "show_legend_key": false
        },
        "title":
        {
            "name": "簇状柱形图 - 折线图"
        },
        "plotarea":
        {
            "show_bubble_size": true,
            "show_cat_name": false,
            "show_leader_lines": false,
            "show_percent": true,
            "show_series_name": true,
            "show_val": true
        }
    }`, `{
        "type": "line",
        "series": [
        {
            "name": "Sheet1!$A$4",
            "categories": "Sheet1!$B$1:$D$1",
            "values": "Sheet1!$B$4:$D$4"
        }],
        "format":
        {
            "x_scale": 1.0,
            "y_scale": 1.0,
            "x_offset": 15,
            "y_offset": 10,
            "print_obj": true,
            "lock_aspect_ratio": false,
            "locked": false
        },
        "legend":
        {
            "position": "right",
            "show_legend_key": false
        },
        "plotarea":
        {
            "show_bubble_size": true,
            "show_cat_name": false,
            "show_leader_lines": false,
            "show_percent": true,
            "show_series_name": true,
            "show_val": true
        }
    }`); err != nil {
        fmt.Println(err)
        return
    }
    // 保存工作簿
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

创建图表工作表

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

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

删除图表

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

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