图表
添加图表
func (f *File) AddChart(sheet, cell, format string) error
根据给定的工作表名称、单元格坐标和图表样式属性插入图表。
下面是 Excelize 支持创建的图表类型 type
:
名称 | 图表类型 |
---|---|
area | 二维面积图 |
areaStacked | 二维堆积面积图 |
areaPercentStacked | 二维百分比堆积面积图 |
area3D | 三维面积图 |
area3DStacked | 三维堆积面积图 |
area3DPercentStacked | 三维百分比堆积面积图 |
bar | 二维簇状条形图 |
barStacked | 二维堆积条形图 |
barPercentStacked | 二维百分比堆积条形图 |
bar3DClustered | 三维簇状条形图 |
bar3DStacked | 三维堆积条形图 |
bar3DPercentStacked | 三维百分比堆积条形图 |
col | 二维簇状柱形图 |
colStacked | 二维堆积柱形图 |
colPercentStacked | 二维百分比堆积柱形图 |
col3DClustered | 三维簇状柱形图 |
col3D | 三维柱形图 |
col3DStacked | 三维堆积柱形图 |
col3DPercentStacked | 三维百分比堆积柱形图 |
doughnut | 圆环图 |
line | 折线图 |
pie | 饼图 |
pie3D | 三维饼图 |
radar | 雷达图 |
scatter | 散点图 |
在 Office Excel 中图表数据区域 series
指定了绘制哪些数据的信息集合、图例项(系列)和水平(分类)轴标签。
下面是 Excelize 中 series
的可选参数:
参数 | 含义 |
---|---|
name | 图例项(系列),在图表图例和公式栏中显示。name 参数是可选的,如果不指定该值默认将会使用 Series 1 .. n 表示。name 支持使用公式表示,例如:Sheet1!$A$1 。 |
categories | 水平(分类)轴标签。在大多数图表类型中,categories 属性是可选的,默认为形如 1..n 的连续序列。 |
values | 图表数据区域,是 series 中最重要的参数,也是创建图表时唯一的必选参数。该选项将图表与其显示的工作表数据链接起来。 |
参数 legend
提供对图例项的属性设置方法,下面是 Excelize 中 legend
的可选参数:
参数 | 类型 | 含义 |
---|---|---|
position | string | 图例位置 |
show_legend_key | bool | 显示图例,但不与图表重叠 |
其中参数 position
默认值为 right
,下面是可选值:
可选值 | 含义 |
---|---|
top | 靠上 |
bottom | 靠下 |
left | 靠左 |
right | 靠右 |
top_right | 右上 |
其中参数 show_legend_key
默认值为 false
。
通过可选 title
对象的 name
参数设置图表标题,标题将会在图表上方显示。参数 name
支持使用公式表示,例如 Sheet1!$A$1
,如果不指定图标标题默认值为空。
参数 show_blanks_as
提供“隐藏和清空单元格”设置,默认值为: gap
即“空单元格显示为”:“空距”。下面是该参数的可选值:
值 | 含义 |
---|---|
gap | 空距 |
span | 用直线连接数据点 |
zero | 零值 |
参数 format
提供对图表偏移、缩放、高宽比设置和打印属性等参数的设置,其参数与在 AddPicture()
函数中所使用的相同。
通过可选 plotarea
对象设置数据标签格式,可选参数如下:
参数 | 类型 | 默认值 | 含义 |
---|---|---|---|
show_bubble_size | bool | false | 气泡大小 |
show_cat_name | bool | true | 类别名称 |
show_leader_lines | bool | false | 显示引导线 |
show_percent | bool | false | 百分比 |
show_series_name | bool | false | 系列名称 |
show_val | bool | false | 值 |
通过参数 x_axis
和 y_axis
参数设置坐标轴选项。下面是该参数的可选值:
参数 | 类型 | 默认值 | 含义 |
---|---|---|---|
reverse_order | bool | false | 逆序刻度值 |
maximum | int | 0 | 最大值,0 代表自动 |
minimum | int | 0 | 最小值,0 代表自动 |
通过可选 dimension
对象设置图表的大小,可选参数如下:
参数 | 类型 | 默认值 | 含义 |
---|---|---|---|
height | int | 290 | 高度 |
width | int | 480 | 宽度 |