Web数据可视化教程（基于ECharts）教案 电子活页5-1 饼图的主要属性及其设置

Web数据可视化教程（基于ECharts）Web数据可视化教程（基于ECharts）Web数据可视化教程（基于ECharts）饼图的主要属性及其设置Web数据可视化教程（基于ECharts）（1）series-pie.type='pie'string类（2）series-pie.Idstring类型，用于设置组件ID，默认不指定。指定则可用于在option或者API中引用组件。（3）series-pie.namestring类型，用于设置系列名称，用于tooltip的显示，legend的图例筛选，在setOption更新数据和配置项时用于指定对应的系列。（4）series-pie.colorBy='data'string类型，从v5.2.0开始支持，用于设置从调色盘option.color中取色的策略，可取值为：①'series'：按照系列分配调色盘中的颜色，同一系列中的所有数据都是用相同的颜色；②'data'：按照数据项分配调色盘中的颜色，每个数据项都使用不同的颜色。（5）series-pie.legendHoverLink=trueboolean类型，用于设置是否启用图例hover时的联动高亮。（6）series-pie.coordinateSystemstring类型，从v5.4.0开始支持，用于设置该系列使用的坐标系，其取值可选项为：①null或者'none'：无坐标系。②'geo'：使用地理坐标系，通过geoIndex指定相应的地理坐标系组件。③'calendar'：使用日历坐标系，通过calendarIndex指定相应的日历坐标系组件。④'none'：不使用坐标系。（7）series-pie.geoIndexnumber类型，从v5.4.0开始支持，用于设置使用的地理坐标系的index，在单个图表实例中存在多个地理坐标系的时候有用。（8）series-pie.calendarIndexnumber类型，从v5.4.0开始支持，用于设置使用的日历坐标系的index，在单个图表实例中存在多个日历坐标系的时候有用。（9）series-pie.selectedModeboolean或string类型，用于设置选中模式的配置，表示是否支持多个选中，默认关闭，支持布尔值和字符串，字符串取值可选'single'，'multiple'，'series'分别表示单选，多选以及选择整个系列。从v5.3.0开始支持'series'。（10）series-pie.selectedOffset=10number类型，用于设置选中扇区的偏移距离。（11）series-pie.clockwise=trueboolean类型，用于设置饼图的扇区是否是顺时针排布。（12）series-pie.startAngle=90number类型，用于设置起始角度，支持范围[0,360]。（13）series-pie.endAngle='auto'number或string类型，从v5.5.0开始支持，用于设置结束角度，默认值是'auto'。当值为'auto'时，根据startAngle自动计算结束角度，以确保是一个完整的圆。（14）series-pie.minAnglenumber类型，用于设置最小的扇区角度（0~360），用于防止某个值过小导致扇区太小影响交互。（15）series-pie.padAnglenumber类型，从v5.5.0开始支持，用于设置饼图扇区之间的间隔角度（0~360）。（16）series-pie.minShowLabelAnglenumber类型，用于设置小于这个角度（0~360）的扇区，不显示标签（label和labelLine）。（17）series-pie.roseTypeboolean或string类型，用于设置是否展示成南丁格尔图，通过半径区分数据大小。可选择两种模式：①'radius'扇区圆心角展现数据的百分比，半径展现数据的大小。②'area'所有扇区圆心角相同，仅通过半径展现数据大小。（18）series-pie.avoidLabelOverlap=trueboolean类型，用于设置是否启用防止标签重叠策略，默认开启，在标签拥挤重叠的情况下会挪动各个标签的位置，防止标签间的重叠。如果不需要开启该策略，例如圆环图这个例子中需要强制所有标签放在中心位置，可以将该值设为false。（19）series-pie.stillShowZeroSum=trueboolean类型，用于设置是否在数据和为0（一般情况下所有数据为0）的时候仍显示扇区。（20）series-pie.percentPrecision=2number类型，用于设置饼图百分比数值的精度，默认保留小数点后两位。（21）series-pie.cursor='pointer'string类型，用于设置鼠标悬浮时在图形元素上时鼠标的样式是什么。同CSS的cursor。（22）series-pie.zlevelnumber类型，用于设置所有图形的zlevel值。zlevel用于Canvas分层，不同zlevel值的图形会放置在不同的Canvas中，Canvas分层是一种常见的优化手段。我们可以把一些图形变化频繁（例如有动画）的组件设置成一个单独的zlevel。需要注意的是过多的Canvas会引起内存开销的增大，在手机端上需要谨慎使用以防崩溃。zlevel大的Canvas会放在zlevel小的Canvas的上面。（23）series-pie.z=2number类型，用于设置组件的所有图形的z值。控制图形的前后顺序。z值小的图形会被z值大的图形覆盖。z相比zlevel优先级更低，而且不会创建新的Canvas。（24）series-pie.leftstring或number类型，用于设置piechart组件离容器左侧的距离。left的值可以是像20这样的具体像素值，可以是像'20%'这样相对于容器高宽的百分比，也可以是'left'、'center'、'right'。如果left的值为'left'、'center'、'right'，组件会根据相应的位置自动对齐。（25）series-pie.topstring或number类型，用于设置piechart组件离容器上侧的距离。top的值可以是像20这样的具体像素值，可以是像'20%'这样相对于容器高宽的百分比，也可以是'top'、'middle'、'bottom'。如果top的值为'top'、'middle'、'bottom'，组件会根据相应的位置自动对齐。（26）series-pie.rightstring或number类型，用于设置piechart组件离容器右侧的距离。right的值可以是像20这样的具体像素值，可以是像'20%'这样相对于容器高宽的百分比。默认自适应。（27）series-pie.bottomstring或number类型，用于设置piechart组件离容器下侧的距离。bottom的值可以是像20这样的具体像素值，可以是像'20%'这样相对于容器高宽的百分比。默认自适应。（28）series-pie.width='auto'string或number类型，用于设置piechart组件的宽度。默认自适应。（29）series-pie.height='auto'string或number类型，用于设置piechart组件的高度。默认自适应。（30）series-pie.showEmptyCircle=trueboolean类型，从v5.2.0开始支持，用于设置是否在无数据的时候显示一个占位圆。（31）series-pie.emptyCircleStyleObject类型，从v5.2.0开始支持，用于设置占位圆样式。◆series-pie.emptyCircleStyle.color=lightgrayColor类型，用于设置图形的颜色。支持使用rgb(255,255,255)，rgba(255,255,255,1)，#fff等方式设置为纯色，也支持设置为渐变色和纹理填充。◆series-pie.emptyCircleStyle.borderColor='#000'Color类型，用于设置图形的描边颜色。支持的颜色格式同color，不支持回调函数。◆series-pie.emptyCircleStyle.borderWidthnumber类型，用于设置描边线宽。为0时无描边。◆series-pie.emptyCircleStyle.borderType='solid'string或number或Array类型，用于设置描边类型。其取值可选项为：'solid'、'dashed'、'dotted'。自v5.0.0开始，也可以是number或者number数组，用以指定线条的dasharray，配合borderDashOffset可实现更灵活的虚线效果。例如：{borderType:[5,10],borderDashOffset:5}◆series-pie.emptyCircleStyle.borderDashOffsetnumber类型，从v5.0.0开始支持，用于设置虚线的偏移量，可搭配borderType指定dasharray实现灵活的虚线效果。◆series-pie.emptyCircleStyle.borderCap='butt'string类型，从v5.0.0开始支持，用于指定线段末端的绘制方式，其取值可选项为：①'butt'：线段末端以方形结束。②'round'：线段末端以圆形结束。③'square'：线段末端以方形结束，但是增加了一个宽度和线段相同，高度是线段厚度一半的矩形区域。默认值为'butt'。◆series-pie.emptyCircleStyle.borderJoin='bevel'string类型，从v5.0.0开始支持，用于设置2个长度不为0的相连部分（线段，圆弧，曲线）如何连接在一起的属性（长度为0的变形部分，其指定的末端和控制点在同一位置，会被忽略）。其取值可选项为：①'bevel'：在相连部分的末端填充一个额外的以三角形为底的区域，每个部分都有各自独立的矩形拐角。②'round'：通过填充一个额外的，圆心在相连部分末端的扇形，绘制拐角的形状。圆角的半径是线段的宽度。③'miter'：通过延伸相连部分的外边缘，使其相交于一点，形成一个额外的菱形区域。这个设置可以通过borderMiterLimit属性看到效果。默认值为'bevel'。◆series-pie.emptyCircleStyle.borderMiterLimit=10number类型，从v5.0.0开始支持，用于设置斜接面限制比例。只有当borderJoin为miter时，borderMiterLimit才有效。默认值为10。负数、0、Infinity和NaN均会被忽略。◆series-pie.emptyCircleStyle.shadowBlurnumber类型，用于设置图形阴影的模糊大小。该属性配合shadowColor、shadowOffsetX、shadowOffsetY一起设置图形的阴影效果。示例代码如下：{shadowColor：'rgba(0,0,0,0.5)',shadowBlur:10}◆series-pie.emptyCircleStyle.shadowColorColor类型，用于设置阴影颜色。支持的格式同color。◆series-pie.emptyCircleStyle.shadowOffsetXnumber类型，用于设置阴影水平方向上的偏移距离。◆series-pie.emptyCircleStyle.shadowOffsetYnumber类型，用于设置阴影垂直方向上的偏移距离。◆series-pie.emptyCircleStyle.opacity=1number类型，用于设置图形透明度。支持从0到1的数字，为0时不绘制该图形。（32）series-pie.labelObject类型，用于设置饼图图形上的文本标签，可用于说明图形的一些数据信息，例如值、名称等。◆series-pie.label.showboolean类型。◆series-pie.label.position='outside'string类型，用于设置标签的位置。其取值可选项为：①'outside'饼图扇区外侧，通过视觉引导线连到相应的扇区。②'inside'饼图扇区内部。③'inner'同'inside'。④'center'在饼图中心位置。◆series-pie.label.formatterstring或Function类型。用于设置标签内容格式器，支持字符串模板和回调函数两种形式，字符串模板与回调函数返回的字符串均支持用\n换行。

字符串模板字符串模板模板变量有：{a}：系列名。{b}：数据名。{c}：数据值。{d}：百分比。{@xxx}：数据中名为'xxx'的维度的值，如{@product}表示名为'product'的维度的值。{@[n]}：数据中维度n的值，如{@[3]}表示维度3的值，从0开始计数。示例代码：formatter:'{b}:{d}'

回调函数回调函数格式：(params:Object|Array)=>string参数params是formatter需要的单个数据集。格式如下：{componentType:'series',//系列类型seriesType:string,//系列在传入的option.series中的indexseriesIndex:number,//系列名称seriesName:string,//数据名，类目名name:string,//数据在传入的data数组中的indexdataIndex:number,//传入的原始数据项data:Object,//传入的数据值。在多数系列下它和data相同。//在一些系列下是data中的分量（如map、radar中）value:number|Array|Object,//坐标轴encode映射信息，//key为坐标轴（如'x''y''radius''angle'等）//value必然为数组，不会为null/undefined，表示dimensionindex。//其内容如：//{//x:[2]//dimensionindex为2的数据映射到x轴//y:[0]//dimensionindex为0的数据映射到y轴//}encode:Object,//维度名列表dimensionNames:Array<String>,//数据的维度index，如0或1或2…//仅在雷达图中使用。dimensionIndex:number,//数据图形的颜色color：string,//百分比percent:number类型，用于设置}注：encode和dimensionNames的使用方式，例如：如果数据为：dataset:{source:[['苹果',43.3,85.8,93.7],['梨子',83.1,73.4,55.1],['葡萄',86.4,65.2,82.5],['芒果',72.4,53.9,39.1]]}则可这样得到y轴对应的value：params.value[params.encode.y[0]]如果数据为：dataset:{dimensions:['product','7月','8月','9月'],source:[{product:'苹果','7月':43.3,'8月':85.8,'9月':93.7},{product:'梨子','7月':83.1,'8月':73.4,'9月':55.1},{product:'葡萄','7月':86.4,'8月':65.2,'9月':82.5},{product:'芒果','7月':72.4,'8月':53.9,'9月':39.1}]}则可这样得到y轴对应的value：params.value[params.dimensionNames[params.encode.y[0]]]◆series-pie.label.rotateboolean或number或string类型，用于设置标签旋转：

如果为true或'radial'，则为径向排布。（'radial'字面量从v5.2.0开始支持）。

如果为'tangential'，则为切向排布。（从v5.2.0开始支持）。

如果为number，旋转指定角度，从-90度到90度。正值是逆时针。◆series-pie.label.minMarginnumber类型，从v5.0.0开始支持，用于控制标签之间的最小距离，当启用labelLayout时可能会用到。◆series-pie.label.color='#fff'Color类型，用于设置文字的颜色。如果设置为'inherit'，则为视觉映射得到的颜色，如系列色。◆series-pie.label.fontStyle='normal'string类型，用于设置文字字体的风格。其取值可选项为：'normal'、'italic'、'oblique'◆series-pie.label.fontWeight='normal'string或number类型，用于设置文字字体的粗细。其取值可选项为：'normal'、'bold'、'bolder'、'lighter'、100|200|300|400…◆series-pie.label.fontFamily='sans-serif'string类型，用于设置文字的字体系列。还可以是'serif'、'monospace'、'Arial'、'CourierNew'、'MicrosoftYaHei'…◆series-pie.label.fontSize=12number类型，用于设置文字的字体大小。◆series-pie.label.lineHeightnumber类型，用于设置行高。rich中如果没有设置lineHeight，则会取父层级的lineHeight。例如：{lineHeight:56,rich:{a:{//没有设置`lineHeight`，则`lineHeight`为56}}}◆series-pie.label.backgroundColor='transparent'string或Object类型，用于设置文字块背景色。可以使用颜色值，例如：'#123234','red','rgba(0,23,11,0.3)'。也可以直接使用图片，例如：backgroundColor：{image:'xxx/xxx.png'//这里可以是图片的URL，//或者图片的dataURI，//或者HTMLImageElement对象，//或者HTMLCanvasElement对象。}当使用图片的时候，可以使用width或height指定高宽，也可以不指定自适应。如果设置为'inherit'，则为视觉映射得到的颜色，如系列色。◆series-pie.label.borderColorColor类型，用于设置文字块边框颜色。如果设置为'inherit'，则为视觉映射得到的颜色，如系列色。◆series-pie.label.borderWidthnumber类型，用于设置文字块边框宽度。◆series-pie.label.borderType='solid'string或number或Array类型，用于设置文字块边框描边类型。其取值可选项为：'solid'、'dashed'、'dotted'。自v5.0.0开始，也可以是number或者number数组，用以指定线条的dasharray，配合borderDashOffset可实现更灵活的虚线效果。例如：{borderType:[5,10],borderDashOffset:5}◆series-pie.label.borderDashOffsetnumber类型，从v5.0.0开始支持，用于设置虚线的偏移量，可搭配borderType指定dasharray实现灵活的虚线效果。◆series-pie.label.borderRadiusnumber或Array类型，用于设置文字块的圆角。◆series-pie.label.paddingnumber或Array类型，用于设置文字块的内边距。例如：padding:[3,4,5,6]：表示[上,右,下,左]的边距。padding:4：表示padding:[4,4,4,4]。padding:[3,4]：表示padding:[3,4,3,4]。注意，文字块的width和height指定的是内容高宽，不包含padding。◆series-pie.label.shadowColor='transparent'Color类型，用于设置文字块的背景阴影颜色。◆series-pie.label.shadowBlurnumber类型，用于设置文字块的背景阴影长度。◆series-pie.label.shadowOffsetXnumber类型，用于设置文字块的背景阴影X偏移。◆series-pie.label.shadowOffsetYnumber类型，用于设置文字块的背景阴影Y偏移。◆series-pie.label.widthnumber类型，用于设置文本显示宽度。◆series-pie.label.heightnumber类型，用于设置文本显示高度。◆series-pie.label.textBorderColorColor类型，用于设置文字本身的描边颜色。如果设置为'inherit'，则为视觉映射得到的颜色，如系列色。◆series-pie.label.textBorderWidthnumber类型，用于设置文字本身的描边宽度。◆series-pie.label.textBorderType='solid'string或number或Array类型，用于设置文字本身的描边类型。其取值可选项为：'solid'、'dashed'、'dotted'。自v5.0.0开始，也可以是number或者number数组，用以指定线条的dasharray，配合textBorderDashOffset可实现更灵活的虚线效果。例如：{textBorderType:[5,10],textBorderDashOffset:5}◆series-pie.label.textBorderDashOffsetnumber类型，从v5.0.0开始支持，用于设置虚线的偏移量，可搭配textBorderType指定dasharray实现灵活的虚线效果。◆series-pie.label.textShadowColor='transparent'Color类型，用于设置文字本身的阴影颜色。◆series-pie.label.textShadowBlurnumber类型，用于设置文字本身的阴影长度。◆series-pie.label.textShadowOffsetXnumber类型，用于设置文字本身的阴影X偏移。◆series-pie.label.textShadowOffsetYnumber类型，用于设置文字本身的阴影Y偏移。◆series-pie.label.overflow='none'string类型，用于设置文字超出宽度是否截断或者换行，配置width时有效。①'truncate'截断，并在末尾显示ellipsis配置的文本，默认为…②'break'换行。③'breakAll'换行，跟'break'不同的是，在英语等拉丁文中，'breakAll'还会强制单词内换行。◆series-pie.label.ellipsis='…'string类型，用于设置在overflow配置为'truncate'的时候，可以通过该属性配置末尾显示的文本。◆series-pie.label.richObject类型。在rich里面，可以自定义富文本样式。利用富文本样式，可以在标签中做出非常丰富的效果。◆series-pie.label.alignTo='none'string类型，用于设置标签的对齐方式，仅当position值为'outer'时有效。从EChartsv4.6.0版本起，我们提供了'labelLine'与'edge'两种新的布局方式。①'none'（默认值）：labelline的长度为固定值，分别为labelLine.length及labelLine.length2。②'labelLine'：labelline的末端对齐，其中最短的长度由labelLine.length2决定。③'edge'：文字对齐，文字的边距由label.edgeDistance决定。◆series-pie.label.edgeDistance='25%'string或number类型，用于设置文字边距，仅当label.position为'outer'并且label.alignTo为'edge'时有效。通常来说，对于移动端等分辨率较小的情况，edgeDistance值设为比较小的值（例如10）能在有限的空间内显示更多文字，而不是被裁剪为…。但是对于分辨率更大的场景，百分比的值可以避免labelline过长。如果你需要在不同分辨率下使用，建议使用响应式图表设计为不同的分辨率设置不同的edgeDistance值。◆series-pie.label.bleedMargin=10number类型，用于设置文字的出血线大小，超过出血线的文字将被裁剪为'…'。仅当label.position为'outer'并且label.alignTo为'none'或'labelLine'的情况有效。◆series-pie.label.distanceToLabelLine=5number类型，用于设置文字与labelline之间的距离。◆series-pie.labelLineObject类型，标签的视觉引导线配置。在label位置设置为'outside'的时候会显示视觉引导线。◆series-pie.labelLine.showboolean类型，用于设置是否显示视觉引导线。◆series-pie.labelLine.showAboveboolean类型，从v5.0.0开始支持，用于设置是否显示在图形上方。◆series-pie.labelLine.lengthnumber类型，用于设置视觉引导线第一段的长度。◆series-pie.labelLine.length2number类型，用于设置视觉引导项第二段的长度。◆series-pie.labelLine.smoothbooleannumber类型，用于设置是否平滑视觉引导线，默认不平滑，可以设置成true平滑显示，也可以设置为0到1的值，表示平滑程度。◆series-pie.labelLine.minTurnAngle=90number类型，从v5.0.0开始支持，用于通过调整第二段线的长度，限制引导线两端之间最小的夹角，以防止过小的夹角导致显示不美观。可以设置为0-180度。◆series-pie.labelLine.lineStyleObject类型。◆series-pie.labelLine.maxSurfaceAnglenumber类型，从v5.0.0开始支持，用于通过调整第二段线的长度，限制引导线与扇区法线的最大夹角。设置为小于90度的值保证引导线不会和扇区交叉。可以设置为0-180度。◆series-pie.labelLayoutObject或Function类型，从v5.0.0开始支持，用于标签的统一布局配置。该配置项是在每个系列默认的标签布局基础上，统一调整标签的(x,y)位置，标签对齐等属性以实现想要的标签布局效果。示例如下：将标签显示在图形右侧10px的位置，并且垂直居中：labelLayout(params){return{x:params.rect.x+10,y:params.rect.y+params.rect.height/2,verticalAlign:'middle',align:'left'}}根据图形的包围盒尺寸决定文本尺寸labelLayout(params){return{fontSize:Math.max(params.rect.width/10,5)};}◆series-pie.labelLayout.hideOverlapboolean类型，用于设置是否隐藏重叠的标签。◆series-pie.labelLayout.moveOverlapstring类型，用于设置在标签重叠的时候是否挪动标签位置以防止重叠。目前支持配置为：①'shiftX'水平方向依次位移，在水平方向对齐时使用。②'shiftY'垂直方向依次位移，在垂直方向对齐时使用。◆series-pie.labelLayout.xnumber或string类型，用于设置标签的x位置。支持绝对的像素值或者'20%'这样的相对值。◆series-pie.labelLayout.ynumber或string类型，用于设置标签的y位置。支持绝对的像素值或者'20%'这样的相对值。◆series-pie.labelLayout.dxnumber类型，用于设置标签在x方向上的像素偏移。可以和x一起使用。◆series-pie.labelLayout.dynumber类型，用于设置标签在y方向上的像素偏移。可以和y一起使用◆series-pie.labelLayout.rotatenumber类型，用于设置标签旋转角度。◆series-pie.labelLayout.widthnumber类型，用于设置标签显示的宽度。可以配合overflow使用控制标签显示在固定宽度内◆series-pie.labelLayout.heightnumber类型，用于设置标签显示的高度。◆series-pie.labelLayout.alignstring类型，用于设置标签水平对齐方式。可以设置'left'、'center'、'right'。◆series-pie.labelLayout.verticalAlignstring类型，用于设置标签垂直对齐方式。可以设置'top'、'middle'、'bottom'。◆series-pie.labelLayout.fontSizenumber类型，用于设置Thetextsizeofthelabel.◆series-pie.labelLayout.draggableboolean类型，用于设置标签是否可以允许用户通过拖拽二次调整位置。◆series-pie.labelLayout.labelLinePointsArray类型，用于设置标签引导线三个点的位置。格式为：[[x,y],[x,y],[x,y]]在饼图中常用来微调已经计算好的引导线，其它情况一般不建议设置。◆series-pie.itemStyleObject图形样式。◆series-pie.itemStyle.color=自适应Color或Function类型，图形的颜色。默认从全局调色盘option.color获取颜色。支持使用rgb(255,255,255)，rgba(255,255,255,1)，#fff等方式设置为纯色，也支持设置为渐变色和纹理填充，具体见option.Color类型，用于设置支持使用回调函数。回调函数格式如下：(params:Object)=>Color传入的是数据项seriesIndex,dataIndex,data,value等各个参数。◆series-pie.itemStyle.borderColor='#000'Color类型，用于设置图形的描边颜色。支持的颜色格式同color，不支持回调函数。◆series-pie.itemStyle.borderWidthnumber类型，用于设置描边线宽。为0时无描边。◆series-pie.itemStyle.borderType='solid'string或number或Array类型，用于设置描边类型。其取值可选项为：'solid'、'dashed'、'dotted'。自v5.0.0开始，也可以是number或者number数组，用以指定线条的dasharray，配合borderDashOffset可实现更灵活的虚线效果。例如：{borderType:[5,10],borderDashOffset:5}◆series-pie.itemStyle.borderDashOffsetnumber类型，从v5.0.0开始支持，用于设置虚线的偏移量，可搭配borderType指定dasharray实现灵活的虚线效果。◆series-pie.itemStyle.borderCap='butt'string类型，从v5.0.0开始支持用于指定线段末端的绘制方式，其取值可选项为：①'butt'：线段末端以方形结束。②'round'：线段末端以圆形结束。③'square'：线段末端以方形结束，但是增加了一个宽度和线段相同，高度是线段厚度一半的矩形区域。默认值为'butt'。◆series-pie.itemStyle.borderJoin='bevel'string类型，从v5.0.0开始支持，用于设置2个长度不为0的相连部分（线段，圆弧，曲线）如何连接在一起的属性（长度为0的变形部分，其指定的末端和控制点在同一位置，会被忽略）。其取值可选项为：①'bevel'：在相连部分的末端填充一个额外的以三角形为底的区域，每个部分都有各自独立的矩形拐角。②'round'：通过填充一个额外的，圆心在相连部分末端的扇形，绘制拐角的形状。圆角的半径是线段的宽度。③'miter'：通过延伸相连部分的外边缘，使其相交于一点，形成一个额外的菱形区域。这个设置可以通过borderMiterLimit属性看到效果。默认值为'bevel'。◆series-pie.itemStyle.borderMiterLimit=10number类型，从v5.0.0开始支持，用于设置斜接面限制比例。只有当borderJoin为miter时，borderMiterLimit才有效。默认值为10。负数、0、Infinity和NaN均会被忽略。◆series-pie.itemStyle.shadowBlurnumber类型，用于设置图形阴影的模糊大小。该属性配合shadowColor,shadowOffsetX,shadowOffsetY一起设置图形的阴影效果。示例代码：{shadowColor：'rgba(0,0,0,0.5)',shadowBlur:10}◆series-pie.itemStyle.shadowColorColor类型，用于设置阴影颜色。支持的格式同color。◆series-pie.itemStyle.shadowOffsetXnumber类型，用于设置阴影水平方向上的偏移距离。◆series-pie.itemStyle.shadowOffsetYnumber类型，用于设置阴影垂直方向上的偏移距离。◆series-pie.itemStyle.opacity=1number类型，用于设置图形透明度。支持从0到1的数字，为0时不绘制该图形。◆series-pie.itemStyle.decalObject类型，用于设置图形的贴花图案，在aria.enabled与aria.decal.show都是true的情况下才生效。如果为'none'表示不使用贴花图案。◆series-pie.itemStyle.borderRadiusnumber或string或Array类型，从v5.0.0开始支持，用于指定饼图扇形区块的内外圆角半径，支持设置固定数值或者相对于扇形区块的半径的百分比值。从v5.3.0开始，支持分别配置从内到外顺时针方向四个角的圆角半径，百分比值从相对于内外扇形的半径更改为相对于内外扇形的半径差。例如：☆v5.3.0之前：

borderRadius:10：表示内圆角半径和外圆角半径都是10px。

borderRadius:'20%'：表示内圆角半径和外圆角半径都是扇形区块半径的20%。

borderRadius:[10,20]：表示为环形图时，内圆角半径是10px、外圆角半径是20px。

borderRadius:['20%','50%']：表示为环形图时，内圆角半径是内圆半径的20%、外圆角半径是外圆半径的50%。☆v5.3.0之后：

borderRadius:10：表示内圆角半径和外圆角半径都是10px。

borderRadius:'20%'：表示内圆角半径和外圆角半径都是扇形区块半径的20%。

borderRadius:[10,20]：表示为环形图时，内圆角半径是10px、外圆角半径是20px。

borderRadius:['20%','50%']：表示为环形图时，内圆角半径是内外圆半径差的20%、外圆角半径是内外圆半径差的50%。

borderRadius:[5,10,15,20]：表示内圆角半径分别为5px和10px，外圆角半径分别为15px和20px。（33）series-pie.emphasisObject类型，用于设置高亮状态的扇区和标签样式。◆series-pie.emphasis.disabledboolean类型，从v5.3.0开始支持，是否关闭高亮状态。关闭高亮状态可以在鼠标移到图形上，tooltip触发，或者图例联动的时候不再触发高亮效果。在图形非常多的时候可以关闭以提升交互流畅性。◆series-pie.emphasis.scale=trueboolean类型，从v5.0.0开始支持，是否开启高亮后扇区的放大效果。◆series-pie.emphasis.scaleSize=10number类型，从v5.0.0开始支持，高亮后扇区的放大尺寸，在开启emphasis.scale后有效。◆series-pie.emphasis.focus='none'string类型，从v5.0.0开始支持，在高亮图形时，是否淡出其它数据的图形已达到聚焦的效果。支持如下配置：①'none'不淡出其它图形，默认使用该配置。②'self'只聚焦（不淡出）当前高亮的数据的图形。③'series'聚焦当前高亮的数据所在的系列的所有图形。示例代码：下面代码配置了柱状图在高亮一个图形的时候，淡出当前直角坐标系所有其它的系列。emphasis:{focus:'series',blurScope:'coordinateSystem'}◆series-pie.emphasis.blurScope='coordinateSystem'string类型，从v5.0.0开始支持，在开启focus的时候，可以通过blurScope配置淡出的范围。支持如下配置①'coordinateSystem'淡出范围为坐标系，默认使用该配置。②'series'淡出范围为系列。③'global'淡出范围为全局。◆series-pie.emphasis.labelObject类型。◆series-pie.emphasis.labelLineObject类型。◆series-pie.emphasis.itemStyleObject类型。（34）series-pie.blurObject类型，从v5.0.0开始支持，淡出状态的扇区和标签样式。开启emphasis.focus后有效。◆series-pie.blur.labelObject类型。◆series-pie.blur.labelLineObject类型。◆series-pie.blur.itemStyleObject类型。（35）series-pie.selectObject类型，从v5.0.0开始支持，用于设置选中状态的扇区和标签样式。开启selectedMode后有效。◆series-pie.select.disabledboolean类型，从v5.3.0开始支持，是否可以被选中。在开启selectedMode的时候有效，可以用于关闭部分数据。◆series-pie.select.labelObject类型。◆series-pie.select.labelLineObject类型。◆series-pie.select.itemStyleObject类型。（36）series-pie.center=['50%','50%']Array类型，用于设置饼图的中心（圆心）坐标，数组的第一项是横坐标，第二项是纵坐标。支持设置成百分比，设置成百分比时第一项是相对于容器宽度，第二项是相对于容器高度。示例代码：//设置成绝对的像素值center:[400,300]//设置成相对的百分比center:['50%','50%']◆series-pie.radius=[0,'75%']number或string或Array类型，用于设置饼图的半径。可以为如下类型：①number：直接指定外半径值。②string：例如，'20%'，表示外半径为可视区尺寸（容器高宽中较小一项）的20%长度。③Array.<number|string>：数组的第一项是内半径，第二项是外半径。每一项遵从上述numberstring的描述。可以将内半径设大显示成圆环图（Donutchart）。（37）series-pie.seriesLayoutBy='column'string类型，用于设置当使用dataset时，seriesLayoutBy指定了dataset中用行还是列对应到系列上，也就是说，系列“排布”到dataset的行还是列上。其取值可选项为：①'column'：默认，dataset的列对应于系列，从而dataset中每一列是一个维度（dimension）。②'row'：dataset的行对应于系列，从而dataset中每一行是一个维度（dimension）。（38）series-pie.datasetIndexnumber类型，用于设置如果series.data没有指定，并且dataset存在，那么就会使用dataset。datasetIndex指定本系列使用哪个dataset。（39）series-pie.dimensionsArray类型，用于设置使用dimensions定义series.data或者dataset.source的每个维度的信息。注意：如果使用了dataset，那么可以在dataset.dimensions中定义dimension，或者在dataset.source的第一行/列中给出dimension名称。于是就不用在这里指定dimension。但如果在这里指定了dimensions，那么优先使用这里的。例如：option={dataset:{source:[//有了上面dimensions定义后，下面这五个维度的名称分别为：//'date','open','close','highest','lowest'[12,44,55,66,2],[23,6,16,23,1],…]},series:{type:'xxx',//定义了每个维度的名称。这个名称会被显示到默认的tooltip中。dimensions:['date','open','close','highest','lowest']}}series:{type:'xxx',dimensions:[null,//如果此维度不想给出定义，则使用null即可{type:'ordinal'},//只定义此维度的类型。//'ordinal'表示离散型，一般文本使用这种类型。//如果类型没有被定义，会自动猜测类型。{name:'good',type:'number'},'bad'//等同于{name:'bad'}]}dimensions数组中的每一项其取值可选项为：☆string，如'someName'，等同于{name:'someName'}☆Object，属性可以有：

name:string。

type:string，支持△number，默认，表示普通数据。△ordinal，对于类目、文本这些string类型的数据，如果需要能在数轴上使用，须是'ordinal'类型。ECharts默认会自动判断这个类型。但是自动判断也是不可能很完备的，所以使用者也可以手动强制指定。△float，即Float64Array。△int，即Int32Array。△time，表示时间类型。设置成'time'则能支持自动解析数据成时间戳（timestamp），例如该维度的数据是'9月-05-10'，会自动被解析。时间类型的支持参见data。

displayName:一般用于tooltip中维度名的展示。string如果没有指定，默认使用name来展示。值得一提的是，当定义了dimensions后，默认tooltip中对个维度的显示，会变为『竖排』，从而方便显示每个维度的名称。如果没有定义dimensions，则默认tooltip会横排显示，且只显示数值没有维度名称可显示。（40）series-pie.encodeObject类型，可以定义data的哪个维度被编码成什么。例如：option={dataset:{source:[//每一列称为一个『维度』。//这里分别是维度0、1、2、3、4。[12,44,55,66,2],[23,6,16,23,1],…]},series:{type:'xxx',encode:{x:[3,1,5],//表示维度3、1、5映射到x轴。y:2,//表示维度2映射到y轴。tooltip:[3,2,4]//表示维度3、2、4会在tooltip中显示。}}}当使用dimensions给维度定义名称后，encode中可直接引用名称，例如：series:{type:'xxx',dimensions:['date','open','close','highest','lowest'],encode:{x:'date',y:['open','close','highest','lowest']}}encode声明的基本结构如下，其中冒号左边是坐标系、标签等特定名称，如'x','y','tooltip'等，冒号右边是数据中的维度名（string格式）或者维度的序号（number格式，从0开始计数），可以指定一个或多个维度（使用数组）。通常情况下，下面各种信息不需要所有的都写，按需写即可。特殊地，在自定义系列（customseries）中，encode中轴可以不指定或设置为null/undefined，从而使系列免于受这个轴控制，也就是说，轴的范围（extent）不会受此系列数值的影响，轴被dataZoom控制时也不会过滤掉这个系列：varoption={xAxis:{},yAxis:{},dataZoom:[{xAxisIndex:0},{yAxisIndex:0}],series:{type:'custom',renderItem:function(params,api){return{type:'circle',shape:{cx:100,//x位置永远为100cy:api.coord([0,api.value(0)])[1],r:30},style:{fill:'blue'}};},encode:{//这样这个系列就不会被x轴以及x//轴上的dataZoom控制了。x:-1,y:1},data:[…]}};（41）series-pie.dataGroupIdstring类型，用于设置该系列所有数据项的组ID，优先级低于groupId。详见series.data.groupId。（42）series-pie.dataArray类型，用于设置系列中的数据内容数组。数组项可以为单个数值，如：[12,34,56,10,23]如果需要在数据中加入其它维度给visualMap组件用来映射到颜色等其它图形属性。每个数据项也可以是数组，如：[[12,14],[34,50],[56,30],[10,15],[23,10]]这时候可以将每项数组中的第2个值指定给visualMap组件。更多时候我们需要指定每个数据项的名称，这时候需要每个项为一个对象：[{//数据项的名称name:'数据1',//数据项值8value:10},{name:'数据2',value:20}]需要对个别内容指定进行个性化定义时：[{name:'数据1',value:10},{//数据项名称name:'数据2',value:56,//自定义特殊tooltip，仅对该数据项有效tooltip:{},//自定义特殊itemStyle，仅对该item有效itemStyle:{}}]（43）series-pie.markPointObject类型，用于设置图表标注。（44）series-pie.markLineObject类型，用于设置图表标线。（45）series-pie.markAreaObject类型，用于设置图表标域，常用于标记图表中某个范围的数据，例如标出某段时间（46）series-pie.silentboo