O SDK JavaScript de incorporação de Charts permite que você destaque programaticamente elementos específicos e evento clicados em Atlas Charts incorporados e Atlas Charts dentro de dashboards incorporados.
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);
Observação
Se você quiser destacar Atlas Charts em um dashboard incorporado, primeiro execute o método a seguir para recuperar um Atlas Charts específico da instância do dashboard:
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.
Exemplo
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:
$eq (equality)correspondência para todos os tipos de gráficos suportados.$inpara todos os tipos de gráficos suportados.$ninverificação para Gráficos de Linha e Área, Gráficos de Colunas e Barras e Mapa de Calor não geográfico.$gtee$ltfaixa fechada para corresponder a compartimentos de número ou data dentro da faixa especificada para Line and Area Charts, Column and Bar Charts e Mapa de Calor não geográfico.
Tipos de Gráfico
Os seguintes tipos de gráficos suportam realce programático:
Mapa de calornão geográfico