forked from p30928647/excelize
1103 lines
38 KiB
Go
1103 lines
38 KiB
Go
// Copyright 2016 - 2023 The excelize Authors. All rights reserved. Use of
|
|
// this source code is governed by a BSD-style license that can be found in
|
|
// the LICENSE file.
|
|
//
|
|
// Package excelize providing a set of functions that allow you to write to and
|
|
// read from XLAM / XLSM / XLSX / XLTM / XLTX files. Supports reading and
|
|
// writing spreadsheet documents generated by Microsoft Excel™ 2007 and later.
|
|
// Supports complex components by high compatibility, and provided streaming
|
|
// API for generating or reading data from a worksheet with huge amounts of
|
|
// data. This library needs Go version 1.16 or later.
|
|
|
|
package excelize
|
|
|
|
import (
|
|
"encoding/xml"
|
|
"fmt"
|
|
"strconv"
|
|
"strings"
|
|
)
|
|
|
|
// This section defines the currently supported chart types.
|
|
const (
|
|
Area = "area"
|
|
AreaStacked = "areaStacked"
|
|
AreaPercentStacked = "areaPercentStacked"
|
|
Area3D = "area3D"
|
|
Area3DStacked = "area3DStacked"
|
|
Area3DPercentStacked = "area3DPercentStacked"
|
|
Bar = "bar"
|
|
BarStacked = "barStacked"
|
|
BarPercentStacked = "barPercentStacked"
|
|
Bar3DClustered = "bar3DClustered"
|
|
Bar3DStacked = "bar3DStacked"
|
|
Bar3DPercentStacked = "bar3DPercentStacked"
|
|
Bar3DConeClustered = "bar3DConeClustered"
|
|
Bar3DConeStacked = "bar3DConeStacked"
|
|
Bar3DConePercentStacked = "bar3DConePercentStacked"
|
|
Bar3DPyramidClustered = "bar3DPyramidClustered"
|
|
Bar3DPyramidStacked = "bar3DPyramidStacked"
|
|
Bar3DPyramidPercentStacked = "bar3DPyramidPercentStacked"
|
|
Bar3DCylinderClustered = "bar3DCylinderClustered"
|
|
Bar3DCylinderStacked = "bar3DCylinderStacked"
|
|
Bar3DCylinderPercentStacked = "bar3DCylinderPercentStacked"
|
|
Col = "col"
|
|
ColStacked = "colStacked"
|
|
ColPercentStacked = "colPercentStacked"
|
|
Col3D = "col3D"
|
|
Col3DClustered = "col3DClustered"
|
|
Col3DStacked = "col3DStacked"
|
|
Col3DPercentStacked = "col3DPercentStacked"
|
|
Col3DCone = "col3DCone"
|
|
Col3DConeClustered = "col3DConeClustered"
|
|
Col3DConeStacked = "col3DConeStacked"
|
|
Col3DConePercentStacked = "col3DConePercentStacked"
|
|
Col3DPyramid = "col3DPyramid"
|
|
Col3DPyramidClustered = "col3DPyramidClustered"
|
|
Col3DPyramidStacked = "col3DPyramidStacked"
|
|
Col3DPyramidPercentStacked = "col3DPyramidPercentStacked"
|
|
Col3DCylinder = "col3DCylinder"
|
|
Col3DCylinderClustered = "col3DCylinderClustered"
|
|
Col3DCylinderStacked = "col3DCylinderStacked"
|
|
Col3DCylinderPercentStacked = "col3DCylinderPercentStacked"
|
|
Doughnut = "doughnut"
|
|
Line = "line"
|
|
Line3D = "line3D"
|
|
Pie = "pie"
|
|
Pie3D = "pie3D"
|
|
PieOfPieChart = "pieOfPie"
|
|
BarOfPieChart = "barOfPie"
|
|
Radar = "radar"
|
|
Scatter = "scatter"
|
|
Surface3D = "surface3D"
|
|
WireframeSurface3D = "wireframeSurface3D"
|
|
Contour = "contour"
|
|
WireframeContour = "wireframeContour"
|
|
Bubble = "bubble"
|
|
Bubble3D = "bubble3D"
|
|
)
|
|
|
|
// This section defines the default value of chart properties.
|
|
var (
|
|
chartView3DRotX = map[string]int{
|
|
Area: 0,
|
|
AreaStacked: 0,
|
|
AreaPercentStacked: 0,
|
|
Area3D: 15,
|
|
Area3DStacked: 15,
|
|
Area3DPercentStacked: 15,
|
|
Bar: 0,
|
|
BarStacked: 0,
|
|
BarPercentStacked: 0,
|
|
Bar3DClustered: 15,
|
|
Bar3DStacked: 15,
|
|
Bar3DPercentStacked: 15,
|
|
Bar3DConeClustered: 15,
|
|
Bar3DConeStacked: 15,
|
|
Bar3DConePercentStacked: 15,
|
|
Bar3DPyramidClustered: 15,
|
|
Bar3DPyramidStacked: 15,
|
|
Bar3DPyramidPercentStacked: 15,
|
|
Bar3DCylinderClustered: 15,
|
|
Bar3DCylinderStacked: 15,
|
|
Bar3DCylinderPercentStacked: 15,
|
|
Col: 0,
|
|
ColStacked: 0,
|
|
ColPercentStacked: 0,
|
|
Col3D: 15,
|
|
Col3DClustered: 15,
|
|
Col3DStacked: 15,
|
|
Col3DPercentStacked: 15,
|
|
Col3DCone: 15,
|
|
Col3DConeClustered: 15,
|
|
Col3DConeStacked: 15,
|
|
Col3DConePercentStacked: 15,
|
|
Col3DPyramid: 15,
|
|
Col3DPyramidClustered: 15,
|
|
Col3DPyramidStacked: 15,
|
|
Col3DPyramidPercentStacked: 15,
|
|
Col3DCylinder: 15,
|
|
Col3DCylinderClustered: 15,
|
|
Col3DCylinderStacked: 15,
|
|
Col3DCylinderPercentStacked: 15,
|
|
Doughnut: 0,
|
|
Line: 0,
|
|
Line3D: 20,
|
|
Pie: 0,
|
|
Pie3D: 30,
|
|
PieOfPieChart: 0,
|
|
BarOfPieChart: 0,
|
|
Radar: 0,
|
|
Scatter: 0,
|
|
Surface3D: 15,
|
|
WireframeSurface3D: 15,
|
|
Contour: 90,
|
|
WireframeContour: 90,
|
|
}
|
|
chartView3DRotY = map[string]int{
|
|
Area: 0,
|
|
AreaStacked: 0,
|
|
AreaPercentStacked: 0,
|
|
Area3D: 20,
|
|
Area3DStacked: 20,
|
|
Area3DPercentStacked: 20,
|
|
Bar: 0,
|
|
BarStacked: 0,
|
|
BarPercentStacked: 0,
|
|
Bar3DClustered: 20,
|
|
Bar3DStacked: 20,
|
|
Bar3DPercentStacked: 20,
|
|
Bar3DConeClustered: 20,
|
|
Bar3DConeStacked: 20,
|
|
Bar3DConePercentStacked: 20,
|
|
Bar3DPyramidClustered: 20,
|
|
Bar3DPyramidStacked: 20,
|
|
Bar3DPyramidPercentStacked: 20,
|
|
Bar3DCylinderClustered: 20,
|
|
Bar3DCylinderStacked: 20,
|
|
Bar3DCylinderPercentStacked: 20,
|
|
Col: 0,
|
|
ColStacked: 0,
|
|
ColPercentStacked: 0,
|
|
Col3D: 20,
|
|
Col3DClustered: 20,
|
|
Col3DStacked: 20,
|
|
Col3DPercentStacked: 20,
|
|
Col3DCone: 20,
|
|
Col3DConeClustered: 20,
|
|
Col3DConeStacked: 20,
|
|
Col3DConePercentStacked: 20,
|
|
Col3DPyramid: 20,
|
|
Col3DPyramidClustered: 20,
|
|
Col3DPyramidStacked: 20,
|
|
Col3DPyramidPercentStacked: 20,
|
|
Col3DCylinder: 20,
|
|
Col3DCylinderClustered: 20,
|
|
Col3DCylinderStacked: 20,
|
|
Col3DCylinderPercentStacked: 20,
|
|
Doughnut: 0,
|
|
Line: 0,
|
|
Line3D: 15,
|
|
Pie: 0,
|
|
Pie3D: 0,
|
|
PieOfPieChart: 0,
|
|
BarOfPieChart: 0,
|
|
Radar: 0,
|
|
Scatter: 0,
|
|
Surface3D: 20,
|
|
WireframeSurface3D: 20,
|
|
Contour: 0,
|
|
WireframeContour: 0,
|
|
}
|
|
plotAreaChartOverlap = map[string]int{
|
|
BarStacked: 100,
|
|
BarPercentStacked: 100,
|
|
ColStacked: 100,
|
|
ColPercentStacked: 100,
|
|
}
|
|
chartView3DPerspective = map[string]int{
|
|
Line3D: 30,
|
|
Contour: 0,
|
|
WireframeContour: 0,
|
|
}
|
|
chartView3DRAngAx = map[string]int{
|
|
Area: 0,
|
|
AreaStacked: 0,
|
|
AreaPercentStacked: 0,
|
|
Area3D: 1,
|
|
Area3DStacked: 1,
|
|
Area3DPercentStacked: 1,
|
|
Bar: 0,
|
|
BarStacked: 0,
|
|
BarPercentStacked: 0,
|
|
Bar3DClustered: 1,
|
|
Bar3DStacked: 1,
|
|
Bar3DPercentStacked: 1,
|
|
Bar3DConeClustered: 1,
|
|
Bar3DConeStacked: 1,
|
|
Bar3DConePercentStacked: 1,
|
|
Bar3DPyramidClustered: 1,
|
|
Bar3DPyramidStacked: 1,
|
|
Bar3DPyramidPercentStacked: 1,
|
|
Bar3DCylinderClustered: 1,
|
|
Bar3DCylinderStacked: 1,
|
|
Bar3DCylinderPercentStacked: 1,
|
|
Col: 0,
|
|
ColStacked: 0,
|
|
ColPercentStacked: 0,
|
|
Col3D: 1,
|
|
Col3DClustered: 1,
|
|
Col3DStacked: 1,
|
|
Col3DPercentStacked: 1,
|
|
Col3DCone: 1,
|
|
Col3DConeClustered: 1,
|
|
Col3DConeStacked: 1,
|
|
Col3DConePercentStacked: 1,
|
|
Col3DPyramid: 1,
|
|
Col3DPyramidClustered: 1,
|
|
Col3DPyramidStacked: 1,
|
|
Col3DPyramidPercentStacked: 1,
|
|
Col3DCylinder: 1,
|
|
Col3DCylinderClustered: 1,
|
|
Col3DCylinderStacked: 1,
|
|
Col3DCylinderPercentStacked: 1,
|
|
Doughnut: 0,
|
|
Line: 0,
|
|
Line3D: 0,
|
|
Pie: 0,
|
|
Pie3D: 0,
|
|
PieOfPieChart: 0,
|
|
BarOfPieChart: 0,
|
|
Radar: 0,
|
|
Scatter: 0,
|
|
Surface3D: 0,
|
|
WireframeSurface3D: 0,
|
|
Contour: 0,
|
|
Bubble: 0,
|
|
Bubble3D: 0,
|
|
}
|
|
chartLegendPosition = map[string]string{
|
|
"bottom": "b",
|
|
"left": "l",
|
|
"right": "r",
|
|
"top": "t",
|
|
"top_right": "tr",
|
|
}
|
|
chartValAxNumFmtFormatCode = map[string]string{
|
|
Area: "General",
|
|
AreaStacked: "General",
|
|
AreaPercentStacked: "0%",
|
|
Area3D: "General",
|
|
Area3DStacked: "General",
|
|
Area3DPercentStacked: "0%",
|
|
Bar: "General",
|
|
BarStacked: "General",
|
|
BarPercentStacked: "0%",
|
|
Bar3DClustered: "General",
|
|
Bar3DStacked: "General",
|
|
Bar3DPercentStacked: "0%",
|
|
Bar3DConeClustered: "General",
|
|
Bar3DConeStacked: "General",
|
|
Bar3DConePercentStacked: "0%",
|
|
Bar3DPyramidClustered: "General",
|
|
Bar3DPyramidStacked: "General",
|
|
Bar3DPyramidPercentStacked: "0%",
|
|
Bar3DCylinderClustered: "General",
|
|
Bar3DCylinderStacked: "General",
|
|
Bar3DCylinderPercentStacked: "0%",
|
|
Col: "General",
|
|
ColStacked: "General",
|
|
ColPercentStacked: "0%",
|
|
Col3D: "General",
|
|
Col3DClustered: "General",
|
|
Col3DStacked: "General",
|
|
Col3DPercentStacked: "0%",
|
|
Col3DCone: "General",
|
|
Col3DConeClustered: "General",
|
|
Col3DConeStacked: "General",
|
|
Col3DConePercentStacked: "0%",
|
|
Col3DPyramid: "General",
|
|
Col3DPyramidClustered: "General",
|
|
Col3DPyramidStacked: "General",
|
|
Col3DPyramidPercentStacked: "0%",
|
|
Col3DCylinder: "General",
|
|
Col3DCylinderClustered: "General",
|
|
Col3DCylinderStacked: "General",
|
|
Col3DCylinderPercentStacked: "0%",
|
|
Doughnut: "General",
|
|
Line: "General",
|
|
Line3D: "General",
|
|
Pie: "General",
|
|
Pie3D: "General",
|
|
PieOfPieChart: "General",
|
|
BarOfPieChart: "General",
|
|
Radar: "General",
|
|
Scatter: "General",
|
|
Surface3D: "General",
|
|
WireframeSurface3D: "General",
|
|
Contour: "General",
|
|
WireframeContour: "General",
|
|
Bubble: "General",
|
|
Bubble3D: "General",
|
|
}
|
|
chartValAxCrossBetween = map[string]string{
|
|
Area: "midCat",
|
|
AreaStacked: "midCat",
|
|
AreaPercentStacked: "midCat",
|
|
Area3D: "midCat",
|
|
Area3DStacked: "midCat",
|
|
Area3DPercentStacked: "midCat",
|
|
Bar: "between",
|
|
BarStacked: "between",
|
|
BarPercentStacked: "between",
|
|
Bar3DClustered: "between",
|
|
Bar3DStacked: "between",
|
|
Bar3DPercentStacked: "between",
|
|
Bar3DConeClustered: "between",
|
|
Bar3DConeStacked: "between",
|
|
Bar3DConePercentStacked: "between",
|
|
Bar3DPyramidClustered: "between",
|
|
Bar3DPyramidStacked: "between",
|
|
Bar3DPyramidPercentStacked: "between",
|
|
Bar3DCylinderClustered: "between",
|
|
Bar3DCylinderStacked: "between",
|
|
Bar3DCylinderPercentStacked: "between",
|
|
Col: "between",
|
|
ColStacked: "between",
|
|
ColPercentStacked: "between",
|
|
Col3D: "between",
|
|
Col3DClustered: "between",
|
|
Col3DStacked: "between",
|
|
Col3DPercentStacked: "between",
|
|
Col3DCone: "between",
|
|
Col3DConeClustered: "between",
|
|
Col3DConeStacked: "between",
|
|
Col3DConePercentStacked: "between",
|
|
Col3DPyramid: "between",
|
|
Col3DPyramidClustered: "between",
|
|
Col3DPyramidStacked: "between",
|
|
Col3DPyramidPercentStacked: "between",
|
|
Col3DCylinder: "between",
|
|
Col3DCylinderClustered: "between",
|
|
Col3DCylinderStacked: "between",
|
|
Col3DCylinderPercentStacked: "between",
|
|
Doughnut: "between",
|
|
Line: "between",
|
|
Line3D: "between",
|
|
Pie: "between",
|
|
Pie3D: "between",
|
|
PieOfPieChart: "between",
|
|
BarOfPieChart: "between",
|
|
Radar: "between",
|
|
Scatter: "between",
|
|
Surface3D: "midCat",
|
|
WireframeSurface3D: "midCat",
|
|
Contour: "midCat",
|
|
WireframeContour: "midCat",
|
|
Bubble: "midCat",
|
|
Bubble3D: "midCat",
|
|
}
|
|
plotAreaChartGrouping = map[string]string{
|
|
Area: "standard",
|
|
AreaStacked: "stacked",
|
|
AreaPercentStacked: "percentStacked",
|
|
Area3D: "standard",
|
|
Area3DStacked: "stacked",
|
|
Area3DPercentStacked: "percentStacked",
|
|
Bar: "clustered",
|
|
BarStacked: "stacked",
|
|
BarPercentStacked: "percentStacked",
|
|
Bar3DClustered: "clustered",
|
|
Bar3DStacked: "stacked",
|
|
Bar3DPercentStacked: "percentStacked",
|
|
Bar3DConeClustered: "clustered",
|
|
Bar3DConeStacked: "stacked",
|
|
Bar3DConePercentStacked: "percentStacked",
|
|
Bar3DPyramidClustered: "clustered",
|
|
Bar3DPyramidStacked: "stacked",
|
|
Bar3DPyramidPercentStacked: "percentStacked",
|
|
Bar3DCylinderClustered: "clustered",
|
|
Bar3DCylinderStacked: "stacked",
|
|
Bar3DCylinderPercentStacked: "percentStacked",
|
|
Col: "clustered",
|
|
ColStacked: "stacked",
|
|
ColPercentStacked: "percentStacked",
|
|
Col3D: "standard",
|
|
Col3DClustered: "clustered",
|
|
Col3DStacked: "stacked",
|
|
Col3DPercentStacked: "percentStacked",
|
|
Col3DCone: "standard",
|
|
Col3DConeClustered: "clustered",
|
|
Col3DConeStacked: "stacked",
|
|
Col3DConePercentStacked: "percentStacked",
|
|
Col3DPyramid: "standard",
|
|
Col3DPyramidClustered: "clustered",
|
|
Col3DPyramidStacked: "stacked",
|
|
Col3DPyramidPercentStacked: "percentStacked",
|
|
Col3DCylinder: "standard",
|
|
Col3DCylinderClustered: "clustered",
|
|
Col3DCylinderStacked: "stacked",
|
|
Col3DCylinderPercentStacked: "percentStacked",
|
|
Line: "standard",
|
|
Line3D: "standard",
|
|
}
|
|
plotAreaChartBarDir = map[string]string{
|
|
Bar: "bar",
|
|
BarStacked: "bar",
|
|
BarPercentStacked: "bar",
|
|
Bar3DClustered: "bar",
|
|
Bar3DStacked: "bar",
|
|
Bar3DPercentStacked: "bar",
|
|
Bar3DConeClustered: "bar",
|
|
Bar3DConeStacked: "bar",
|
|
Bar3DConePercentStacked: "bar",
|
|
Bar3DPyramidClustered: "bar",
|
|
Bar3DPyramidStacked: "bar",
|
|
Bar3DPyramidPercentStacked: "bar",
|
|
Bar3DCylinderClustered: "bar",
|
|
Bar3DCylinderStacked: "bar",
|
|
Bar3DCylinderPercentStacked: "bar",
|
|
Col: "col",
|
|
ColStacked: "col",
|
|
ColPercentStacked: "col",
|
|
Col3D: "col",
|
|
Col3DClustered: "col",
|
|
Col3DStacked: "col",
|
|
Col3DPercentStacked: "col",
|
|
Col3DCone: "col",
|
|
Col3DConeStacked: "col",
|
|
Col3DConeClustered: "col",
|
|
Col3DConePercentStacked: "col",
|
|
Col3DPyramid: "col",
|
|
Col3DPyramidClustered: "col",
|
|
Col3DPyramidStacked: "col",
|
|
Col3DPyramidPercentStacked: "col",
|
|
Col3DCylinder: "col",
|
|
Col3DCylinderClustered: "col",
|
|
Col3DCylinderStacked: "col",
|
|
Col3DCylinderPercentStacked: "col",
|
|
Line: "standard",
|
|
Line3D: "standard",
|
|
}
|
|
orientation = map[bool]string{
|
|
true: "maxMin",
|
|
false: "minMax",
|
|
}
|
|
catAxPos = map[bool]string{
|
|
true: "t",
|
|
false: "b",
|
|
}
|
|
valAxPos = map[bool]string{
|
|
true: "r",
|
|
false: "l",
|
|
}
|
|
valTickLblPos = map[string]string{
|
|
Contour: "none",
|
|
WireframeContour: "none",
|
|
}
|
|
)
|
|
|
|
// parseChartOptions provides a function to parse the format settings of the
|
|
// chart with default value.
|
|
func parseChartOptions(opts *Chart) (*Chart, error) {
|
|
if opts == nil {
|
|
return nil, ErrParameterInvalid
|
|
}
|
|
if opts.Dimension.Width == 0 {
|
|
opts.Dimension.Width = defaultChartDimensionWidth
|
|
}
|
|
if opts.Dimension.Height == 0 {
|
|
opts.Dimension.Height = defaultChartDimensionHeight
|
|
}
|
|
if opts.Format.PrintObject == nil {
|
|
opts.Format.PrintObject = boolPtr(true)
|
|
}
|
|
if opts.Format.Locked == nil {
|
|
opts.Format.Locked = boolPtr(false)
|
|
}
|
|
if opts.Format.ScaleX == 0 {
|
|
opts.Format.ScaleX = defaultPictureScale
|
|
}
|
|
if opts.Format.ScaleY == 0 {
|
|
opts.Format.ScaleY = defaultPictureScale
|
|
}
|
|
if opts.Legend.Position == "" {
|
|
opts.Legend.Position = defaultChartLegendPosition
|
|
}
|
|
if opts.Title.Name == "" {
|
|
opts.Title.Name = " "
|
|
}
|
|
if opts.VaryColors == nil {
|
|
opts.VaryColors = boolPtr(true)
|
|
}
|
|
if opts.ShowBlanksAs == "" {
|
|
opts.ShowBlanksAs = defaultChartShowBlanksAs
|
|
}
|
|
return opts, nil
|
|
}
|
|
|
|
// AddChart provides the method to add chart in a sheet by given chart format
|
|
// set (such as offset, scale, aspect ratio setting and print settings) and
|
|
// properties set. For example, create 3D clustered column chart with data
|
|
// 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
|
|
// }
|
|
// f.SetSheetRow("Sheet1", cell, &row)
|
|
// }
|
|
// if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
|
|
// Type: "col3DClustered",
|
|
// Series: []excelize.ChartSeries{
|
|
// {
|
|
// Name: "Sheet1!$A$2",
|
|
// Categories: "Sheet1!$B$1:$D$1",
|
|
// Values: "Sheet1!$B$2:$D$2",
|
|
// },
|
|
// {
|
|
// Name: "Sheet1!$A$3",
|
|
// Categories: "Sheet1!$B$1:$D$1",
|
|
// Values: "Sheet1!$B$3:$D$3",
|
|
// },
|
|
// {
|
|
// Name: "Sheet1!$A$4",
|
|
// Categories: "Sheet1!$B$1:$D$1",
|
|
// Values: "Sheet1!$B$4:$D$4",
|
|
// },
|
|
// },
|
|
// Title: excelize.ChartTitle{
|
|
// Name: "Fruit 3D Clustered Column Chart",
|
|
// },
|
|
// Legend: excelize.ChartLegend{
|
|
// ShowLegendKey: false,
|
|
// },
|
|
// PlotArea: excelize.ChartPlotArea{
|
|
// ShowBubbleSize: true,
|
|
// ShowCatName: false,
|
|
// ShowLeaderLines: false,
|
|
// ShowPercent: true,
|
|
// ShowSerName: true,
|
|
// ShowVal: true,
|
|
// },
|
|
// }); err != nil {
|
|
// fmt.Println(err)
|
|
// return
|
|
// }
|
|
// // Save spreadsheet by the given path.
|
|
// if err := f.SaveAs("Book1.xlsx"); err != nil {
|
|
// fmt.Println(err)
|
|
// }
|
|
// }
|
|
//
|
|
// The following shows the type of chart supported by excelize:
|
|
//
|
|
// Type | Chart
|
|
// -----------------------------+------------------------------
|
|
// area | 2D area chart
|
|
// areaStacked | 2D stacked area chart
|
|
// areaPercentStacked | 2D 100% stacked area chart
|
|
// area3D | 3D area chart
|
|
// area3DStacked | 3D stacked area chart
|
|
// area3DPercentStacked | 3D 100% stacked area chart
|
|
// bar | 2D clustered bar chart
|
|
// barStacked | 2D stacked bar chart
|
|
// barPercentStacked | 2D 100% stacked bar chart
|
|
// bar3DClustered | 3D clustered bar chart
|
|
// bar3DStacked | 3D stacked bar chart
|
|
// bar3DPercentStacked | 3D 100% stacked bar chart
|
|
// bar3DConeClustered | 3D cone clustered bar chart
|
|
// bar3DConeStacked | 3D cone stacked bar chart
|
|
// bar3DConePercentStacked | 3D cone percent bar chart
|
|
// bar3DPyramidClustered | 3D pyramid clustered bar chart
|
|
// bar3DPyramidStacked | 3D pyramid stacked bar chart
|
|
// bar3DPyramidPercentStacked | 3D pyramid percent stacked bar chart
|
|
// bar3DCylinderClustered | 3D cylinder clustered bar chart
|
|
// bar3DCylinderStacked | 3D cylinder stacked bar chart
|
|
// bar3DCylinderPercentStacked | 3D cylinder percent stacked bar chart
|
|
// col | 2D clustered column chart
|
|
// colStacked | 2D stacked column chart
|
|
// colPercentStacked | 2D 100% stacked column chart
|
|
// col3DClustered | 3D clustered column chart
|
|
// col3D | 3D column chart
|
|
// col3DStacked | 3D stacked column chart
|
|
// col3DPercentStacked | 3D 100% stacked column chart
|
|
// col3DCone | 3D cone column chart
|
|
// col3DConeClustered | 3D cone clustered column chart
|
|
// col3DConeStacked | 3D cone stacked column chart
|
|
// col3DConePercentStacked | 3D cone percent stacked column chart
|
|
// col3DPyramid | 3D pyramid column chart
|
|
// col3DPyramidClustered | 3D pyramid clustered column chart
|
|
// col3DPyramidStacked | 3D pyramid stacked column chart
|
|
// col3DPyramidPercentStacked | 3D pyramid percent stacked column chart
|
|
// col3DCylinder | 3D cylinder column chart
|
|
// col3DCylinderClustered | 3D cylinder clustered column chart
|
|
// col3DCylinderStacked | 3D cylinder stacked column chart
|
|
// col3DCylinderPercentStacked | 3D cylinder percent stacked column chart
|
|
// doughnut | doughnut chart
|
|
// line | line chart
|
|
// line3D | 3D line chart
|
|
// pie | pie chart
|
|
// pie3D | 3D pie chart
|
|
// pieOfPie | pie of pie chart
|
|
// barOfPie | bar of pie chart
|
|
// radar | radar chart
|
|
// scatter | scatter chart
|
|
// surface3D | 3D surface chart
|
|
// wireframeSurface3D | 3D wireframe surface chart
|
|
// contour | contour chart
|
|
// wireframeContour | wireframe contour chart
|
|
// bubble | bubble chart
|
|
// bubble3D | 3D bubble chart
|
|
//
|
|
// In Excel a chart series is a collection of information that defines which
|
|
// data is plotted such as values, axis labels and formatting.
|
|
//
|
|
// The series options that can be set are:
|
|
//
|
|
// Name
|
|
// Categories
|
|
// Sizes
|
|
// Values
|
|
// Fill
|
|
// Line
|
|
// Marker
|
|
//
|
|
// Name: Set the name for the series. The name is displayed in the chart legend
|
|
// and in the formula bar. The 'Name' property is optional and if it isn't
|
|
// supplied it will default to Series 1..n. The name can also be a formula such
|
|
// as Sheet1!$A$1
|
|
//
|
|
// Categories: This sets the chart category labels. The category is more or less
|
|
// the same as the X axis. In most chart types the 'Categories' property is
|
|
// optional and the chart will just assume a sequential series from 1..n.
|
|
//
|
|
// Sizes: This sets the bubble size in a data series.
|
|
//
|
|
// Values: This is the most important property of a series and is the only
|
|
// mandatory option for every chart object. This option links the chart with
|
|
// the worksheet data that it displays.
|
|
//
|
|
// Fill: This set the format for the data series fill.
|
|
//
|
|
// Line: This sets the line format of the line chart. The 'Line' property is
|
|
// optional and if it isn't supplied it will default style. The options that
|
|
// can be set are width and color. The range of width is 0.25pt - 999pt. If the
|
|
// value of width is outside the range, the default width of the line is 2pt.
|
|
//
|
|
// Marker: This sets the marker of the line chart and scatter chart. The range
|
|
// of optional field 'Size' is 2-72 (default value is 5). The enumeration value
|
|
// of optional field 'Symbol' are (default value is 'auto'):
|
|
//
|
|
// circle
|
|
// dash
|
|
// diamond
|
|
// dot
|
|
// none
|
|
// picture
|
|
// plus
|
|
// square
|
|
// star
|
|
// triangle
|
|
// x
|
|
// auto
|
|
//
|
|
// Set properties of the chart legend. The options that can be set are:
|
|
//
|
|
// Position
|
|
// ShowLegendKey
|
|
//
|
|
// Position: Set the position of the chart legend. The default legend position
|
|
// is bottom. The available positions are:
|
|
//
|
|
// none
|
|
// top
|
|
// bottom
|
|
// left
|
|
// right
|
|
// top_right
|
|
//
|
|
// ShowLegendKey: Set the legend keys shall be shown in data labels. The default
|
|
// value is false.
|
|
//
|
|
// Set properties of the chart title. The properties that can be set are:
|
|
//
|
|
// Title
|
|
//
|
|
// Name: Set the name (title) for the chart. The name is displayed above the
|
|
// chart. The name can also be a formula such as Sheet1!$A$1 or a list with a
|
|
// sheet name. The name property is optional. The default is to have no chart
|
|
// title.
|
|
//
|
|
// Specifies how blank cells are plotted on the chart by 'ShowBlanksAs'. The
|
|
// default value is gap. The options that can be set are:
|
|
//
|
|
// gap
|
|
// span
|
|
// zero
|
|
//
|
|
// gap: Specifies that blank values shall be left as a gap.
|
|
//
|
|
// span: Specifies that blank values shall be spanned with a line.
|
|
//
|
|
// zero: Specifies that blank values shall be treated as zero.
|
|
//
|
|
// Specifies that each data marker in the series has a different color by
|
|
// 'VaryColors'. The default value is true.
|
|
//
|
|
// Set chart offset, scale, aspect ratio setting and print settings by format,
|
|
// same as function 'AddPicture'.
|
|
//
|
|
// Set the position of the chart plot area by PlotArea. The properties that can
|
|
// be set are:
|
|
//
|
|
// SecondPlotValues
|
|
// ShowBubbleSize
|
|
// ShowCatName
|
|
// ShowLeaderLines
|
|
// ShowPercent
|
|
// ShowSerName
|
|
// ShowVal
|
|
//
|
|
// SecondPlotValues: Specifies the values in second plot for the 'pieOfPie' and
|
|
// 'barOfPie' chart.
|
|
//
|
|
// ShowBubbleSize: Specifies the bubble size shall be shown in a data label. The
|
|
// 'ShowBubbleSize' property is optional. The default value is false.
|
|
//
|
|
// ShowCatName: Specifies that the category name shall be shown in the data
|
|
// label. The 'ShowCatName' property is optional. The default value is true.
|
|
//
|
|
// ShowLeaderLines: Specifies leader lines shall be shown for data labels. The
|
|
// 'ShowLeaderLines' property is optional. The default value is false.
|
|
//
|
|
// ShowPercent: Specifies that the percentage shall be shown in a data label.
|
|
// The 'ShowPercent' property is optional. The default value is false.
|
|
//
|
|
// ShowSerName: Specifies that the series name shall be shown in a data label.
|
|
// The 'ShowSerName' property is optional. The default value is false.
|
|
//
|
|
// ShowVal: Specifies that the value shall be shown in a data label.
|
|
// The 'ShowVal' property is optional. The default value is false.
|
|
//
|
|
// Set the primary horizontal and vertical axis options by 'XAxis' and 'YAxis'.
|
|
// The properties of 'XAxis' that can be set are:
|
|
//
|
|
// None
|
|
// MajorGridLines
|
|
// MinorGridLines
|
|
// TickLabelSkip
|
|
// ReverseOrder
|
|
// Maximum
|
|
// Minimum
|
|
// Font
|
|
//
|
|
// The properties of 'YAxis' that can be set are:
|
|
//
|
|
// None
|
|
// MajorGridLines
|
|
// MinorGridLines
|
|
// MajorUnit
|
|
// ReverseOrder
|
|
// Maximum
|
|
// Minimum
|
|
// Font
|
|
//
|
|
// None: Disable axes.
|
|
//
|
|
// MajorGridLines: Specifies major grid lines.
|
|
//
|
|
// MinorGridLines: Specifies minor grid lines.
|
|
//
|
|
// MajorUnit: Specifies the distance between major ticks. Shall contain a
|
|
// positive floating-point number. The MajorUnit property is optional. The
|
|
// default value is auto.
|
|
//
|
|
// TickLabelSkip: Specifies how many tick labels to skip between label that is
|
|
// drawn. The 'TickLabelSkip' property is optional. The default value is auto.
|
|
//
|
|
// ReverseOrder: Specifies that the categories or values on reverse order
|
|
// (orientation of the chart). The ReverseOrder property is optional. The
|
|
// default value is false.
|
|
//
|
|
// Maximum: Specifies that the fixed maximum, 0 is auto. The 'Maximum' property
|
|
// is optional. The default value is auto.
|
|
//
|
|
// Minimum: Specifies that the fixed minimum, 0 is auto. The 'Minimum' property
|
|
// is optional. The default value is auto.
|
|
//
|
|
// Font: Specifies that the font of the horizontal and vertical axis. The
|
|
// properties of font that can be set are:
|
|
//
|
|
// Bold
|
|
// Italic
|
|
// Underline
|
|
// Family
|
|
// Size
|
|
// Strike
|
|
// Color
|
|
// VertAlign
|
|
//
|
|
// Set chart size by 'Dimension' property. The 'Dimension' property is optional.
|
|
// The default width is 480, and height is 290.
|
|
//
|
|
// combo: Specifies the create a chart that combines two or more chart types in
|
|
// a single chart. For example, create a clustered column - line chart with
|
|
// data 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
|
|
// }
|
|
// f.SetSheetRow("Sheet1", cell, &row)
|
|
// }
|
|
// enable, disable := true, false
|
|
// if err := f.AddChart("Sheet1", "E1", &excelize.Chart{
|
|
// Type: "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{
|
|
// Name: "Clustered Column - Line Chart",
|
|
// },
|
|
// Legend: excelize.ChartLegend{
|
|
// Position: "left",
|
|
// ShowLegendKey: false,
|
|
// },
|
|
// PlotArea: excelize.ChartPlotArea{
|
|
// ShowCatName: false,
|
|
// ShowLeaderLines: false,
|
|
// ShowPercent: true,
|
|
// ShowSerName: true,
|
|
// ShowVal: true,
|
|
// },
|
|
// }, &excelize.Chart{
|
|
// Type: "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",
|
|
// ShowLegendKey: false,
|
|
// },
|
|
// PlotArea: excelize.ChartPlotArea{
|
|
// ShowCatName: false,
|
|
// ShowLeaderLines: false,
|
|
// ShowPercent: true,
|
|
// ShowSerName: true,
|
|
// ShowVal: true,
|
|
// },
|
|
// }); err != nil {
|
|
// fmt.Println(err)
|
|
// return
|
|
// }
|
|
// // Save spreadsheet by the given path.
|
|
// if err := f.SaveAs("Book1.xlsx"); err != nil {
|
|
// fmt.Println(err)
|
|
// }
|
|
// }
|
|
func (f *File) AddChart(sheet, cell string, chart *Chart, combo ...*Chart) error {
|
|
// Read worksheet data
|
|
ws, err := f.workSheetReader(sheet)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
opts, comboCharts, err := f.getChartOptions(chart, combo)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
// Add first picture for given sheet, create xl/drawings/ and xl/drawings/_rels/ folder.
|
|
drawingID := f.countDrawings() + 1
|
|
chartID := f.countCharts() + 1
|
|
drawingXML := "xl/drawings/drawing" + strconv.Itoa(drawingID) + ".xml"
|
|
drawingID, drawingXML = f.prepareDrawing(ws, drawingID, sheet, drawingXML)
|
|
drawingRels := "xl/drawings/_rels/drawing" + strconv.Itoa(drawingID) + ".xml.rels"
|
|
drawingRID := f.addRels(drawingRels, SourceRelationshipChart, "../charts/chart"+strconv.Itoa(chartID)+".xml", "")
|
|
err = f.addDrawingChart(sheet, drawingXML, cell, int(opts.Dimension.Width), int(opts.Dimension.Height), drawingRID, &opts.Format)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
f.addChart(opts, comboCharts)
|
|
if err = f.addContentTypePart(chartID, "chart"); err != nil {
|
|
return err
|
|
}
|
|
_ = f.addContentTypePart(drawingID, "drawings")
|
|
f.addSheetNameSpace(sheet, SourceRelationship)
|
|
return err
|
|
}
|
|
|
|
// AddChartSheet provides the method to create a chartsheet by given chart
|
|
// format set (such as offset, scale, aspect ratio setting and print settings)
|
|
// and properties set. In Excel a chartsheet is a worksheet that only contains
|
|
// a chart.
|
|
func (f *File) AddChartSheet(sheet string, chart *Chart, combo ...*Chart) error {
|
|
// Check if the worksheet already exists
|
|
idx, err := f.GetSheetIndex(sheet)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if idx != -1 {
|
|
return ErrExistsSheet
|
|
}
|
|
opts, comboCharts, err := f.getChartOptions(chart, combo)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
cs := xlsxChartsheet{
|
|
SheetViews: &xlsxChartsheetViews{
|
|
SheetView: []*xlsxChartsheetView{{ZoomScaleAttr: 100, ZoomToFitAttr: true}},
|
|
},
|
|
}
|
|
f.SheetCount++
|
|
wb, _ := f.workbookReader()
|
|
sheetID := 0
|
|
for _, v := range wb.Sheets.Sheet {
|
|
if v.SheetID > sheetID {
|
|
sheetID = v.SheetID
|
|
}
|
|
}
|
|
sheetID++
|
|
path := "xl/chartsheets/sheet" + strconv.Itoa(sheetID) + ".xml"
|
|
f.sheetMap[sheet] = path
|
|
f.Sheet.Store(path, nil)
|
|
drawingID := f.countDrawings() + 1
|
|
chartID := f.countCharts() + 1
|
|
drawingXML := "xl/drawings/drawing" + strconv.Itoa(drawingID) + ".xml"
|
|
f.prepareChartSheetDrawing(&cs, drawingID, sheet)
|
|
drawingRels := "xl/drawings/_rels/drawing" + strconv.Itoa(drawingID) + ".xml.rels"
|
|
drawingRID := f.addRels(drawingRels, SourceRelationshipChart, "../charts/chart"+strconv.Itoa(chartID)+".xml", "")
|
|
if err = f.addSheetDrawingChart(drawingXML, drawingRID, &opts.Format); err != nil {
|
|
return err
|
|
}
|
|
f.addChart(opts, comboCharts)
|
|
if err = f.addContentTypePart(chartID, "chart"); err != nil {
|
|
return err
|
|
}
|
|
_ = f.addContentTypePart(sheetID, "chartsheet")
|
|
_ = f.addContentTypePart(drawingID, "drawings")
|
|
// Update workbook.xml.rels
|
|
rID := f.addRels(f.getWorkbookRelsPath(), SourceRelationshipChartsheet, fmt.Sprintf("/xl/chartsheets/sheet%d.xml", sheetID), "")
|
|
// Update workbook.xml
|
|
f.setWorkbook(sheet, sheetID, rID)
|
|
chartsheet, _ := xml.Marshal(cs)
|
|
f.addSheetNameSpace(sheet, NameSpaceSpreadSheet)
|
|
f.saveFileList(path, replaceRelationshipsBytes(f.replaceNameSpaceBytes(path, chartsheet)))
|
|
return err
|
|
}
|
|
|
|
// getChartOptions provides a function to check format set of the chart and
|
|
// create chart format.
|
|
func (f *File) getChartOptions(opts *Chart, combo []*Chart) (*Chart, []*Chart, error) {
|
|
var comboCharts []*Chart
|
|
options, err := parseChartOptions(opts)
|
|
if err != nil {
|
|
return options, comboCharts, err
|
|
}
|
|
for _, comboFormat := range combo {
|
|
comboChart, err := parseChartOptions(comboFormat)
|
|
if err != nil {
|
|
return options, comboCharts, err
|
|
}
|
|
if _, ok := chartValAxNumFmtFormatCode[comboChart.Type]; !ok {
|
|
return options, comboCharts, newUnsupportedChartType(comboChart.Type)
|
|
}
|
|
comboCharts = append(comboCharts, comboChart)
|
|
}
|
|
if _, ok := chartValAxNumFmtFormatCode[options.Type]; !ok {
|
|
return options, comboCharts, newUnsupportedChartType(options.Type)
|
|
}
|
|
return options, comboCharts, err
|
|
}
|
|
|
|
// DeleteChart provides a function to delete chart in spreadsheet by given
|
|
// worksheet name and cell reference.
|
|
func (f *File) DeleteChart(sheet, cell string) error {
|
|
col, row, err := CellNameToCoordinates(cell)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
col--
|
|
row--
|
|
ws, err := f.workSheetReader(sheet)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if ws.Drawing == nil {
|
|
return err
|
|
}
|
|
drawingXML := strings.ReplaceAll(f.getSheetRelationshipsTargetByID(sheet, ws.Drawing.RID), "..", "xl")
|
|
return f.deleteDrawing(col, row, drawingXML, "Chart")
|
|
}
|
|
|
|
// countCharts provides a function to get chart files count storage in the
|
|
// folder xl/charts.
|
|
func (f *File) countCharts() int {
|
|
count := 0
|
|
f.Pkg.Range(func(k, v interface{}) bool {
|
|
if strings.Contains(k.(string), "xl/charts/chart") {
|
|
count++
|
|
}
|
|
return true
|
|
})
|
|
return count
|
|
}
|
|
|
|
// ptToEMUs provides a function to convert pt to EMUs, 1 pt = 12700 EMUs. The
|
|
// range of pt is 0.25pt - 999pt. If the value of pt is outside the range, the
|
|
// default EMUs will be returned.
|
|
func (f *File) ptToEMUs(pt float64) int {
|
|
if 0.25 > pt || pt > 999 {
|
|
return 25400
|
|
}
|
|
return int(12700 * pt)
|
|
}
|