syncfusion-maui-linear-progressbar

.NET MAUI リニアプログレスバーの実装

Syncfusion® .NET MAUI リニアプログレスバー（SfLinearProgressBar）コントロールの実装とカスタマイズに関する包括的なガイドです。このコンポーネントは、長方形の形状でタスクの進捗を表示し、確定状態と不確定状態、セグメント、滑らかなアニメーション、範囲色を含むカスタマイズ可能な外観に対応しています。

このスキルを使用する場面

次のような場合に、このスキルを使用してください。

• 進捗インジケーターを実装する：ファイルのアップロード、ダウンロード、データ処理タスクなど
• 確定した進捗を表示する：完了率（0～100％）がわかっている場合
• 不確定な進捗を表示する：タスクの所要時間が不明、または計算できない場合
• バッファーの状態を可視化する：主進捗と副進捗の両方を表示する場合（例：動画のバッファリング）
• 複数セグメントのプログレスバーを作成する：連続したタスクや複数ステップのタスクの場合
• 進捗の外観をカスタマイズする：色、グラデーション、サイズ、角の丸み、アニメーションなど
• 範囲に基づく色を適用する：進捗の各ゾーン（成功、警告、危険）を異なる色で表示する場合
• 進捗アニメーションを追加する：カスタムの再生時間やイージング効果を設定する場合
• 進捗イベントを処理する：進捗の変化や完了に応じて動作する場合
• モダンな UI 効果を実装する：半透明のデザインにリキッドガラス効果を使用する場合

コンポーネントの概要

SfLinearProgressBar は、長方形の水平バーでタスクの進捗を表示する .NET MAUI コントロールです。次の機能に対応しています。

• 複数の状態：確定（進捗が既知）、不確定（所要時間が不明）、バッファー（二重進捗）
• セグメント：連続したタスク用に進捗を複数のセクションに分割
• 豊富なカスタマイズ：色、グラデーション、太さ、パディング、角の丸み
• 滑らかなアニメーション：設定可能な再生時間とイージング関数
• 範囲色：進捗範囲ごとに異なる色を設定
• イベント：進捗の変化と完了を追跡
• モダンな効果：洗練された半透明の UI を実現するリキッドガラス効果

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

次のような場合に参照してください。

• Linear ProgressBar コントロールをインストールして設定する
• NuGet パッケージ（Syncfusion.Maui.ProgressBar）を追加する
• Core ハンドラーを登録する
• 最初の基本的なプログレスバーを作成する
• 名前空間のインポートと初期化について理解する

進捗状態

📄 参照： references/states.md

次のような場合に参照してください。

• 確定状態（既定、進捗が既知）について理解する
• 所要時間が不明なタスクに不確定状態を有効にする
• 副進捗を使ってバッファー状態を実装する
• ユースケースに適した状態を選択する
• 複雑なシナリオで状態を組み合わせる

セグメント

📄 参照： references/segments.md

次のような場合に参照してください。

• 1 つのプログレスバーで複数の連続したタスクを可視化する
• SegmentCount を使用してプログレスバーをセグメントに分割する
• SegmentGapWidth でセグメント間の間隔をカスタマイズする
• 複数ステップの進捗を段階的に表示する

外観のカスタマイズ

📄 参照： references/appearance.md

次のような場合に参照してください。

• GradientStops を使って範囲色（単色またはグラデーション）を適用する
• トラック、進捗、副進捗の高さをカスタマイズする
• 進捗インジケーターの周囲のパディングを調整する
• 角を丸くするためにコーナー半径を設定する
• 進捗の塗りつぶし、トラックの塗りつぶし、副進捗の色を変更する

アニメーション

📄 参照： references/animation.md

次のような場合に参照してください。

• 状態ごとにアニメーションの再生時間を設定する
• イージング効果（Linear、CubicInOut、BounceIn など）を適用する
• SetProgress() メソッドを使って一度限りのアニメーション設定を上書きする
• 不確定アニメーションの動作をカスタマイズする
• 滑らかでインタラクティブな進捗遷移を作成する

範囲のカスタマイズ

📄 参照： references/range.md

次のような場合に参照してください。

• カスタムの Minimum 値と Maximum 値を定義する
• パーセンテージの代わりに係数値（0.0～1.0）を使用する
• 特定のシナリオに合わせて進捗範囲を調整する
• 標準外の進捗スケールを扱う

イベント

📄 参照: references/events.md

以下が必要な場合：

• ProgressChanged イベントを処理して、進行状況の更新に応答する
• 進行状況が最大値に達したときに ProgressCompleted イベントを処理する
• 進行状況の値に応じて外観を動的に変更する
• 進行状況の節目に応じて実行されるカスタムロジックを実装する

Liquid Glass エフェクト

📄 参照: references/liquid-glass-effect.md

以下が必要な場合：

• プログレスバーにモダンな半透明のガラスエフェクトを適用する
• プログレスバーを SfGlassEffectView で囲む
• ガラスの外観にするために透明な背景を設定する
• 洗練された現代的な UI デザインを実装する
• プラットフォーム要件を確認する（macOS 26+、iOS 26+、.NET 10）