mcpField
S
syncfusion-aspnetcore-lineargauge

syncfusion-aspnetcore-lineargauge

github.com/syncfusionデザイン・UI053 回インストール2 週間前に更新
リポジトリ

syncfusion-aspnetcore-lineargauge について

ASP.NET Core プロジェクトで数値ゲージを実装する開発者向けの Syncfusion Linear Gauge ガイドです。ポインター、範囲、注釈、操作機能を扱い、温度や進捗、監視指標の表示に役立ちます。

主な機能

  1. 01Marker・Bar ポインター
  2. 02値の範囲を色分け
  3. 03テキスト・画像・HTML 注釈
  4. 04ドラッグ・ツールチップ・イベント
  5. 05ポインターのアニメーションと外観設定
  6. 06印刷と画像エクスポート

活用シーン

  1. 01温度や速度を表示
  2. 02進捗インジケーターを作成
  3. 03ダッシュボードで実績値と目標値を比較
  4. 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.md
annotations.md
api-reference.md
appearance-and-styling.md
examples-and-use-cases.md
gauge-dimensions.md
getting-started.md
interactions-and-events.md
pointers-and-indicators.md
ranges-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

  • ダッシュボードのゲージ
  • 速度インジケーター
  • 温度表示
  • パフォーマンス指標
  • 実際のパターンとベストプラクティス

コメント