云服务器

Echarts组件 -- 图例组件

2017-12-27 14:43:51 0

图例按照类型可以分为两种,分别是滚动翻页的图例以及普通的图例,因此,图例组件的配置项也可以分为两大类,分别是通用配置项以及滚动翻页的图例配置项

 通用配置项

通用配置项又可分为自身属性配置项、自身样式配置项、文本样式配置项以及其他配置项
  自身属性配置项
主要包含位置、宽高、间距、布局朝向、对齐方式以及其他配置项
  • 位置:right、left、top、bottom,表示图例组件距离容器右左上下四侧的距离, 默认自适应(auto) ,可以设置具体的像素值;也可以设置相对于容器宽高的百分比;也可以是其他的值,如 ' bottom ' 、' top ' 、' middle ',组件会根据位置自动对齐。
  • 宽高:width、height,表示图例组件的宽高,默认自适应(auto),可以设置具体像素值也可以设置百分比;itemWidth、itemHeight,图例组件中图例标记的图形宽高(即图例中带有颜色的一块,不包含字体),默认分别为25,14像素。
  • 间距: padding,图例的内边距,默认为5像素;itemGap,图例每项之间的间隔,默认为10像素,当图例布局为横向布局时,表示的是水平间隔,当为纵向布局时,表示的是纵向间隔。
  • 布局朝向:horizontal(横向布局)、vertical(纵向布局)。
  • 对齐方式:默认自动(auto),也可以为 ' left ' ,' right '。
  • 其他配置项:selectedMode,图例选择的模式,控制是否可以通过点击图例改变系列的显示状态,默认开启(true),也可以设置成 false 关闭,也可以设成 ' single ' 或者 ' multiple ' 使用单选或者多选模式;inactiveColor,图例被关闭时的颜色;selected,图例选中状态表,用来设置哪些图例选项是选中的,通常用于设置图例的默认选中系列。
  自身样式配置项
主要包含背景颜色、边框、阴影
  • 背景颜色:backgroundColor,默认透明(transparent),可以用十六进制表示法,也可以用rgb以及rgba表示法。
  • 边框:borderColor、borderWidth、borderRadius,分别表示边框颜色,边框宽度、边框圆角。
  • 阴影:shadowBlur、shadowColor、shadowOffsetX、shadowOffsetY,分别表示阴影的模糊大小、阴影的颜色、阴影水平方向上的偏移、阴影垂直方向上的偏移,共同设置形成图形的阴影效果,同时图例需要设置show为true,即显示出来的图例才能具备阴影效果。
  文本样式配置项
主要包括字体基本样式配置,文字颜色,文字描边,文字阴影,文本块大小,文本块背景颜色、文本块阴影、文本块边框、自定义富文本样式;
  • 字体基本样式设置:fontStyle(字体风格,'normal'、'italic'、'oblique'三种取值可选)、fontWeight(字体的粗细,取值有'normal'、'bold'、'bolder'、'lighter'以及具体的数值)、fontSize(字体的大小,取值为具体数值)、fontFamily(字体的系列,'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei'等)
  • 文字颜色:color
  • 文字描边:textBorderColor(文字的描边颜色)、textBorderWidth(文字的描边宽度)
  • 文字阴影:textShadowColor(文字的阴影颜色)、textShadowBlur(文字的阴影长度)、textShadowOffsetX(文字的阴影 X 偏移)、textShadowOffsetY(文字的阴影 Y 偏移)
  • 文本块大小:lineHeight、width、height (这三个配置项在定义了rich以后才会生效)、padding(内边距)
  • 文本块背景颜色:backgroundColor
  • 文本块阴影:shadowColor(文字块阴影颜色)、shadowBlur(文字块阴影长度)、shadowOffsetX(文字块阴影X偏移)、shadowOffsetY(文字块阴影Y偏移)
  • 文本块边框:borderColor(文字块边框颜色)、borderWidth(文字块边框宽度)、borderRadius(文字块边框圆角)
  • 自定义富文本样式:rich(可以在这里面定义某一套样式,然后通过这套样式的名称来使用该套样式)
  其他配置项
主要包括格式化图例文本,悬浮框配置,图例数据配置
  • 格式化图例文本:formatter(用来格式化图例文本,支持字符串模板以及回调函数两种形式)
  • 悬浮框配置:tooltip(图例的悬浮框配置,配置项与tooltip组件一样)
  • 图例数据配置:data(图例的数据数组)

 滚动翻页配置项 --包括图例显示项,图例控制块与图例项之间的间距,图例控制块配置,翻页动画设置

  • 图例显示项:scrollDataIndex(图例当前最左上显示项的dataIndex,可决定当前图例滚动到哪里)
  • 图例控制块与图例项之间的间距:pageButtonGap
  • 图例控制块配置:
    • 按钮和页信息之间的间距:pageButtonItemGap,默认是5像素
    • 图例控制块的位置:pageButtonPosition,两种取值,'start'表示控制块在左或者上,'end'表示按钮块在右或者下
    • 图例控制块中页信息的显示格式:pageFormatter,默认为 '{current}/{total}',其中 {current} 是当前页号(从 1 开始计数),{total} 是总页数
    • 图例控制块的图标:horizontal(横向布局时的翻页按钮图标,是一个数组,数组里的每一项可以设置为图片的链接或者任意的矢量路径)、vertical(纵向布局时的翻页按钮图标,与横向布局翻页按钮图标一样)
    • 翻页按钮的颜色:pageIconColor
    • 翻页按钮不激活时的颜色:pageIconInactiveColor
    • 翻页按钮的大小:pageIconSize,默认15像素,可以是数字也可以是数组,如[宽,高]
    • 页信息的文字样式:pageTextStyle,与上面的文本样式配置项类似(不包含文字块除了大小以外的配置,也不包含富文本样式)
  • 翻页动画设置:animation(图例翻页是否使用动画)、animationDurationUpdate(图例翻页时的动画时长)

 把图例组件的配置项整合了下,做了下面这张图:

上一篇: 无
下一篇:

微信关注

获取更多技术咨询