图表

    下面是 Excelize 支持创建的图表类型 :

    在 Office Excel 中图表数据区域 series 指定了绘制哪些数据的信息集合、图例项(系列)和水平(分类)轴标签。

    下面是 Excelize 中 series 的可选参数:

    参数含义
    name图例项(系列),在图表图例和公式栏中显示。name 参数是可选的,如果不指定该值默认将会使用 Series 1 .. n 表示。name 支持使用公式表示,例如:Sheet1!$A$1
    categories水平(分类)轴标签。在大多数图表类型中,categories 属性是可选的,默认为形如 1..n 的连续序列。
    values图表数据区域,是 series 中最重要的参数,也是创建图表时唯一的必选参数。该选项将图表与其显示的工作表数据链接起来。
    line设置折线图的折线格式。line 属性是可选的,如果未指定该属性,则为默认样式。可以设置的选项是 width,宽度范围是 0.25pt 至 999pt。如果 width 的值超出范围,则线的默认宽度为 2pt。
    marker设置折线图和散点图数据系列线型宽度和线端类型。可选参数 size 指定线型宽度,其取值范围是 2-72 (默认缺省值为 5)。线端类型可选参数 symbol 的枚举值为 (默认缺省值为 auto): circle, dash, diamond, dot, none, picture, plus, square, star, , xauto.

    参数 legend 提供对图例项的属性设置方法,下面是 Excelize 中 legend 的可选参数:

    参数类型含义
    nonebool指定是否关闭不与图表重叠的图例。默认值为 false
    positionstring图例位置
    show_legend_keybool指定是否在数据标签中显示图例项标示

    其中参数 position 默认值为 right,该参数仅在当显示图例(即 none 的值为 false)时生效。下面是该参数的可选值:

    通过可选 title 对象的 name 参数设置图表标题,标题将会在图表上方显示。参数 name 支持使用公式表示,例如 Sheet1!$A$1,图表标题的默认值为空。

    参数 show_blanks_as 提供“隐藏和清空单元格”设置,默认值为:gap 即“空单元格显示为”:“空距”。下面是该参数的可选值:

    含义
    gap空距
    span用直线连接数据点
    zero零值

    通过参数 vary_colors 指定是否设置图表数据系列格式为自动填充颜色,默认值为 true

    参数 format 提供对图表偏移、缩放、高宽比设置和打印属性等参数的设置,其参数与在 函数中所使用的相同。

    通过可选 plotarea 对象设置数据标签格式,可选参数如下:

    参数类型默认值含义
    show_bubble_sizeboolfalse气泡大小
    show_cat_namebooltrue类别名称
    show_leader_linesboolfalse显示引导线
    show_percentboolfalse百分比
    show_series_namebool系列名称
    show_valboolfalse

    下面是 x_axis 参数的可选值:

    下面是 y_axis 参数的可选值:

    参数类型默认值含义
    noneboolfalse隐藏坐标轴
    major_grid_linesboolfalse主要网格线
    minor_grid_linesboolfalse次要网格线
    major_unitfloat640坐标轴主要刻度单位
    reverse_orderboolfalse逆序刻度值
    maximumint0最大值,0 代表自动
    minimumint0最小值,0 代表自动

    通过可选 dimension 对象设置图表的大小,可选参数如下:

    参数类型默认值含义
    heightint290高度
    widthint480宽度

    参数 combo 用来指定创建组合图表,该图表将两个或多个图表类型组合在一个图表中。例如,在 区域创建一个 簇状柱形图 - 折线图:

    根据给定的工作表名称和图表样式属性创建图表工作表,图表样式属性的定义与 函数相同。Excel 中的图表工作表是仅包含图表的工作表。