syncfusion-aspnetcore-lineargauge について
ASP.NET Core プロジェクトで数値ゲージを実装する開発者向けの Syncfusion Linear Gauge ガイドです。ポインター、範囲、注釈、操作機能を扱い、温度や進捗、監視指標の表示に役立ちます。
主な機能
- 01Marker・Bar ポインター
- 02値の範囲を色分け
- 03テキスト・画像・HTML 注釈
- 04ドラッグ・ツールチップ・イベント
- 05ポインターのアニメーションと外観設定
- 06印刷と画像エクスポート
活用シーン
- 01温度や速度を表示
- 02進捗インジケーターを作成
- 03ダッシュボードで実績値と目標値を比較
- 04リアルタイムに変化する値を監視
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ syncfusion/ aspnetcore-ui-components-skills --skill syncfusion-aspnetcore-lineargaugeインストール後、Claude Code で/syncfusion-aspnetcore-lineargaugeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/advanced-features.mdannotations.mdapi-reference.mdappearance-and-styling.mdexamples-and-use-cases.mdgauge-dimensions.mdgetting-started.mdinteractions-and-events.mdpointers-and-indicators.mdranges-and-values.md詳細
Syncfusion Linear Gauge の実装
このスキルを使用する場面
次のような場合にこのスキルを使用します。
- 数値を線形ゲージ形式で表示する場合(温度、速度、パフォーマンス指標など)
- ドラッグ可能なポインターを備えたインタラクティブなゲージを作成する場合
- 線形スケール上の範囲やしきい値を可視化する場合
- ゲージに注釈やカスタム要素を追加する場合
- リアルタイムのデータ更新に対応したダッシュボードゲージを実装する場合
- 温度計スタイルや進捗インジケーターのコンポーネントを構築する場合
コンポーネントの概要
Linear Gauge コンポーネントは、軸の数値を線形形式で可視化します。すべての要素は Scalable Vector Graphics(SVG)を使用して描画されます。主な機能は次のとおりです。
- 複数のポインター - Marker と Bar のポインタータイプに対応
- 範囲のハイライト - 値のゾーンを強調表示する色範囲を定義
- 注釈 - ゲージ上の任意の場所にテキスト、画像、HTML 要素を追加
- インタラクティブ機能 - ポインターのドラッグ&ドロップ、ツールチップ、イベント
- アニメーション - 読み込み時や値の変更時に滑らかなポインターアニメーションを実行
- カスタマイズ - 色、テーマ、枠線、スケール、コンテナータイプ(Normal、RoundedRectangle、Thermometer)
- アクセシビリティ - スクリーンリーダーに対応し、WCAG 2.2 に準拠
- 印刷とエクスポート - ゲージ画像の印刷とエクスポート
クイックスタートの例
Linear Gauge の最小限の実装例を示します。
<ejs-lineargauge id="linear" title="Temperature Gauge" orientation="Horizontal">
<e-lineargauge-axes>
<e-lineargauge-axis minimum="0" maximum="200">
<e-lineargauge-ranges>
<e-lineargauge-range start="0" end="50" color="blue"></e-lineargauge-range>
<e-lineargauge-range start="50" end="150" color="green"></e-lineargauge-range>
<e-lineargauge-range start="150" end="200" color="red"></e-lineargauge-range>
</e-lineargauge-ranges>
<e-lineargauge-pointers>
<e-lineargauge-pointer value="75" type="Bar"></e-lineargauge-pointer>
</e-lineargauge-pointers>
</e-lineargauge-axis>
</e-lineargauge-axes>
</ejs-lineargauge>
よくあるパターン
パターン 1:温度表示
- 温度計コンテナーを使用した垂直方向の配置
- 範囲の色:青(低温)、緑(通常)、赤(高温)
- 現在の温度を示す単一の Bar ポインター
パターン 2:進捗インジケーター
- パーセンテージ値を使用した水平方向の配置
- 0~100 の単一範囲
- 完了率を示す Bar ポインター
パターン 3:ダッシュボード指標
- 複数の範囲を使用した水平方向の配置
- 実績値と目標値を示す Marker ポインター
- ラベルやメモ用の注釈
パターン 4:リアルタイム監視
ValueChangeイベントへのイベントバインド- 指定した期間でのポインターアニメーション
- ホバー時の情報を表示するツールチップ
ドキュメントとナビゲーションガイド
はじめに
📄 参照: references/getting-started.md
- インストールとパッケージのセットアップ
- Linear Gauge の基本的な実装
- CSS のインポートとテーマの設定
- 初期設定と描画
ゲージの寸法
📄 参照: references/gauge-dimensions.md
- コンテナーのサイズと寸法(ピクセルまたはパーセンテージ)
- 向き(水平/垂直)
- サイズの設定
- レスポンシブ動作と余白の制御
範囲と値
📄 参照: references/ranges-and-values.md
- 範囲の定義と色
- 複数範囲の設定
- 値のバインドと軸のスケーリング
- 最小値/最大値
- 範囲のスタイル設定とグラデーションカラー
ポインターとインジケーター
📄 参照: references/pointers-and-indicators.md
- ポインターの種類とスタイル(Marker、Bar)
- Marker の形状(Circle、Rectangle、Triangle、Diamond、Image、Text)
- アニメーションと移動
- 複数のポインター
- ポインターのスタイル設定とカスタマイズ
外観とスタイル設定
📄 参照: references/appearance-and-styling.md
- 外観のカスタマイズ
- コンテナータイプ(Normal、RoundedRectangle、Thermometer)
- 色とテーマ
- タイトルのスタイル設定
- 枠線とスケール
- ラベルのカスタマイズ
インタラクションとイベント
📄 参照: references/interactions-and-events.md
- クリックイベントとドラッグ操作
- 値変更イベント
- アニメーション完了イベント
- マウスイベント(押下、移動、解放、離脱)
- ツールチップの描画と処理
注釈
📄 参照: references/annotations.md
- テキストと画像の注釈を追加
- 注釈の配置(x、y 座標)
- Z インデックスとレイヤー
- 水平方向と垂直方向の配置
- 複数の注釈
高度な機能
📄 参照: references/advanced-features.md
- アクセシビリティ(WCAG 2.2、スクリーンリーダー)
- 印刷およびエクスポート機能
- 国際化(i18n)
- API のメソッドとプロパティ
- RTL サポート
例とユースケース
📄 参照: references/examples-and-use-cases.md
- ダッシュボードのゲージ
- 速度インジケーター
- 温度表示
- パフォーマンス指標
- 実際のパターンとベストプラクティス