echarts-option属性legend详解

setOption({
	legend：{//图例组件
		type:'plain||scroll',//图例的类型。默认plain,当使用scroll时,需要其他属性配置细节
		scrollDataIndex:number,//type 为 'scroll' 时有效。
		//图例当前最左上显示项的 dataIndex
		//setOption 时指定此项的话，可决定当前图例滚动到哪里。
		//但是，如果仅仅想改变图例翻页，一般并不调用 setOption（因为这太重量了），仅仅使用 action legendScroll 即可。
		pageButtonItemGap:number,//type 为 'scroll' 时有效。图例控制块中，按钮和页信息之间的间隔。
		pageButtonGap:number,//type 为 'scroll' 时有效。图例控制块和图例项之间的间隔。
		pageButtonPosition:'start||end',//type 为 'scroll' 时有效。图例控制块的位置
		pageFormatter:string||function,//图例控制块中，页信息的显示格式。
		//默认为 '{current}/{total}'，其中 {current} 是当前页号（从 1 开始计数），{total} 是总页数。
		pageIcons:{//type 为 'scroll' 时有效。图例控制块的图标。
			horizontal:array,//orient 为 'horizontal' 时的翻页按钮图标。
			vertical:array,//orient 为 'vertical' 时的翻页按钮图标。
			//是一个数组，表示 [previous page button, next page button]。
			//默认值为 ['M0,0L12,-10L12,10z', 'M0,0L-12,-10L-12,10z']。
			//数组中每项可以通过 'image://url' 设置为图片
		},
		pageIconColor:color,//type 为 'scroll' 时有效。翻页按钮的颜色。
		pageIconInactiveColor:color,//type 为 'scroll' 时有效。翻页按钮不激活时（即翻页到头时）的颜色。
		pageIconSize:number,//type 为 'scroll' 时有效。翻页按钮的大小。可以是数字，也可以是数组，如 [10, 3]，表示 [宽，高]。
		pageTextStyle:{Object},//type 为 'scroll' 时有效。图例页信息的文字样式。
		id:'string',//组件id
		show:boolean,//是否展示图例
		zlevel:number,//图例的zlevel值
		z:number,//图例的z值
		top:'auto'||number,//top 的值可以是 'top', 'middle', 'bottom'
		//如果 top 的值为'top', 'middle', 'bottom'，组件会根据相应的位置自动对齐。
		left:'auto'||number,//left的值可以是 'left', 'center', 'right'
		//如果 left 的值为'left', 'center', 'right'，组件会根据相应的位置自动对齐。
		right:'auto'||number,
		bottom:'auto'||number,
		//图例距离容器的距离，默认自适应
		width:'auto'||number,
		height:'auto'||number,
		//图例的宽高，默认自适应
		orient:'horizontal||vertical',//图例的布局朝向
		align:'auto||left||right',//图例标记和文本的对齐方式,默认自动。
		//根据组件的位置和 orient 决定
		//当组件的left值为'right'以及纵向布局（orient 为 'vertical'）的时候为右对齐，为'right'。
		padding:number||array,//标题内边距，单位px，默认各方向内边距为5，接受数组分别设定边距。
		//示例
		//padding: 5,设置内边距为 5
		//padding: [5, 10],设置上下的内边距为 5，左右的内边距为 10
		//padding:[5,10,15,20],分别设置上右下左边距为5，10，15，20
		itemGap:number,//图例每项之间的间隔。横向布局时为水平间隔，纵向布局时为纵向间隔。
		itemWidth:number,
		itemHeight:number,
		//图例标记的图形宽高。
		itemStyle:{//图例的图形样式。其属性的取值为 'inherit' 时，表示继承系列中的属性值。
			color:color,//颜色
			borderColor:color,//描边颜色
			borderWidth:'auto'||number,
			//当其值为 "auto" 时，如果系列有 borderWidth 取 2，如果系列没有 borderWidth 则取 0。
			//当其值为 "inehrit" 时，始终取系列的 borderWidth。
			borderType:'solid||dashed||dotted'
			//自 v5.0.0 开始，也可以是 number 或者 number 数组，用以指定线条的 dash array，
			//配合 borderDashOffset 可实现更灵活的虚线效果。
			borderDashOffset:number,//从 v5.0.0 开始支持
			//用于设置虚线的偏移量，可搭配 borderType 指定 dash array 实现灵活的虚线效果。
			//例子：{borderType: [5, 10],borderDashOffset: 5}
			borderCap:'butt||round||square',//用于指定线段末端的绘制方式,从 v5.0.0 开始支持
//butt：线段末端以方形结束
//round：线段末端以圆形结束
//square：线段末端以方形结束,但是增加了一个宽度和线段相同,高度是线段厚度一半的矩形区域。
			borderJoin:'bevel||round||miter'//从 v5.0.0 开始支持
			//用于设置2个长度不为0的相连部分（线段，圆弧，曲线）如何连接在一起的属性
			//（长度为0的变形部分，其指定的末端和控制点在同一位置，会被忽略）。
//bevel：在相连部分的末端填充一个额外的以三角形为底的区域， 每个部分都有各自独立的矩形拐角。
//round：通过填充一个额外的，圆心在相连部分末端的扇形，绘制拐角的形状。 圆角的半径是线段的宽度。
//miter：通过延伸相连部分的外边缘，使其相交于一点，形成一个额外的菱形区域。这个设置可以通过 borderMiterLimit 属性看到效果。
			borderMiterLimit:number,//从 v5.0.0 开始支持
			//用于设置斜接面限制比例。只有当 borderJoin 为 miter 时， borderMiterLimit 才有效。
			//默认值为 10。负数、0、Infinity 和 NaN 均会被忽略。
			shadowBlur:number,//图形阴影的模糊大小
			//该属性配合 shadowColor,shadowOffsetX, shadowOffsetY 一起设置图形的阴影效果。
			shadowColor:color,//阴影颜色
			shadowOffsetX:number,//阴影水平偏移距离
			shadowOffsetY:number//阴影垂直偏移距离
			opacity:number,//图形透明度。支持从 0 到 1 的数字，为 0 时不绘制该图形。
			decal:'none'||Object
			//图形的贴花图案，在 aria.enabled 与 aria.decal.show 都是 true 的情况下才生效。
			//如果为 'none' 表示不使用贴花图案。
			{
				symbol:string||array,//贴花的图案，如果是 string[] 表示循环使用数组中的图案。
				//ECharts 提供的标记类型包括:
				//'circle', 'rect', 'roundRect', 'triangle', 'diamond', 'pin', 'arrow', 'none'
				//可以通过 'image://url' 设置为图片，其中 URL 为图片的链接，或者 dataURI。
				//可以通过 'path://' 将图标设置为任意的矢量路径
				symbolSize:number,//取值范围：0 到 1，表示占图案区域的百分比。
				symbolKeepAspect:boolean,//是否保持图案的长宽比。
				color:color,//贴花图案的颜色，建议使用半透明色，这样能叠加在系列本身的颜色上。
				backgroundColor:color,//贴花的背景色，将会覆盖在系列本身颜色之上，贴花图案之下。
				dashArrayX:number||array,
				dashArrayY:number||array,
				//贴花图案的基本模式是在横向和纵向上分别以图案 - 空白 - 图案 - 空白 - 图案 - 空白的形式无限循环。通过设置每个图案和空白的长度，可以实现复杂的图案效果。
				//dashArrayX 控制了横向的图案模式。当其值为 number 或 number[] 类型时，与 SVG stroke-dasharray 类似。
				//如果是 number 类型，表示图案和空白分别是这个值。如 5 表示先显示宽度为 5 的图案，然后空 5 像素，再然后显示宽度为 5 的图案
				//如果是 number[] 类型，则表示图案和空白依次为数组值的循环。如：[5, 10, 2, 6] 表示图案宽 5 像素，然后空 10 像素，然后图案宽 2 像素，然后空 6 像素，然后图案宽 5 像素
				//如果是 (number | number[])[] 类型，表示每行的图案和空白依次为数组值的循环。如：[10, [2, 5]] 表示第一行以图案 10 像素空 10 像素循环，第二行以图案 2 像素空 5 像素循环，第三行以图案 10 像素空 10 像素循环
				rotation:-Math.PI —— Math.PI,//图案的整体旋转角度（弧度制）
				maxTileWidth:number,
				maxTileWidth:number
				//生成的图案在未重复之前的宽高上限。通常不需要设置该值，当你发现图案在重复的时候出现不连续的接缝时，可以尝试提高该值。
			},
		},
		lineStyle:{//图例图形中线的样式，用于诸如折线图图例横线的样式设置。其属性的取值为 'inherit' 时，表示继承系列中的属性值
			color:color,//颜色
			width:number,//线宽
			type:string||number||array,//线的类型。
			//string类型的值：solid,dashed,dotted
			//自 v5.0.0 开始，也可以是 number 或者 number 数组，用以指定线条的 dash array，配合 dashOffset 可实现更灵活的虚线效果。
			dashOffset:number,//从 v5.0.0 开始支持,用于设置虚线的偏移量
			cap:'butt||round||square',//从 v5.0.0 开始支持,用于指定线段末端的绘制方式
			join:'bevel||round||miter'//从 v5.0.0 开始支持
			miterLimit:number,//从 v5.0.0 开始支持
			shadowBlur:number,//图形阴影的模糊大小
			//该属性配合 shadowColor,shadowOffsetX, shadowOffsetY 一起设置图形的阴影效果。
			shadowColor:color,//阴影颜色
			shadowOffsetX:number,//阴影水平偏移距离
			shadowOffsetY:number//阴影垂直偏移距离
			opacity:number,//图形透明度。支持从 0 到 1 的数字，为 0 时不绘制该图形。
		},
		symbolRotate:number,//圆形旋转角度
		formatter:string||function,//用来格式化图例文本，支持字符串模板和回调函数两种形式。
		selectedMode:string||boolean,
		//图例选择的模式，控制是否可以通过点击图例改变系列的显示状态。默认开启图例选择，可以设成 false 关闭。
		//除此之外也可以设成 'single' 或者 'multiple' 使用单选或者多选模式。
		inactiveColor:color,//图例关闭时的颜色
		inactiveBorderColor:color,//图例关闭时的描边颜色
		inactiveBorderWidth:number,//图例关闭时的描边粗细
		selected:{Object},//图例选中状态表
		textStyle:{Object},//图例的公用文本样式。
		tooltip:{Object},//图例的 tooltip 配置，配置项同 tooltip。默认不显示，可以在 legend 文字很多的时候对文字做裁剪并且开启 tooltip
		icon:string,//图例项的 icon。
		//ECharts 提供的标记类型包括:'circle', 'rect', 'roundRect', 'triangle', 'diamond', 'pin', 'arrow', 'none'
		//可以通过 'image://url' 设置为图片，其中 URL 为图片的链接，或者 dataURI
		//可以通过 'path://' 将图标设置为任意的矢量路径
		data:array,//图例的数据数组。[{name , icon , itemStyle , lineStyle , symbolRotate , textStyle}]
		backgroundColor:color,//图例背景颜色，默认透明
		borderColor:color,//图例边框颜色
		borderWidth:number,//图例边框线宽
		borderRadius:number||array,//圆角半径
		shadowBlur:number,//图形阴影的模糊大小
		//该属性配合 shadowColor,shadowOffsetX, shadowOffsetY 一起设置图形的阴影效果。
		//注意：此配置项生效的前提是
		//设置了 show: true 以及值不为 tranparent 的背景色 backgroundColor。
		shadowColor:color,//阴影颜色
		shadowOffsetX:number,//阴影水平偏移距离
		shadowOffsetY:number//阴影垂直偏移距离
		animation:boolean,//图例翻页是否使用动画
		animationDurationUpdate:number,//图例翻页时的动画时长。
		emphasis:{},//legend所有属性
		selector:boolean,//图例组件中的选择器按钮，目前包括全选和反选两种功能。
		//默认不显示，用户可手动开启，也可以手动配置每个按钮的标题。
		//selector: [{type: 'all or inverse',title: '全选'},{type: 'inverse',title: '反选'}]或selector: ['all', 'inverse']或selector: true
		selectorLabel:{Object},//从 v4.4.0 开始支持。选择器按钮的文本标签样式，默认显示。
		selectorPosition:string,//从 v4.4.0 开始支持。
		//选择器的位置，可以放在图例的尾部或者头部，对应的值分别为 'end' 和 'start'。
		//默认情况下，图例横向布局的时候，选择器放在图例的尾部；图例纵向布局的时候，选择器放在图例的头部。
		selectorItemGap:number,//从 v4.4.0 开始支持。选择器按钮之间的间隔。
		selectorButtonGap:number,//从 v4.4.0 开始支持。选择器按钮与图例组件之间的间隔。
	}
})