ECharts v3.7 发布：增加富文本标签、可滚动图例

内容简介：在 ECharts 新发布的 3.7 版本 中，广泛地增加了标签的表现力。可以支持定制文本块的样式，也支持对文本片段应用特定的样式，如设置颜色、大小、背景、图片、对齐方式等，从而可以做出丰富的效果。另外增加了可...

在 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，例如：

• [+] 对于时间坐标轴（即 axis.type 为 'time'）支持了 minInterval。对于时间坐标轴和数值坐标轴（即 axis.type 为 'value'）支持了 maxInterval，从而能控制缩放（如 dataZoom）时刻度的最大最小范围。

• [+] 支持了 xAxis.axisLine.onZeroAxisIndex，从而能在多轴并且需要轴 onZero 的场景下，灵活设置轴互相的对应关系。参见 #5069。

• [+] 支持了 自定义系列(custom series) 不使用 坐标系。

• [+] 支持了柱状图标签的旋转。参见 rotate、align、verticalAlign。参见 #5309。

• [+] 支持了 radar.indicator.color，从而雷达每个标签能设置不同颜色。参见 #6128。

• [+] 支持了 dataZoom.rangeMode，从而能在数据更新时固定缩放区域。参见 #6128。

• [+] 支持了 action.legend.legendToggleSelect, action.legend.legendSelect, action.legend.legendUnSelect 中使用 dataIndex。参见 #4242。

• [+] 支持了 map.label.formatter，从而方便于在地图系列中使用富文本标签。参见：地图标签。

更多的升级信息，参见 changelog。

下载地址

• Source code (zip)

• Source code (tar.gz)

• http://echarts.baidu.com/download.html

【声明】文章转载自：开源中国社区 [http://www.oschina.net]

以上所述就是小编给大家介绍的《ECharts v3.7 发布：增加富文本标签、可滚动图例》，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持！

查看所有标签

猜你喜欢:

• arcgis for js 展示地图图例
• Echarts关于tree树数据渲染图例最新实例
• uCharts高性能跨端图表推新啦，新增图例点击、标记线、词云图、漏斗图等重磅功能
• 基于标签特定文本表示的文本多标签分类
• 论文浅尝 | 通过文本到文本神经问题生成的机器理解
• 文本挖掘从小白到精通（三）---主题模型和文本数据转换

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。