通用配置
xyAxis:平面直角坐标系中的 x、y 轴。(Line、Bar、Scatter、EffectScatter、Kline)
dataZoom:dataZoom 组件 用于区域缩放,从而能自由关注细节的数据信息,或者概览数据整体,或者去除离群点的影响。(Line、Bar、Scatter、EffectScatter、Kline、Boxplot)
legend:图例组件。图例组件展现了不同系列的标记(symbol),颜色和名字。可以通过点击图例控制哪些系列不显示。
label:图形上的文本标签,可用于说明图形的一些数据信息,比如值,名称等。
lineStyle:带线图形的线的风格选项(Line、Polar、Radar、Graph、Parallel)
grid3D:3D笛卡尔坐标系组配置项,适用于 3D 图形。(Bar3D, Line3D, Scatter3D, Surface3D)
axis3D:3D 笛卡尔坐标系 X,Y,Z 轴配置项,适用于 3D 图形。(Bar3D, Line3D, Scatter3D, Surface3D)
visualMap:是视觉映射组件,用于进行『视觉编码』,也就是将数据映射到视觉元素(视觉通道)
markLine-markPoint:图形标记组件,用于标记指定的特殊数据,有标记线和标记点两种。(Bar、Line、Kline)
tooltip:提示框组件,用于移动或点击鼠标时弹出数据内容
toolbox:右侧实用工具箱
图形初始化
图表类初始化接受的参数(适用于所有图标类型)
def __init__(
self,
title,
subtitle,
width=800,
height=400,
title_pos="auto",
title_top="auto",
title_color=None,
subtitle_color=None,
title_text_size=18,
subtitle_text_size=12,
background_color=None,
page_title=constants.PAGE_TITLE,
renderer=constants.CANVAS_RENDERER,
extra_html_text_label=None,
is_animation=True,
):
"""
:param title:
主标题文本,支持 \n 换行,默认为""
:param subtitle:
副标题文本,支持 \n 换行,默认为""
:param width:
画布宽度,默认为 800(px)
:param height:
画布高度,默认为 400(px)
:param title_pos:
标题距离左侧距离,默认为'left',有'auto', 'left', 'right',
'center'可选,也可为百分比或整数
:param title_top:
标题距离顶部距离,默认为'top',有'top', 'middle', 'bottom'可选,
也可为百分比或整数
:param title_color:
主标题文本颜色,默认为'#000'
:param subtitle_color:
副标题文本颜色,默认为'#aaa'
:param title_text_size:
主标题文本字体大小,默认为18
:param subtitle_text_size:
副标题文本字体大小,默认为12
:param background_color:
画布背景颜色,默认为'#fff'
:param page_title:
指定生成的 html 文件中 标签的值。默认为'Echarts'
:param renderer:
指定使用渲染方式,有 'svg' 和 'canvas' 可选,默认为 'canvas'。 3D 图仅能使用 'canvas'。
:param extra_html_text_label:
额外的 HTML 文本标签,( 标签)。类型为 list,list[0] 为文本内容, list[1] 为字体风格样式(选填)。如["this is a p label", "color:red"]
:param is_animation:
是否开启动画,默认为 True。V0.5.9+
"""
通用配置
xyAxis
平面直角坐标系中的x、y轴(Line,Bar,Scatter,EffectScatter,Kline)
# is_convert->bool 是否交换x,y轴
#is_xaxislabel_align->bool 默认False,x轴刻度线和标签是否对齐
#is_yaxislabel_align -> bool 默认False,y 轴刻度线和标签是否对齐
#is_xaxis_inverse -> bool 默认False,是否反向 x 坐标轴
#is_yaxis_inverse -> bool 默认False,是否反向 y 坐标轴
#is_xaxis_boundarygap -> bool 默认True,x 轴两边留白策略,适用于类目轴。类目轴中 boundaryGap 可以配置为 True 和 False。这时候刻度只是作为分隔线,标签和数据点都会在两个刻度之间的带(band)中间,即两边留白
#is_yaxis_boundarygap -> bool 默认True,y 轴两边留白策略,适用于类目轴。类目轴中 boundaryGap 可以配置为 True 和 False。这时候刻度只是作为分隔线,标签和数据点都会在两个刻度之间的带(band)中间,即两边留白
#is_xaxis_show -> bool 默认True,是否显示x轴
#is_yaxis_show -> bool 默认True,是否显示y轴
#is_splitline_show -> bool 默认True,是否显示y轴网络线
#x_axis -> list x 轴数据项
#xaxis_interval -> int x 轴刻度标签的显示间隔,在类目轴中有效。默认会采用标签不重叠的策略间隔显示标签,设置成 0 强制显示所有标签。设置为 1,表示『隔一个标签显示一个标签』,如果值为 2,表示隔两个标签显示一个标签,以此类推
#xaxis_force_interval -> int/str 强制设置 x 坐标轴分割间隔。如设置为 50 则刻度为 [0, 50, 150, ...],设置为 "auto" 则只显示两个刻度。一般情况下不建议设置这个参数!!因为 splitNumber 是预估的值,实际根据策略计算出来的刻度可能无法达到想要的效果,这时候可以使用 interval 配合 min、max 强制设定刻度划分。在类目轴中无效
#xaxis_margin -> int 默认8,x轴刻度标签与轴线之间的距离
#xaxis_name -> str x轴名称
#xaxis_name_size -> int 默认14,x轴名称字体大小
#xaxis_name_gap -> int 默认25,x轴名称与轴线之间的距离
#xaxis_name_pos -> str x轴名称位置,有“start,middle,end”
#xaxis_min -> int/float x 坐标轴刻度最小值,默认为自适应。使用特殊值 "dataMin" 可自定以数据中最小值为 x 轴最小值
#xaxis_max -> int/float x 坐标轴刻度最大值,默认为自适应。使用特殊值 "dataMax" 可自定以数据中最小值为 x 轴最大值
#xaxis_pos -> str x 坐标轴位置,有'top','bottom'可选
#xaxis_label_textsize -> int 默认12,x轴标签字体大小
#xaxis_label_textcolor -> str 默认#000,x轴标签字体颜色
#xaxis_type -> str x轴类型:
'value':数值轴,适用于连续数据。
'category':类目轴,适用于离散的类目数据。
'log':对数轴。适用于对数数据
#xaxis_rotate -> int 默认0,x 轴刻度标签旋转的角度,在类目轴的类目标签显示不下的时候可以通过旋转防止标签之间重叠。旋转的角度从 -90 度到 90 度
#xaxis_formatter -> str 默认“”,
x 轴标签格式器,如 '天',则 x 轴的标签为数据加'天'(3 天,4 天)。
xaxis_formatter -> function
def label_formatter(params):
return params.value + ' [Good!]'
(params: Object|Array) => string
参数 params 是 formatter 需要的单个数据集。格式如下:
{
componentType: 'series',
// 系列类型
seriesType: string,
// 系列在传入的 option.series 中的 index
seriesIndex: number,
// 系列名称
seriesName: string,
// 数据名,类目名
name: string,
// 数据在传入的 data 数组中的 index
dataIndex: number,
// 传入的原始数据项
data: Object,
// 传入的数据值
value: number|Array,
// 数据图形的颜色
color: string,
}
#yaxis_name -> str y轴名称
#yaxis_name_size -> int 默认14,y轴名称字体大小
#yaxis_name_gap -> int 默认25,y轴名称与轴线之间的距离
#yaxis_name_pos -> str y轴名称位置,有’start‘,’middle‘,’end‘
#yaxis_min -> int/float y 坐标轴刻度最小值,默认为自适应。使用特殊值 "dataMin" 可自定以数据中最小值为 y 轴最小值
#yaxis_max -> int/float y 坐标轴刻度最大值,默认为自适应。使用特殊值 "dataMax" 可自定以数据中最大值为 y 轴最大值
#yaxis_pos -> str y 坐标轴位置,有'left','right'可选
#yaxis_label_textsize -> int 默认12,y 坐标轴标签字体大小
#yaxis_label_textcolor -> str 默认#000,y 坐标轴标签字体颜色。
#yaxis_type -> str y轴类型:
'value':数值轴,适用于连续数据。
'category':类目轴,适用于离散的类目数据。
'log':对数轴。适用于对数数据。
#yaxis_rotate -> int 默认0,y 轴刻度标签旋转的角度,在类目轴的类目标签显示不下的时候可以通过旋转防止标签之间重叠。旋转的角度从 -90 度到 90 度
#yaxis_line_color -> str y 坐标轴线线的颜色。
#yaxis_line_width -> int 默认1,y 坐标轴线线的宽度。
dataZoom
dataZoom组件用于区域缩放,从而能自由关注细节的数据信息,或者概览数据总体,或者去除离群点的影响(Line、Bar、Scatter、EffectScatter、Kline)
默认的dataZoom控制条
#is_datazoom_show -> bool 默认False,是否使用区域缩放组件。
#datazoom_type -> str 默认’slider',区域缩放组件类型,有‘slider,inside,both’
#datazoom_range -> list 默认[50,100],区域缩放范围
#datazoom_orient -> str 默认‘horizontal’(效果显示在x轴),datazoom 组件在直角坐标系中的方向。如若设置为 'vertical' 的话效果显示在 y 轴
#datazoom_xaxis_index -> int/list datazoom 组件控制的 x 轴索引 默认控制第一个 x 轴,如没特殊需求无须显示指定。单个为 int 类型而控制多个为 list 类型,如 [0, 1] 表示控制第一个和第二个 x 轴
#datazoom_yaxis_index -> int/list datazoom 组件控制的 y 轴索引 默认控制第一个 y 轴,如没特殊需求无须显示指定。单个为 int 类型而控制多个为 list 类型,如 [0, 1] 表示控制第一个和第二个 x 轴。
额外的 dataZoom 控制条
#is_datazoom_extra_show -> bool 默认 -> False,是否使用额外区域缩放组件。
#datazoom_extra_type -> str 默认 -> 'slider',额外区域缩放组件类型,有'slider', 'inside', 'both'可选
#datazoom_extra_range -> list 默认 -> [50, 100],额外区域缩放的范围
#datazoom_extra_orient -> str 额外 datazoom 组件在直角坐标系中的方向,默认为 'vertical',效果显示在 y 轴。如若设置为 'horizontal' 的话效果显示在 x 轴
#datazoom_extra_xaxis_index -> int/list 额外 datazoom 组件控制的 x 轴索引默认控制第一个 x 轴,如没特殊需求无须显示指定。单个为 int 类型而控制多个为 list 类型,如 [0, 1] 表示控制第一个和第二个 x 轴
#datazoom_extra_yaxis_index -> int/list 额外 datazoom 组件控制的 y 轴索引默认控制第一个 y 轴,如没特殊需求无须显示指定。单个为 int 类型而控制多个为 list 类型,如 [0, 1] 表示控制第一个和第二个 x 轴。