Blazor スパークラインの概要

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

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

Blazor スパークラインの例

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

@code {
    protected override void OnInitialized()
    {
        SparklineModule.Register(IgniteUIBlazor);
    }
}

スパークラインのタイプ

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

  • Area
  • Column
  • Line
  • WinLoss

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

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

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

<Sparkline Height="100%"
    Width="100%"
    DataSource="DataSource"
    DisplayType="SparklineDisplayType.Area"
    ValueMemberPath="Value"
    LabelMemberPath="Angle" />

マーカー

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

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

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

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

<Sparkline Height="100%"
    Width="100%"
    DataSource="DataSource"
    Minimum="-3"
    Maximum="8"
    MarkerVisibility="Visibility.Visible"
    HighMarkerVisibility="Visibility.Visible"
    LowMarkerVisibility="Visibility.Visible"
    FirstMarkerVisibility="Visibility.Visible"
    LastMarkerVisibility="Visibility.Visible"
    NegativeMarkerVisibility="Visibility.Visible"
    MarkerSize="10"
    FirstMarkerSize="1"
    LastMarkerSize="10"
    LowMarkerSize="10"
    HighMarkerSize="10"
    NegativeMarkerSize="10" />

標準範囲

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

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

  • NormalRangeVisibility: 標準範囲が表示されるかどうか。
  • NormalRangeMaximum: 範囲の下境界線。
  • NormalRangeMinimum: 範囲の上境界線。

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

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

<Sparkline Height="100%"
    Width="100%"
    DataSource="DataSource"
    NormalRangeVisibility="Visibility.Visible"
    NormalRangeMinimum="1"
    NormalRangeMaximum="4"
    NormalRangeFill="rgba(255, 0, 0, 0.4)"
    DisplayNormalRangeInFront="true" />

トレンドライン

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

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

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

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

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

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

<Sparkline Height="100%"
    Width="100%"
    DataSource="DataSource"
    TrendLineThickness="3"
    TrendLinePeriod="5"
    TrendLineType="TrendLineType.ExponentialFit"
    TrendLineBrush="Red" />

不明な値の補間

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

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

<Sparkline Height="100%"
    Width="100%"
    DataSource="DataSource"
    UnknownValuePlotting="UnknownValuePlotting.LinearInterpolate"/>

データ グリッドのスパークライン

Ignite UI for Blazor スパークライン コンポーネントは、データ グリッドのテンプレート列またはテンプレートをサポートする他のコンポーネントに埋め込むことができます。以下のコード例ではその方法を示します。

<DataGrid Height="100%" Width="100%"
          RowHeight="90"
          AutoGenerateColumns="false"
          DataSource="DataSource">    
    <TemplateColumn Field="OrderHistory" Width="@("*>180")" HeaderText="Order History" >                     
        <Template>
            <RenderFragment>
                 <div style="width: 100%; height: 70px; background: transparent">
                     <Sparkline Height="100%" Width="100%"
                                DataSource="@((context.RowItem as Product).OrderHistory)"
                                DisplayType="SparklineDisplayType.Line"
                                ValueMemberPath="Sold"
                                LabelMemberPath="Week"
                                Brush="rgb(21, 190, 6)">
                     </Sparkline>
                 </div>
            </RenderFragment>
        </Template>
    </TemplateColumn>
</DataGrid>