グラフ

グラフを追加する

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、つまり「空のセルが空」として表示されている、非表示と空のセル設定を提供します。このパラメーターのオプション値は次のとおりです:

バブル チャートまたは 3D バブル チャートのすべてのデータ系列のバブル サイズを BubbleSizes プロパティで設定します。BubbleSizes プロパティはオプションです。デフォルトの幅は 100 で、値は 0 より大きく、300 以下である必要があります。

HoleSize プロパティでドーナツ チャートのすべてのデータ系列のドーナツ ホール サイズを設定します。HoleSize プロパティはオプションです。デフォルトの幅は 75 で、値は 0 より大きく、90 以下である必要があります。

系列の各データ マーカーの色が VaryColors によって異なっていることを指定します。デフォルト値は true です。

パラメータ Format は、AddPicture 関数で使用されるものと同じパラメータを使用して、チャートオフセット、ズーム、高さ幅比設定、印刷プロパティなどのパラメータの設定を提供します。

次のオプションパラメータを使用して、オプションの PlotArea オブジェクトを使用してデータラベルの形式を設定します:

パラメータ XAxis と YAxis パラメータで軸オプションを設定します。

設定できる XAxis のプロパティは次のとおりです。

設定できる YAxis のプロパティは次のとおりです。

-90 から 90 まで設定できる TextRotation の値。

設定できる Vertical の値は、horz、vert、vert270、wordArtVert、eaVert、mongolianVert、および wordArtVertRtl です。

次のオプションパラメーターを使用して、オプションの Dimension オブジェクトを使用してグラフのサイズを設定します:

パラメータ combo は、2つ以上のチャートタイプを1つのチャートに結合するチャートの作成を指定します。たとえば、クラスター化された列を作成します-データ 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: "2D クラスター縦棒グラフ - 折れ線グラフ",
            },
        },
        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

AddChartSheet は、指定されたグラフ形式セット（オフセット、スケール、アスペクト比の設定、印刷設定など）とプロパティセットによってグラフシートを作成するメソッドを提供します。Excelでは、グラフシートはグラフのみを含むワークシートです。

チャートを削除

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

DeleteChart は、指定されたワークシートとセル名でXLSXのグラフを削除する機能を提供します。