Blazor ラジアル ゲージの概要
Blazor Radial Gauge コンポーネントは、針、目盛り、範囲、ラベルなどの視覚要素をサポートし、定義済みの図形やスケールを表示できます。IgbRadialGauge には、アニメーション化されたトランジションのサポートも組み込まれています。アニメーションは、TransitionDuration プロパティの設定で簡単にカスタマイズできます。
Blazor ラジアル ゲージの例
以下のサンプルは、同じ IgbRadialGauge でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。
IgniteUI.Blazor パッケージの追加については、以下のトピックを参照してください。
以下の名前空間を追加してコントロールの実装を開始できます。
Afterwards you may start implementing the control by adding the following namespaces:
@using IgniteUI.Blazor.Controls
モジュールの要件
Ignite UI for Blazor のサービスを登録します。
// in Program.cs file
builder.Services.AddIgniteUIBlazor();
IgbRadialGauge のクライアント リソース モジュールである IgbRadialGaugeModule の登録は任意です。コンポーネントは初めてレンダリングされるときにリソースを読み込みます。ただし、builder.Services.AddIgniteUIBlazor(typeof(IgbRadialGaugeModule)) のように指定すると、リソースを事前に読み込んだり、クライアント側でのみ作成される要素に対応したりできます (コンポーネント モジュールを参照)。
使用方法
以下のコードは針およびスケールで 3 つの比較範囲を含むラジアル ゲージを作成する方法を紹介します。
<IgbRadialGauge
Height="400px"
Width="400px"
MinimumValue="0"
MaximumValue="100"
Value="25"
Interval="5">
<IgbRadialGaugeRange
StartValue="0"
EndValue="30"
Brush="Red" />
<IgbRadialGaugeRange
StartValue="30"
EndValue="60"
Brush="Yellow" />
<IgbRadialGaugeRange
StartValue="60"
EndValue="100"
Brush="Green" />
</IgbRadialGauge>
バッキング
ゲージには、スケールの後ろ側に描かれた背景図形があり、図形はゲージの背景として動作します。
バッキング要素はラジアル ゲージ コントロールの背景と境界線を表します。常に最初に描画される要素で針、ラベルやメモリなどの残りの要素はその上のオーバーレイです。
バッキングは、円形またはフィットにできます。円形の場合は 360 度の円形のゲージが作成されますが、一方フィット図形の場合は ScaleStartAngle および ScaleEndAngle プロパティで円弧部分が塗りつぶされます。これには、BackingShape プロパティを設定します。
<IgbRadialGauge
Height="300px"
Width="300px"
MinimumValue="0"
MaximumValue="80"
Value="50"
Interval="10"
BackingShape="RadialGaugeBackingShape.Fitted"
BackingBrush="rgba(252, 252, 252, 1)"
BackingOutline="DodgerBlue"
BackingOversweep="5"
BackingCornerRadius="10"
BackingStrokeThickness="5"
BackingOuterExtent="0.8"
BackingInnerExtent="0.15"
ScaleStartAngle="135"
ScaleEndAngle="45" />
スケール
スケールは視覚要素で、MinimumValue と MaximumValue 値を設定してゲージの値範囲全体をハイライト表示できます。バッキングとともにゲージの全体的な図形を定義します。ScaleStartAngle と ScaleEndAngle プロパティは、スケールの円弧の境界線を定義します。ScaleSweepDirection プロパティが、スケールが時計回りまたは反時計回りのどちらの方向に動くかを指定します。ScaleBrush、ScaleStartExtent、ScaleEndExtent プロパティを設定してスケールの外観をカスタマイズできます。
<IgbRadialGauge
Height="300px"
Width="300px"
MinimumValue="0"
MaximumValue="80"
Value="50"
Interval="10"
ScaleStartAngle="135"
ScaleEndAngle="45"
ScaleBrush="DodgerBlue"
ScaleSweepDirection="SweepDirection.Clockwise"
ScaleOversweep="1"
ScaleOversweepShape="RadialGaugeScaleOversweepShape.Fitted"
ScaleStartExtent="0.45"
ScaleEndExtent="0.575" />
ラベルとタイトル
ゲージ ラベルは MinimumValue と MaximumValue の値の間で指定された間隔で数値を表示する視覚要素です。0 はゲージ中央、1 はゲージ バッキングの外側範囲を表す LabelExtent プロパティで小数を使用してラベルの配置を設定できます。FontBrush や IgbRadialGauge.Font など、さまざまなスタイル プロパティを設定してラベルをカスタマイズできます。
これらの針のラベルにはそれぞれ、TitleExtent、TitleAngle、SubtitleFontSize、HighlightLabelBrush など、フォント、角度、ブラシ、ゲージの中心からの距離を変更するために適用できるさまざまなスタイル属性があります。
<IgbRadialGauge
Height="300px"
Width="300px"
MinimumValue="0"
MaximumValue="80"
Value="50"
Interval="10"
LabelInterval="10"
LabelExtent="0.65"
Font="11px Verdana"
FontBrush="DodgerBlue" />
タイトルとサブタイトル
TitleText プロパティと SubtitleText プロパティが使用可能であり、どちらも針のカスタム テキストを表示するために使用できます。あるいは、TitleDisplaysValue と SubtitleDisplaysValue を true に設定すると、針の値が表示され、TitleText と SubtitleText がオーバーライドされます。したがって、タイトルにカスタム テキストを使用しながらサブタイトルで値を表示したり、その逆を行ったりすることができます。
以下に説明するように針のハイライトが表示されている場合は、HighlightLabelText を介してカスタム テキストを表示できます。それ以外の場合は、HighlightLabelDisplaysValue を有効にしてその値を表示できます。
<IgbRadialGauge
TitleText="Global Sales"
SubtitleText="2024" />
オプティカル スケーリング
ラジアル ゲージのラベルとタイトルにより、スケーリングを変更できます。これを有効にするには、まず OpticalScalingEnabled を true に設定します。次に、ラベルが 100% のオプティカル スケーリングを持つサイズを管理する OpticalScalingSize を設定できます。ゲージのサイズが大きくなると、ラベルのフォントも大きくなります。たとえば、このプロパティが 500 に設定され、ゲージのピクセル単位のサイズが 2 倍の 1000 になると、ラベルのフォント サイズは 200% 大きくなります。
目盛
目盛は、ラジアル ゲージの中央から放射状に表示される細い線です。目盛には、主目盛および副目盛の 2 種類があり、主目盛りは MinimumValue と MaximumValue の間の IgbRadialGauge.Interval に表示されます。また MinorTickCount プロパティは、隣接する 2 つの主目盛間の副目盛の数を指定します。目盛りの長さは、TickStartExtent、TickEndExtent、MinorTickStartExtent、MinorTickEndExtent に少数値 (0 から 1 の間) を設定して制御できます。
<IgbRadialGauge
Height="300px"
Width="300px"
MinimumValue="0"
MaximumValue="80"
Value="50"
Interval="10"
TickStartExtent="0.45"
TickEndExtent="0.575"
TickStrokeThickness="2"
TickBrush="DodgerBlue"
MinorTickCount="4"
MinorTickStartExtent="0.575"
MinorTickEndExtent="0.5"
MinorTickStrokeThickness="1"
MinorTickBrush="DarkViolet" />
範囲
範囲に MinimumValue や MaximumValue プロパティで指定した連続値の境界をハイライト表示します。開始値と終了値を指定してゲージに複数の範囲を追加でき、各範囲には、IgbRadialGaugeRange.Brush や IgbRadialGaugeRange.Outline などのカスタマイズ プロパティがあります。または、RangeBrushes や RangeOutlines プロパティを範囲の色リストに設定することもできます。
<IgbRadialGauge
Height="300px"
Width="300px"
MinimumValue="0"
MaximumValue="80"
Value="50"
Interval="10"
RangeBrushes="Red Yellow Green"
RangeOutlines="Red Yellow Green">
<IgbRadialGaugeRange
StartValue="5"
EndValue="15"
Brush="Red" />
<IgbRadialGaugeRange
StartValue="15"
EndValue="35"
Brush="Yellow" />
<IgbRadialGaugeRange
StartValue="35"
EndValue="45"
Brush="Green" />
</IgbRadialGauge>
針
ゲージ針は、ゲージの設定値を示す視覚要素です。針は、あらかじめ定義されたいくつかの図形の中から選択でき、ピボット図形をゲージの中心に配置できます。またピボット図形は、事前に定義された図形の 1 つを使用します。オーバーレイとアンダーレイを含むピボット図形には、図形に適用する別のピボット ブラシがあります。
サポートされている針の形とキャップは、NeedleShape と NeedlePivotShape プロパティで設定します。
ゲージのインタラクティブ モードを有効 (IsNeedleDraggingEnabled プロパティを使用) にするとユーザーは MinimumValue と MaximumValue の値間で針をドラッグして値を変更できるようになります。
<IgbRadialGauge
Height="300px"
Width="300px"
MinimumValue="0"
MaximumValue="80"
Value="50"
Interval="10"
IsNeedleDraggingEnabled="true"
IsNeedleDraggingConstrained="true"
NeedleShape="RadialGaugeNeedleShape.NeedleWithBulb"
NeedleBrush="DodgerBlue"
NeedleOutline="DodgerBlue"
NeedleEndExtent="0.475"
NeedleStrokeThickness="1"
NeedlePivotShape="RadialGaugePivotShape.CircleOverlay"
NeedlePivotBrush="rgba(159, 159, 160, 1)"
NeedlePivotOutline="rgba(159, 159, 160, 1)"
NeedlePivotWidthRatio="0.2"
NeedlePivotStrokeThickness="1" />
針のハイライト
ラジアル ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の IgbRadialGauge.Value の不透明度が低く表示されます。これを有効にするには、まず HighlightValueDisplayMode を Overlay に設定し、次に HighlightValue を適用します。
<IgbRadialGauge
Height="100%"
Width="100%"
MinimumValue="0"
MaximumValue="100"
Value="30"
Interval="10"
LabelInterval="10"
LabelExtent="0.65"
IsHighlightNeedleDraggingEnabled="true"
HighlightValueDisplayMode="HighlightedValueDisplayMode.Overlay"
HighlightValue="50"
HighlightLabelDisplaysValue="true"
HighlightLabelSnapsToNeedlePivot="true" />
まとめ
上記すべてのコード スニペットを以下のコード ブロックにまとめています。プロジェクトに簡単にコピーしてブレットグラフのすべての機能を再現できます。
<IgbRadialGauge
Height="300px"
Width="300px"
MinimumValue="0"
MaximumValue="80"
Value="50"
Interval="10"
TitleText="Global Sales"
SubtitleText="2024"
BackingShape="RadialGaugeBackingShape.Fitted"
BackingBrush="rgba(252, 252, 252, 1)"
BackingOutline="DodgerBlue"
BackingOversweep="5"
BackingCornerRadius="10"
BackingStrokeThickness="5"
BackingOuterExtent="0.8"
BackingInnerExtent="0.15"
ScaleStartAngle="135"
ScaleEndAngle="45"
ScaleBrush="DodgerBlue"
ScaleSweepDirection="SweepDirection.Clockwise"
ScaleOversweep="1"
ScaleOversweepShape="RadialGaugeScaleOversweepShape.Fitted"
ScaleStartExtent="0.45"
ScaleEndExtent="0.575"
LabelInterval="10"
LabelExtent="0.65"
Font="11px Verdana"
FontBrush="DodgerBlue"
TickStartExtent="0.45"
TickEndExtent="0.575"
TickStrokeThickness="2"
TickBrush="DodgerBlue"
MinorTickCount="4"
MinorTickStartExtent="0.575"
MinorTickEndExtent="0.5"
MinorTickStrokeThickness="1"
MinorTickBrush="DarkViolet"
IsNeedleDraggingEnabled="true"
IsNeedleDraggingConstrained="true"
NeedleShape="RadialGaugeNeedleShape.NeedleWithBulb"
NeedleBrush="DodgerBlue"
NeedleOutline="DodgerBlue"
NeedleEndExtent="0.475"
NeedleStrokeThickness="1"
NeedlePivotShape="RadialGaugePivotShape.CircleOverlay"
NeedlePivotBrush="rgba(159, 159, 160, 1)"
NeedlePivotOutline="rgba(159, 159, 160, 1)"
NeedlePivotWidthRatio="0.2"
NeedlePivotStrokeThickness="1"
IsHighlightNeedleDraggingEnabled="true"
HighlightValueDisplayMode="HighlightedValueDisplayMode.Overlay"
HighlightValue="50"
HighlightLabelDisplaysValue="true"
HighlightLabelSnapsToNeedlePivot="true"
RangeBrushes="Red Yellow Green"
RangeOutlines="Red Yellow Green">
<IgbRadialGaugeRange
StartValue="5"
EndValue="15"
Brush="Red" />
<IgbRadialGaugeRange
StartValue="15"
EndValue="35"
Brush="Yellow" />
<IgbRadialGaugeRange
StartValue="35"
EndValue="45"
Brush="Green" />
</IgbRadialGauge>
API リファレンス
IgbRadialGauge
IgbRadialGaugeRange
その他のリソース
その他のゲージ タイプの詳細については、以下のトピックを参照してください。