圖表

《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。

透過資料類型為 ChartTitle 的 Title 字段設定圖表標題的屬性。可設定的屬性包括：

參數 ShowBlanksAs 提供「隱藏和清空儲存格」設定，默認值為：gap 即「空儲存格顯示為」：「空距」。下面是該參數的可選值：

參數 Legend 用於為所有數據系列設定圖表圖例。該參數是可選的。

參數 BubbleSize 用於設定泡泡圖和立體泡泡圖的泡泡大小。該參數是可選的，其取值範圍是 1-300 (默認缺省值為 100)

參數 HoleSize 用於設定環圈圖的環圈內徑大小。該參數是可選的，其取值範圍是 1-90 (默認缺省值為 75)

透過參數 VaryColors 指定是否設定圖表資料數列格式為自動填滿色彩，默認值為 true。

參數 Format 提供對圖表偏移、縮放、高寬比設定和列印屬性等參數的設定，其參數與在 AddPicture 函式中所使用的相同。

透過資料類型為 ChartPlotArea 的 PlotArea 字段設定圖表繪圖區域的屬性。可設定的屬性包括：

透過參數 XAxis 和 YAxis 參數設定坐標軸選項。

下面是 XAxis 參數的可選值：

下面是 YAxis 參數的可選值：

可選參數 TextRotation 的取值範圍是 -90 至 90。

可選參數 Vertical 的可選值為：horz、vert、vert270、wordArtVert、eaVert、mongolianVert 和 wordArtVertRtl

透過可選 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.ChartTitle{
            Paragraph: []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

根據給定的工作表名稱和儲存格坐標刪除圖表。