ECharts 入门教程 ECharts圆环图形元素的使用

2024-02-25 开发教程 ECharts 入门教程 匿名 4

graphic.elements[i]-ring

ECharts 圆环图形元素配置。

graphic.elements[i]-ring.type | string

[ default: ring ]

用 setOption 首次设定图形元素时必须指定。 可取值:

image, text, circle, sector, ring, polygon, polyline, rect, line, bezierCurve, arc, group

graphic.elements[i]-ring.id | string

[ default: undefined ]

id 用于在更新或删除图形元素时指定更新哪个图形元素,如果不需要用可以忽略。

graphic.elements[i]-ring.$action | string

[ default: 'merge' ]

setOption 时指定本次对该图形元素的操作行为。

可取值:

  • 'merge':如果已有元素,则新的配置项和已有的设定进行 merge。如果没有则新建。
  • 'replace':如果已有元素,删除之,新建元素替代之。
  • 'remove':删除元素。

graphic.elements[i]-ring.left | number, string

[ default: undefined ]

描述怎么根据父元素进行定位。

『父元素』是指:如果是顶层元素,父元素是 echarts 图表容器。如果是 group 的子元素,父元素就是 group 元素。

值的类型可以是:

  • number:表示像素值。
  • 百分比值:如 '33%',用父元素的高和此百分比计算出最终值。
  • 'center':表示自动居中。

left 和 right 只有一个可以生效。

如果指定 left 或 right,则 shape 里的 x、cx 等定位属性不再生效。

graphic.elements[i]-ring.right | number, string

[ default: undefined ]

描述怎么根据父元素进行定位。

『父元素』是指:如果是顶层元素,父元素是 echarts 图表容器。如果是 group 的子元素,父元素就是 group 元素。

值的类型可以是:

  • number:表示像素值。
  • 百分比值:如 '33%',用父元素的高和此百分比计算出最终值。
  • 'center':表示自动居中。

left 和 right 只有一个可以生效。

如果指定 left 或 right,则 shape 里的 x、cx 等定位属性不再生效。

graphic.elements[i]-ring.top | number, string

[ default: undefined ]

描述怎么根据父元素进行定位。

『父元素』是指:如果是顶层元素,父元素是 echarts 图表容器。如果是 group 的子元素,父元素就是 group 元素。

值的类型可以是:

  • number:表示像素值。
  • 百分比值:如 '33%',用父元素的宽和此百分比计算出最终值。
  • 'middle':表示自动居中。

top 和 bottom 只有一个可以生效。

如果指定 top 或 bottom,则 shape 里的 y、cy 等定位属性不再生效。

graphic.elements[i]-ring.bottom | number, string

[ default: undefined ]

描述怎么根据父元素进行定位。

『父元素』是指:如果是顶层元素,父元素是 echarts 图表容器。如果是 group 的子元素,父元素就是 group 元素。

值的类型可以是:

  • number:表示像素值。
  • 百分比值:如 '33%',用父元素的宽和此百分比计算出最终值。
  • 'middle':表示自动居中。

top 和 bottom 只有一个可以生效。

如果指定 top 或 bottom,则 shape 里的 y、cy 等定位属性不再生效。

graphic.elements[i]-ring.bounding | strin

[ default: 'all' ]

决定圆环图形元素在定位时,对自身的包围盒计算方式。

参见例子

可取值:

  • 'all':(默认) 表示用自身以及子节点整体的经过 transform 后的包围盒进行定位。 这种方式易于使整体都限制在父元素范围中。
  • 'raw': 表示仅仅用自身(不包括子节点)的没经过 tranform 的包围盒进行定位。 这种方式易于内容超出父元素范围的定位方式。

graphic.elements[i]-ring.z | number

[ default: 0 ]

圆环图形元素在 z 方向的高度,决定层叠关系。

graphic.elements[i]-ring.zlevel | number

[ default: 0 ]

决定此圆环图形元素绘制在哪个 canvas 层中。注意,越多 canvas 层会占用越多资源。

graphic.elements[i]-ring.silent | boolean

[ default: false ]

是否不响应鼠标以及触摸事件。

graphic.elements[i]-ring.invisible | boolean

[ default: false ]

圆环图形元素节点是否可见。

graphic.elements[i]-ring.cursor | string

[ default: 'pointer' ]

鼠标悬浮时在圆环图形元素上时鼠标的样式是什么。同 CSS 的 cursor。

graphic.elements[i]-ring.draggable | boolean

[ default: false ]

圆环图形元素是否可以被拖拽。

graphic.elements[i]-ring.progressive | boolean

[ default: false ]

是否渐进式渲染。当图形元素过多时才使用。

graphic.elements[i]-ring.shape | Object

设置圆形元素的形状大小。

  • graphic.elements[i]-rect.shape.cx | number
    [ default: 0 ]
    圆环图形元素的中心在父节点坐标系(以父节点左上角为原点)中的横坐标值。
  • graphic.elements[i]-rect.shape.cy | numbr
    [ default: 0 ]
    圆环图形元素的中心在父节点坐标系(以父节点左上角为原点)中的纵坐标值。
  • graphic.elements[i]-rect.shape.r | number
    [ default: 0 ]
    圆环图形元素的外半径。
  • graphic.elements[i]-rect.shape.r0 | number
    [ default: 0 ]
    圆环图形元素的内半径。