group图形元素

graphic.elements[i]-group

group 是 ECharts 中唯一的可以有子节点的容器。group 可以用来整体定位一组图形元素。

graphic.elements[i]-group.type

string [ 默认值 group ]

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

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

graphic.elements[i]-group.id

string [ 默认值 undefined ]

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

graphic.elements[i]-group.$action

string [ 默认值 'merge' ]

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

可取值：

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

graphic.elements[i]-group.left

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-group.right

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-group.top

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-group.bottom

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-group.bounding

strin [ 默认值 'all' ]

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

参见例子：

可取值：

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

graphic.elements[i]-group.z

number [ 默认值 0 ]

z 方向的高度，决定层叠关系。

graphic.elements[i]-group.zlevel

number [ 默认值 0 ]

决定此元素绘制在哪个 canvas 层中。注意，越多 canvas 层会占用越多资源。

graphic.elements[i]-group.silent

boolean [ 默认值 false ]

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

graphic.elements[i]-group.invisible

boolean [ 默认值 false ]

节点是否可见。

graphic.elements[i]-group.cursor

string [ 默认值 'pointer' ]

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

graphic.elements[i]-group.draggable

boolean [ 默认值 false ]

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

graphic.elements[i]-group.progressive

boolean [ 默认值 false ]

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

graphic.elements[i]-group.width

number [ 默认值 0 ]

用于描述此 group 的宽。

这个宽只用于给子节点定位。

即便当宽度为零的时候，子节点也可以使用 left: 'center' 相对于父节点水平居中。

graphic.elements[i]-group.height

number [ 默认值 0 ]

用于描述此 group 的高。

这个高只用于给子节点定位。

即便当高度为零的时候，子节点也可以使用 top: 'middle' 相对于父节点垂直居中。

graphic.elements[i]-group.children

Array

子节点列表，其中项都是一个图形元素定义。