Gráfico

Añadir gráfico

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

AddChart proporciona el método para agregar un gráfico en una hoja de trabajo por un conjunto de formato de gráfico dado (como desplazamiento, escala, configuración de relación de aspecto y configuración de impresión) y conjunto de propiedades.

A continuación se muestra el Type de gráfico compatible con excelize:

En el rango de datos del gráfico de Office Excel, Series especifica el conjunto de información para qué datos dibujar, el elemento de leyenda (serie) y la etiqueta del eje horizontal (categoría).

Las opciones de Series que se pueden configurar son:

Establezca las propiedades de la leyenda del gráfico. Las opciones que se pueden configurar son:

Establece la Position de la leyenda del gráfico. La posición predeterminada de la leyenda es right. Las posiciones disponibles son:

El parámetro ShowLegendKey establece las claves de la leyenda se mostrarán en las etiquetas de datos. El valor predeterminado es false.

El título del gráfico se establece seleccionando el parámetro Name del objeto Title, y el título se mostrará encima del gráfico. El parámetro Name admite el uso de representaciones de fórmulas, como Sheet1!$A$1, si no especifica un título de icono, el valor predeterminado es nulo.

El parámetro ShowBlanksAs proporciona la configuración "Ocultar y vaciar celdas". El valor predeterminado es: gap. En la aplicación Excel, la "celda vacía se muestra como": "espacio". Los siguientes son valores opcionales para este parámetro:

Establezca el tamaño de la burbuja en todas las series de datos para el gráfico de burbujas o el gráfico de burbujas 3D mediante la propiedad BubbleSizes. La propiedad BubbleSizes es opcional. El ancho predeterminado es 100 y el valor debe ser mayor que 0 y menor o igual que 300.

Establezca el tamaño del agujero de anillo en todas las series de datos para el gráfico de anillos mediante la propiedad HoleSize. La propiedad HoleSize es opcional. El ancho predeterminado es 75 y el valor debe ser mayor que 0 y menor o igual que 90.

Especifica que cada marcador de datos de la serie tiene un color diferente por VaryColors. El valor predeterminado es true.

El parámetro Format proporciona ajustes para parámetros como el desplazamiento del gráfico, la escala, la configuración de la relación de aspecto y las propiedades de impresión, así como los que se utilizan en la función AddPicture.

Establezca la posición del área de trazado del gráfico por área de trazado. Las propiedades que se pueden configurar son:

Establezca las opciones principales de eje horizontal y vertical por XAxis y YAxis.

Las propiedades de XAxis que se pueden configurar son:

Las propiedades de YAxis que se pueden configurar son:

Establezca el tamaño del gráfico por la propiedad Dimension. La propiedad de dimensión es opcional. Las propiedades que se pueden configurar son:

El parámetro combo especifica la creación de un gráfico que combine dos o más tipos de gráficos en un solo gráfico. Por ejemplo, cree un gráfico de líneas y columnas agrupadas con los datos 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)
        }
    }()
    if err := f.SetSheetName("Sheet1", "Hoja1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{
        {nil, "Manzana", "Naranja", "Pera"},
        {"Pequeño", 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("Hoja1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    enable, disable := true, false
    if err := f.AddChart("Hoja1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "Hoja1!$A$2",
                Categories: "Hoja1!$B$1:$D$1",
                Values:     "Hoja1!$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: "Columna agrupada - gráfico de líneas",
            },
        },
        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:       "Hoja1!$A$4",
                Categories: "Hoja1!$B$1:$D$1",
                Values:     "Hoja1!$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
    }
    // Guarde la hoja de cálculo por la ruta dada.
    if err := f.SaveAs("Libro1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Añadir hoja de gráficos

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

AddChartSheet proporciona el método para crear una hoja de gráfico por un conjunto de formato de gráfico dado (como desplazamiento, escala, configuración de relación de aspecto y configuración de impresión) y el conjunto de propiedades. En Excel, una hoja de gráfico es una hoja de trabajo que solo contiene un gráfico.

Eliminar gráfico

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

DeleteChart proporciona una función para eliminar gráficos en una hoja de cálculo por la hoja de trabajo y el nombre de celda dados.