阅读(3879) (0)

设置ECharts扇形元素

2017-10-13 09:22:49 更新
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 ]

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