차트

차트 추가

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

AddChart 는 지정된 차트 형식 집합 (예: 오프셋, 축척, 종횡비 설정 및 인쇄 설정) 및 속성 집합을 사용하여 시트에 차트를 추가하는 방법을 제공합니다.

다음은 excelize 에서 지원하는 차트의 Type 을 보여 주며:

Office Excel 차트 데이터 영역 Series 에서 데이터를 그릴 정보 집합, 범례 항목 (계열) 및 가로 (범주) 축 레이블을 지정합니다.

설정할 수 있는 Series 옵션은 다음과 같습니다:

차트 범례의 속성을 설정합니다. 설정할 수 있는 옵션은 다음과 같습니다:

차트 범례의 Position 을 설정합니다. 기본 범례 위치는 right 입니다. 다음은이 매개 변수의 선택적 값입니다:

범례 키를 설정하는 ShowLegendKey 매개 변수는 데이터 레이블에 표시됩니다. 기본값은 false 입니다.

ChartTitle 데이터 형식의 Title 필드를 사용하여 차트 제목의 속성을 설정할 수 있습니다. 설정 가능한 속성은 다음과 같습니다:

ShowBlanksAs 매개변수는 "셀 숨기기 및 빈 셀" 설정을 제공합니다. 기본값은 gap 입니다. Excel 응용 프로그램에서 "빈 셀은" 로 표시됩니다: "space". 다음은 이 매개 변수에 대한 선택적 값입니다.

Legend 속성을 사용하여 모든 데이터 시리즈의 차트 범례를 설정합니다. Legend 속성은 선택 사항입니다.

버블 차트 또는 3D 버블 차트의 모든 데이터 시리즈에 버블 크기를 'BubbleSizes' 속성으로 설정합니다. BubbleSizes 속성은 선택 사항입니다. 기본 너비는 100 이며 값은 0 보다 크고 300 보다 작거나 같아야 합니다.

HoleSize 속성으로 도넛 차트의 모든 데이터 계열에 있는 도넛 구멍 크기를 설정합니다. HoleSize 속성은 선택사항입니다. 기본 너비는 75 이며 값은 0 보다 크고 90 보다 작거나 같아야 합니다.

계열의 각 데이터 마커는 VaryColors 에 의해 다른 색상을 가지고 있음을 지정합니다. 기본 값은 true 입니다.

매개변수 Format 은 차트 오프셋, 배율, 종횡비 설정 및 인쇄 특성과 AddPicture 함수에 사용되는 매개 변수에 대한 설정을 제공합니다.

ChartPlotArea 데이터 형식의 PlotArea 필드를 사용하여 차트 플롯 영역의 속성을 설정합니다. 설정 가능한 속성은 다음과 같습니다:

기본 수평 및 세로 축 옵션을 XAxis 및 YAxis 으로 설정합니다.

설정할 수있는 XAxis 의 속성은 다음과 같습니다:

설정할 수있는 YAxis 의 속성은 다음과 같습니다:

-90 에서 90 까지 설정할 수 있는 TextRotation 값입니다.

설정할 수 있는 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: "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 에서 차트를 삭제하는 기능을 제공합니다.