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 se há Charts de linha e área, Charts de colunas e barras e mapa de calor não geográfico.$gtee intervalo fechado para corresponder ao número ou$ltàs caixas de data dentro do intervalo especificado para Charts de Linha e Área , Charts de Colunas e Barras e Mapa de Calor não geográfico.Qualquer combinação
$gtde,,$gte$lte faixa aberta no eixo X$ltepara Charts de linha e área contínuas.
Tipos de Gráfico
Os seguintes tipos de gráficos suportam realce programático:
Mapa de calornão geográfico