スパークライン

Ignite UI for React スパークライン コンポーネントは、軽量なチャート コントロールです。グリッド セル内などのコンパクトなレイアウト内でのレンダリングを目的としていますが、単独でレンダリングすることもできます。

スパークライン コントロールには、チャートの種類、マーカー、範囲、トレンドライン、不明な値のプロット、ツールチップなど、構成およびカスタマイズが可能ないくつかの視覚的要素とそれに対応する機能があります。

サンプル

依存関係

Ignite UI for React スパークライン コンポーネントを使用するには、以下のパッケージをインストールする必要があります。

  • npm install --save igniteui-react-core
  • npm install --save igniteui-react-charts

スパークライン コンポーネントには、以下のモジュールのインポートが必要です。

import { IgrSparklineModule } from "igniteui-react-charts/ES5/igr-sparkline-module";
import { IgrSparklineCoreModule } from "igniteui-react-charts/ES5/igr-sparkline-core-module";
import { SparklineDisplayType } from 'igniteui-react-charts/ES5/SparklineDisplayType';

IgrSparklineCoreModule.register();
IgrSparklineModule.register();

スパークラインのタイプ

$ ProductName $ スパークライン コンポーネントは、以下のスパークライン タイプをサポートしています。

タイプは displayType プロパティの設定により定義されます。displayType プロパティが指定されていない場合は、既定では Line 型が表示されます。

Win/Loss スパークライン タイプは、柱状のチャート タイプです。ここでは、各列の値はデータセットの正の最大値 (正の値の場合) または負の最小値 (負の値の場合) に等しくなり、多くの場合 Win または Loss (または似たような相反する概念) を意味します。Win/Loss スパークラインを正しく表示するには、データセットには正の値と負の値が必要です。

Win/Loss スパークラインが、数値のコレクションにバインドできる Line タイプなどの他のタイプと同じデータにバインドされている場合、スパークライン コンポーネントはそのコレクションから最大値と最小値の 2 つの値を選択し、それらの値に基づいてスパークラインをレンダリングします。

<IgrSparkline height="200px" width="400px"
    dataSource={this.data}
    valueMemberPath="Value"
    displayType="Area" />

マーカー

Ignite UI for React スパークライン コンポーネントを使用すると、マーカーをシリーズ上の円形のアイコンとして表示して、X/Y 座標に基づいて個々のデータポイントを示すことができます。マーカーは、表示タイプが Line、Area、および Column のスパークラインに設定できます。Win/Loss 型のスパークラインは、現在マーカーを設定できません。既定では、マーカーは表示されません。

スパークライン内のマーカーは、以下の場所を任意に組み合わせて配置できます。

  • すべて: スパークライン内のすべてのデータ ポイントにマーカーを表示します。
  • 低値: 最低値のデータ ポイントにマーカーを表示します。最小値に複数の点がある場合は、その値を持つ各点に表示されます。
  • 高値: 最低値のデータ ポイントにマーカーを表示します。最高値に複数のポイントがある場合は、その値を持つ各ポイントに表示されます。
  • 始値: スパークラインの最初のデータポイントにマーカーを表示します。
  • 終値: スパークラインの最後のデータ ポイントにマーカーを表示します。
  • 負数: スパークラインにプロットされた負のデータ点にマーカーを表示します。

上記のすべてのマーカーは、色、可視性、およびサイズの観点で関連マーカー タイプのプロパティを使用してカスタマイズできます。たとえば、上記の Low マーカーは、lowMarkerBrushlowMarkerVisibilitylowMarkerSize の各プロパティを持ちます。

<IgrSparkline
    highMarkerVisibility="Visible"
    lowMarkerVisibility="Visible"
    firstMarkerVisibility="Visible"
    lastMarkerVisibility="Visible"
    negativeMarkerVisibility="Visible"
    markerVisibility="Collapsed"
    markerSize={10}
    firstMarkerSize={10}
    lastMarkerSize={10}
    lowMarkerSize={10}
    highMarkerSize={10}
    negativeMarkerSize={10}/>

標準範囲

Ignite UI for React スパークライン コンポーネントの通常の範囲機能は、データが視覚化されているときに定義済みの意味のある範囲を表す水平方向の縞模様です。標準範囲は、指定した色のアウトラインで網掛けエリアとして設定できます。

通常の範囲は、最大データ ポイントよりも広い場合もあれば、それを超える場合もあります。また、しきい値インジケータとして機能するように、スパークラインの Line 表示タイプと同じ幅にすることもできます。正常範囲の幅は、正常範囲を表示するために最低限必要な以下の 3 つのプロパティによって決まります。

既定では、標準範囲は表示されません。有効にすると、標準範囲は薄い灰色の外観で表示されますが、normalRangeFill プロパティを使用して構成することもできます。

DisplayNormalRangeInFront プロパティを設定することで、スパークライン コンポーネントのプロットされたシリーズの前または後ろに標準範囲を表示するかどうかを設定することもできます。

<IgrSparkline
    normalRangeVisibility="Visible"
    normalRangeMinimum={1}
    normalRangeMaximum={4}
    normalRangeFill="rgba(255, 0, 0, 0.4)"
    displayNormalRangeInFront="true"  />

トレンドライン

Ignite UI for React スパークライン コンポーネントは、実際のスパークライン レイヤーの上に別のレイヤーとして表示される一連のトレンドラインをサポートしています。近似曲線を表示するには、trendLineType プロパティを使用します。

近似曲線は、チャートがバインドされているデータの値を使用して、trendLineType プロパティで指定されたアルゴリズムに従って計算されます。

近似曲線は一度に 1 つだけ表示でき、デフォルトでは近似曲線は表示されません。

サポートされている近似曲線のリストは以下にあります。

  • None
  • CubicFit
  • CumulativeAverage
  • ExponentialAverage
  • ExponentialFit
  • LinearFit
  • LogarithmicFit
  • ModifiedAverage
  • PowerLawFit
  • QuadraticFit
  • QuarticFit
  • QuinticFit
  • SimpleAverage
  • WeightedAverage

以下のコード例は、Ignite UI for React スパークライン コンポーネントで近似曲線を有効にする方法を示しています。

<IgrSparkline
    trendLineThickness={3}
    trendLinePeriod={5}
    trendLineType="ExponentialFit"
    trendLineBrush="Red"  />

不明な値の補間

Ignite UI for React スパークライン コンポーネントは、不明な値を検出し、指定された補間アルゴリズムを介して不明な値のためのスペースを描画することができます。データに null 値が含まれていて、この機能を使用しない場合、つまり補間が指定されていない場合、不明な値はプロットされません。

未知の値をプロットするために、スパークライン コンポーネントの unknownValuePlotting プロパティを設定することができます。

<IgrSparkline
    unknownValuePlotting="LinearInterpolate" />