Destacar elementos do Chart

Pré-requisitos

Antes de começar, instale a versão 2.1.0 ou posterior do Charts Embedding JavaScript SDK.

Sintaxe

O método do SDK JavaScript de incorporação de Charts para habilitar o realce tem a seguinte sintaxe:

charts.setHighlight(selectionFilter);

dashboard.getChart('<chartID>');

O método setHighlight usa um filtro. Você pode fornecer o filtro MQL diretamente para o método setHighlight, conforme mostrado no exemplo abaixo, ou por meio da carga útil do evento de clique selectionFilter para destacar elementos específicos e clicar em eventos.

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

O selectionFilter deve corresponder aos valores usados na categoria ou no canal da série do gráfico.

O Charts Embedding JavaScript SDK também inclui a opção highlight para recuperar a query de destaque:

const highlight = chart.getHighlight();

A opção highlight usa um parâmetro de um objeto JavaScript que representa um filtro. Você pode definir a opção highlight ao criar um gráfico ou após a renderização de um gráfico.

Você pode incluir os seguintes elementos de query:

• Correspondência$eq (equality) para todos os tipos de gráficos suportados.

• $in para todos os tipos de gráficos suportados.

• $nin verifica se há Charts de Linha e Área, Charts de Colunas e Barras e Mapa de Calor não geográfico.

• $gte e $lt intervalo fechado para corresponder a compartimentos de número ou data dentro do intervalo especificado para Chartsde Linha e Área, Charts de Colunas e Barras e Mapa de Calor não geográfico.

• Qualquer combinação de $gt, $gte, $lt e $lte faixa aberta no eixo X para Charts de linha e área contínuas.

Tipos de Gráfico

Os seguintes tipos de gráficos suportam realce programático:

• Gráfico coroplético

• Gráficos de colunas e barras

• Tabela

• Gráfico de donuts

• Gráficos de linha e área

• Mapa de calornão geográfico