Gráfico

Adicionar gráfico

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

AddChart fornece o método para adicionar um gráfico em uma planilha por determinado conjunto de formato de gráfico (como deslocamento, escala, configuração de proporção de aspecto e configurações de impressão) e conjunto de propriedades.

O seguinte mostra o Type de gráfico suportado pelo Excelize:

No intervalo de dados do gráfico do Office Excel, Series especifica o conjunto de informações para os quais os dados serão desenhados, o item da legenda (série) e o rótulo do eixo horizontal (categoria).

As opções de Series que podem ser definidas são:

Defina as propriedades da legenda do gráfico. As opções que podem ser definidas são:

Defina a Position da legenda do gráfico. A posição padrão da legenda é right. Este parâmetro só entra em vigor quando none é false. As vagas disponíveis são:

O parâmetro ShowLegendKey define as chaves de legenda que serão mostradas nos rótulos de dados. O valor padrão é false.

Defina as propriedades do título do gráfico pelo campo Title com o tipo de dados ChartTitle. As propriedades que podem ser definidas são:

O parâmetro ShowBlanksAs fornece a configuração "Ocultar e esvaziar células". O valor padrão é: gap. No aplicativo Excel, "a célula vazia é exibida como": "espaço". A seguir estão os valores opcionais para este parâmetro:

Defina a legenda do gráfico para todas as séries de dados pela propriedade Legend. A propriedade Legend é opcional.

Defina o tamanho da bolha em todas as séries de dados para o gráfico de bolhas ou gráfico de bolhas 3D pela propriedade BubbleSizes. A propriedade BubbleSizes é opcional. A largura padrão é 100 e o valor deve ser maior que 0 e menor ou igual a 300.

Defina o tamanho do furo de rosca em todas as séries de dados para o gráfico de rosca pela propriedade HoleSize. A propriedade HoleSize é opcional. A largura padrão é 75 e o valor deve ser maior que 0 e menor ou igual a 90.

Especifica que cada marcador de dados na série possui uma cor diferente por VaryColors. O valor padrão é true.

O parâmetro Format fornece configurações para parâmetros como deslocamento do gráfico, escala, configurações de proporção e propriedades de impressão, bem como aqueles usados na função AddPicture.

Defina as propriedades da área de plotagem do gráfico pelo campo PlotArea com o tipo de dados ChartPlotArea. As propriedades que podem ser definidas são:

Defina as opções primárias dos eixos horizontal e vertical por XAxis e YAxis.

As propriedades de XAxis que podem ser definidas são:

As propriedades de YAxis que podem ser definidas são:

O valor de TextRotation que pode ser definido de -90 a 90.

Os valores de Vertical que podem ser definidos são: horz, vert, vert270, wordArtVert, eaVert, mongolianVert e wordArtVertRtl.

Defina o tamanho do gráfico pela propriedade Dimension. A propriedade de dimensão é opcional. As propriedades que podem ser definidas são:

O parâmetro combo especifica a criação de um gráfico que combina dois ou mais tipos de gráfico em um único gráfico. Por exemplo, crie um gráfico de linhas e colunas agrupadas com dados Planilha1!$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)
        }
    }()
    if err := f.SetSheetName("Sheet1", "Planilha1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{
        {nil, "Maçã", "Laranja", "Pera"},
        {"Pequeno", 2, 3, 3},
        {"Normal", 5, 2, 4},
        {"Grande", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        if err := f.SetSheetRow("Planilha1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    enable, disable := true, false
    if err := f.AddChart("Planilha1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "Planilha1!$A$2",
                Categories: "Planilha1!$B$1:$D$1",
                Values:     "Planilha1!$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: "Coluna agrupada - gráfico de linhas",
                },
            },
        },
        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:       "Planilha1!$A$4",
                Categories: "Planilha1!$B$1:$D$1",
                Values:     "Planilha1!$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
    }
    // Salve a planilha pelo caminho indicado.
    if err := f.SaveAs("Pasta1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Adicionar planilha de gráfico

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

AddChartSheet fornece o método para criar uma planilha de gráfico por determinado conjunto de formato de gráfico (como deslocamento, escala, configuração de proporção de aspecto e configurações de impressão) e conjunto de propriedades. No Excel, uma planilha de gráfico é uma planilha que contém apenas um gráfico.

Excluir gráfico

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

DeleteChart fornece uma função para excluir gráficos em planilhas por determinado nome de planilha e referência de célula.