图表
添加图表
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 | 宽度 |