ECharts 入门教程设置ECharts扇形元素

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

graphic.elements[i]-sector

用于设置 ECharts 中的扇形元素。

graphic.elements[i]-sector.type  |  string
[ default: sector ]

使用 setOption 首次设定图形元素时必须指定的图形元素的类型。可取值如下：

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

此处由于我们是设置 ECharts 的扇形元素，因此，我们选择的值为“sector”。

graphic.elements[i]-sector.id  |  string
[ default: undefined ]

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

graphic.elements[i]-sector.$action  |  string
[ default: 'merge' ]

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

可取值如下：

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

graphic.elements[i]-sector.left  |  number, string
[ default: undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-sector.right  |  number, string
[ default: undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-sector.top  |  number, string
[ default: undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-sector.bottom  |  number, string
[ default: undefined ]

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

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

值的类型可以是：

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

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

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

graphic.elements[i]-sector.bounding   |  string
[ default: 'all' ]

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

参见例子

可取值：

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

graphic.elements[i]-sector.z   |  number
[ default: 0 ]

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

graphic.elements[i]-sector.zlevel   |  number
[ default: 0 ]

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

graphic.elements[i]-sector.silent   |  boolean
[ default: false ]

扇形元素是否不响应鼠标以及触摸事件。

graphic.elements[i]-sector.invisible   |  boolean
[ default: false ]

扇形元素的节点是否可见。

graphic.elements[i]-sector.cursor  |  string
[ default: 'pointer' ]

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

graphic.elements[i]-sector.draggable  |  boolean
[ default: false ]

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

graphic.elements[i]-sector.progressive  |  boolean
[ default: false ]

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

上一节： ECharts圆环图形元素的使用

下一节： ECharts圆弧属性

"ECharts 入门教程"的目录

ECharts 入门教程 设置ECharts扇形元素

ECharts 入门教程设置ECharts扇形元素