Диаграмма

Добавить диаграмму

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

AddChart предоставляет метод добавления диаграммы на листе с помощью заданного набора формата диаграммы (например, смещение, масштаб, настройка соотношения сторон и параметры печати) и набор свойств.

Ниже показано Type диаграммы, поддерживаемый excelize:

В области данных диаграммы Office Excel Series определяет набор информации, для которой данные рисовать, легенда пункт (серии), и горизонтальной (категория) метки оси.

Параметры Series, которые могут быть установлены:

Задайте свойства легенды диаграммы. Возможные параметры:

Установите Position легенды диаграммы. Положение легенды по умолчанию - right. Доступные позиции:

Задайте свойства заголовка диаграммы с помощью поля Title, имеющего тип данных ChartTitle. Можно задать следующие свойства:

Название диаграммы задается путем выбора параметра Name объекта Title, и заголовок будет отображаться над диаграммой. Параметр Name поддерживает использование представлений формул, таких как Sheet1!$A$1, если вы не укажете заголовок значка, значение по умолчанию равно null.

Параметр ShowBlanksAs предоставляет настройку «Скрыть и пустые ячейки». Значение по умолчанию: gap т.е. «пустая ячейка отображается как»: «пространство». Ниже приведены необязательные значения для этого параметра:

Задайте легенду диаграммы для всех рядов данных с помощью свойства Legend. Свойство Legend необязательно.

Установите размер пузырька во всех рядах данных для пузырьковой диаграммы или трехмерной пузырьковой диаграммы с помощью свойства BubbleSizes. Свойство BubbleSizes является необязательным. Ширина по умолчанию — 100. Это значение должно быть больше 0 и меньше или равно 300.

Установите размер кольцевого отверстия во всех рядах данных кольцевой диаграммы с помощью свойства HoleSize. Свойство HoleSize является необязательным. Ширина по умолчанию — 75, значение должно быть больше 0 и меньше или равно 90.

Указывает, что каждый маркер данных в серии имеет различный цвет на VaryColors. Значение по умолчанию является true.

Параметр Format предоставляет параметры для таких параметров, как смещение графика, масштаб, параметры соотношения сторон и свойства печати, а также те, которые используются в функции AddPicture.

Задайте свойства области построения диаграммы с помощью поля PlotArea с типом данных ChartPlotArea. Можно задать следующие свойства:

Задайте основные параметры горизонтальной и вертикальной оси с помощью 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)
        }
    }()
    if err := f.SetSheetName("Sheet1", "Лист1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{
        {nil, "Яблоко", "Апельсин", "Груша"},
        {"Маленький", 2, 3, 3},
        {"Нормальный", 5, 2, 4},
        {"Большой", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        if err := f.SetSheetRow("Лист1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    enable, disable := true, false
    if err := f.AddChart("Лист1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "Лист1!$A$2",
                Categories: "Лист1!$B$1:$D$1",
                Values:     "Лист1!$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: "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:       "Лист1!$A$4",
                Categories: "Лист1!$B$1:$D$1",
                Values:     "Лист1!$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
    }
    // Сохранить workbook
    if err := f.SaveAs("Книга1.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 по заданному рабочему листу и имени ячейки.