在 ECharts 新发布的 3.7 版本 中,广泛地增加了标签的表现力。可以支持定制文本块的样式,也支持对文本片段应用特定的样式,如设置颜色、大小、背景、图片、对齐方式等,从而可以做出丰富的效果。另外增加了可滚动的图例,从而对图例过多显示不下的问题,提供了一种解决方案。
富文本标签原先 echarts 中的文本标签,只能对整块统一进行样式设置,并且仅仅支持颜色和字体的设置,从而导致不易于制作表达能力更强的文字描述信息。 echarts v3.7 以后,支持了富文本标签,能够: 能够定制文本块整体的样式(如背景、边框、阴影等)、位置、旋转等。 能够对文本块中个别片段定义样式(如颜色、字体、高宽、背景、阴影等)、对齐方式等。 能够在文本中使用图片做小图标或者背景。 特定组合以上的规则,可以做出简单表格、分割线等效果。
例子: Map Labels, Pie Labels, Gauge. 为了支持这些样式设置,echarts 提供了丰富的文本配置属性,包括: 字体基本样式设置:fontStyle, fontWeight, fontSize, fontFamily。 文字颜色:color。 文字描边:textBorderColor, textBorderWidth。 文字阴影:textShadowColor, textShadowBlur, textShadowOffsetX, textShadowOffsetY。 文本块或文本片段大小:lineHeight, width, height, padding。 文本块或文本片段的对齐:align, verticalAlign。 文本块或文本片段的边框、背景(颜色或图片):backgroundColor, borderColor, borderWidth, borderRadius。 文本块或文本片段的阴影:shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY。 文本块的位置和旋转:position,distance, rotate。
详情参见教程:富文本标签 可滚动图例有不少人会遇到这种问题:图例项数过多,导致覆盖住下面的图,或者甚至超出可视区域,难看而不可接受。之前遇到这种问题时,会建议大家自己使用
HTML 来实现外置的图例,调用 echarts 提供的图例相关 API 完成和 echarts
交互。但是,自己实现,毕竟有开发量,所以,终于在这个版本中,给出了一种能翻页图例控件,为这类问题提供了一种可选择的解决方案。 具体设置,可参见:legend.type。 标签文本配置的扁平化在 echarts 中有众多的 textStyle 设置,例如 series-bar.label.normal.textStyle、xAxis.axisLabel.textStyle 等等。这些 textStyle 有些层级过深和语法冗余,导致不方便,所以进行了扁平化,去掉了他们的 textStyle 这个层级。 也就是说,从前是这种写法:label.normal.textStyle.fontSize、axisLabel.textStyle.fontSize。 v3.7 之后,推荐这种写法 label.normal.fontSize、axisLabel.fontSize。 当然,之前的写法仍然被兼容。 有这些地方进被扁平化了: axisPointer.textStyle.xxx => axisPointer.xxx xAxis.axisLabel.textStyle.xxx => xAxis.axisLabel.xxx yAxis.axisLabel.textStyle.xxx => yAxis.axisLabel.xxx radar.axisLabel.textStyle.xxx => radar.axisLabel.xxx singleAxis.axisLabel.textStyle.xxx => singleAxis.axisLabel.xxx radiusAxis.axisLabel.textStyle.xxx => radiusAxis.axisLabel.xxx angleAxis.axisLabel.textStyle.xxx => angleAxis.axisLabel.xxx parallel.parallelAxisDefault.axisLabel.textStyle.xxx => parallel.parallelAxisDefault.xxx parallelAxis.axisLabel.textStyle.xxx => parallelAxis.axisLabel.xxx series.label[normal|emphasis].textStyle.xxx => series.label[normal|emphasis].xxx series.data.label[normal|emphasis].textStyle.xxx => series.data.label[normal|emphasis].xxx series-gauge.axisLabel.textStyle.xxx => series-gauge.axisLabel.xxx series-gauge.title.textStyle.xxx => series-gauge.title.xxx series-gauge.detail.textStyle.xxx => series-gauge.detail.xxx series-treemap.upperLabel[normal|emphasis].textStyle.xxx => series-treemap.upperLabel[normal|emphasis].xxx calendar.dayLabel.textStyle.xxx => calendar.dayLabel.xxx series-graph.edgeLabel[normal|emphasis].textStyle.xxx => series-graph.edgeLabel[normal|emphasis].xxx calendar.dayLabel.textStyle.xxx => calendar.dayLabel.xxx calendar.monthLabel.textStyle.xxx => calendar.monthLabel.xxx calendar.yearLabel.textStyle.xxx => calendar.yearLabel.xxx markPoint.label[normal|emphasis].textStyle.xxx => markPoint.label[normal|emphasis].xxx markPoint.data.label[normal|emphasis].textStyle.xxx => markPoint.data.label[normal|emphasis].xxx markLine.label[normal|emphasis].textStyle.xxx => markLine.label[normal|emphasis].xxx markLine.data.label[normal|emphasis].textStyle.xxx => markLine.data.label[normal|emphasis].xxx markArea.label[normal|emphasis].textStyle.xxx => markArea.label[normal|emphasis].xxx markArea.data.label[normal|emphasis].textStyle.xxx => markArea.data.label[normal|emphasis].xxx tooltip.axisPointer.crossStyle.textStyle.xxx => tooltip.axisPointer.crossStyle.xxx axisPointer.label.textStyle.xxx => axisPointer.label.xxx timeline.label.textStyle.xxx => timeline.label.xxx radar.name.textStyle.xxx => radar.name.xxx
此外,还有一些其他的细节增强和 BUG FIX,例如: 更多的升级信息,参见 changelog。 下载地址 |