使用image图形元素

graphic.elements[i]-image

在 ECharts 中使用 image 图形元素。

graphic.elements[i]-image.type

string [ 默认值 image ]

ECharts 中 image 图形元素的类别设置，可取值为：image, text, circle, sector, ring, polygon, polyline, rect, line, bezierCurve, arc, group

注意：用 setOption 首次设定图形元素时必须指定。

graphic.elements[i]-image.id

string [ 默认值 undefined ]

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

graphic.elements[i]-image.$action

string [ 默认值 'merge' ]

使用 setOption 首次设定时指定本次对该 image 图形元素的操作行为。

可取值：

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

graphic.elements[i]-image.left

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-image.right

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-image.top

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-image.bottom

number, string [ 默认值 undefined ]

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

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

值的类型可以是：

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

注意：top 和 bottom 只有一个可以生效。
如果指定 top 或 bottom，则 shape 里的 y、cy 等定位属性不再生效。

graphic.elements[i]-image.bounding

strin [ 默认值 'all' ]

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

参见例子：

可取值：

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

graphic.elements[i]-image.z

number [ 默认值 0 ]

image 图形元素在 z 方向的高度，决定层叠关系。

graphic.elements[i]-image.zlevel

number [ 默认值 0 ]

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

graphic.elements[i]-image.silent

boolean [ 默认值 false ]

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

graphic.elements[i]-image.invisible

boolean [ 默认值 false ]

节点是否可见。

graphic.elements[i]-image.cursor

string [ 默认值 'pointer' ]

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

graphic.elements[i]-image.draggable

boolean [ 默认值 false ]

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

graphic.elements[i]-image.progressive

boolean [ 默认值 false ]

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