El SDK de JavaScript para incrustación de Charts te permite resaltar programáticamente elementos específicos y eventos clicados en gráficos incrustados y gráficos dentro de tableros incrustados.
Requisitos previos
Antes de comenzar, instala la versión 2.1.0 o versiones posteriores del SDK de JavaScript Embedding de Charts.
Sintaxis
El método SDK de JavaScript para incrustar Charts permite resaltar tiene la siguiente sintaxis:
charts.setHighlight(selectionFilter);
Nota
Si desea resaltar gráficos dentro de un tablero integrado, primero ejecute el siguiente método para recuperar un gráfico específico de la instancia del tablero:
dashboard.getChart('<chartID>');
El método setHighlight toma un filtro. Puedes proporcionar el filtro MQL directamente al método setHighlight como se muestra en el ejemplo a continuación o a través de la carga útil del evento de click selectionFilter para resaltar elementos específicos y eventos de click.
Ejemplo
chart.setHighlight( { city: { $nin: ['New York', 'London', 'Paris'] } } )
La selectionFilter debe coincidir con los valores utilizados en el canal de categoría o serie de la gráfica.
El SDK de JavaScript para incrustación de Charts también incluye la opción highlight para recuperar la query de resaltado:
const highlight = chart.getHighlight();
La opción highlight toma un parámetro de un objeto Javascript que representa un filtro. Puede configurar la opción highlight al crear una gráfica o después de que se renderice una gráfica.
Puedes incluir los siguientes elementos de consulta:
$eq (equality)coincidir para todos los tipos de gráficas admitidas.$inpara todos tipos de gráficas admitidos.$ninconsultar en Line and Area Charts, Column and Bar Charts y Mapa de calor no geográfico.$gtey$ltrango cerrado para hacer coincidir la cantidad o los grupos de fechas dentro del rango especificado para Line and Area Charts, Column and Bar Charts, y no geo Mapa de calor.Cualquier combinación de
$gt,$gte,$lty$lteabre el rango en el eje X para Line and Area Chartscontinuas.
Tipos de gráficas
Los siguientes tipos de gráficas admiten el resaltado programático:
Non-geo Heatmap