チャート要素の強調表示
Charts 埋め込み JavaScript SDK を使用すると、埋め込みチャートや 埋め込みダッシュボード 内のチャート上の特定の要素と クリックされたイベント をプログラムで強調表示できます。
前提条件
始める前に、バージョン 2.1.0 をインストールしてください またはそれ以降の Charts埋め込み JavaScript SDK 。
構文
強調表示を有効にするための Charts 埋め込み JavaScript SDK メソッドの構文は次のとおりです。
charts.setHighlight(selectionFilter);
注意
埋め込みダッシュボード内のチャートを強調表示する場合は、まず次のメソッドを実行して、ダッシュボードのインスタンスから特定のチャートを取得します。
dashboard.getChart('<chartID>');
setHighlightメソッドはMQLフィルターを受け取ります。 以下の例に示すように、 setHighlightメソッドに直接、またはクリック イベント ペイロードselectionFilterを介して、特定の要素とクリック イベントを強調表示するために、MQL フィルターを メソッドに直接提供できます。
例
chart.setHighlight( { city: { $nin: ['New York', 'London', 'Paris'] } } )
selectionFilterは、チャートのカテゴリまたはシリーズ チャンネルで使用される値と一致する必要があります。
Charts 埋め込み JavaScript SDK には、ハイライト クエリを取得するためのhighlightオプションも含まれています。
const highlight = chart.getHighlight();
オプションは、 MQLフィルターを表す オブジェクトのパラメーターを受け取ります。highlightJavaScripthighlightオプションは、グラフを作成するとき、またはグラフがレンダリングされた後に設定できます。
次のクエリ要素を含めることができます。
サポートされているすべてのチャート タイプ との $eq（等価） 一致。
折れ線チャートと面Charts 、 縦棒チャートと横棒Charts 、および非 ジオメトリ ヒートマップ の $nin チェック。
$gte と $lt は、 折れ線チャートと面Charts 、 縦棒チャートと横棒Charts 、および非ジオメトリ ヒートマップ の指定された範囲内の数値または日付バイナリを照合するために使用されます 。
連続した 折れ線 チャート と 面チャートCharts の X 軸上のオープン範囲の $gt 、 $gte 、 $lt 、$lte の任意の組み合わせ
チャートの種類
次のチャート タイプは、プログラムによる強調表示をサポートしています。