突出显示图表元素

先决条件

开始之前，请安装2.1.0 版本 或更高版本的 Charts Embedding JavaScript SDK。

语法

用于启用突出显示的 Charts Embedding JavaScript SDK 方法采用以下语法：

charts.setHighlight(selectionFilter);

dashboard.getChart('<chartID>');

setHighlight 方法采用一个过滤器。您可以将 MQL 过滤器直接提供给 setHighlight 方法（如下示例所示），或通过 点击事件有效负载 selectionFilter 提供 MQL 过滤器，以突出显示特定元素和点击事件。

chart.setHighlight(
  {
    city: { $nin: ['New York', 'London', 'Paris'] }
  }
)

selectionFilter必须与图表类别或系列渠道上使用的值匹配。

Charts Embedding JavaScript SDK 还包括用于检索重点查询的highlight选项：

const highlight = chart.getHighlight();

highlight选项采用代表过滤器的 JavaScript 对象参数。您可以在创建图表时或图表渲染后设置 highlight 选项。

您可以包含以下查询元素：

• $eq (equality)匹配所有支持的图表类型。

• $in适用于所有支持的图表类型。

• $nin检查折线图和面积Charts、Charts和条形图以及非地理热图。

• $gte和$lt闭合范围，用于匹配折线图和面积Charts、Charts和条形图以及非地理热图中指定范围内的数字或日期分箱。

• $gt、$gte、$lt和$lte的任意组合在连续折线图和面积Charts的 X 轴上打开范围。

图表类型

以下图表类型支持编程突出显示：

• 分级统计图
• 柱状图和条形图
• 表格
• Donut Chart（环形图）
• 折线图和面积图

• 非地理热图