syncfusion-maui-rating

.NET MAUI Rating の実装

Syncfusion .NET MAUI Rating コントロールを実装するための包括的なスキルです。SfRating コントロールは、さまざまな精度モード、図形、スタイル設定に対応した、柔軟でカスタマイズ可能な評価インターフェイスを提供します。

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

次のようなニーズがある場合に、このスキルを使用してください。

• MAUI アプリケーションで星評価やレビューシステムを実装する
• 商品の評価を表示する（例：E コマースアプリ）
• ユーザー体験に対するフィードバックの仕組みを構築する
• カスタム精度（整数、半分、正確な値）で評価を表示または収集する
• カスタム評価図形（ハート、ひし形、円、カスタムパス）を使用する
• カスタム色やストロークで評価コントロールをスタイル設定する
• イベントを通じて評価値の変更を処理する
• 読み取り専用の評価表示を作成する
• .NET MAUI で評価 UI コンポーネントを実装する

コンポーネントの概要

SfRating コントロールは Syncfusion.Maui.Inputs パッケージの一部で、次の機能を提供します。

• 柔軟な精度：標準（整数）、半分（0.5 刻み）、または正確（精密）な評価モード
• 複数の図形：星、ハート、ひし形、円、またはカスタム SVG パス
• 豊富なカスタマイズ：色、ストローク、サイズ、間隔、スタイル設定
• 操作モードと表示モード：編集可能な評価または読み取り専用の評価
• イベント対応：評価の変更を処理する ValueChanged イベント
• 簡単な統合：シンプルな XAML および C# API

一般的な使用例：

• 商品レビュー（1～5 個の星）
• 映画やコンテンツの評価
• ユーザーのフィードバックフォーム
• サービス品質の評価
• スキルレベルの指標
• 好みの選択

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

はじめに

📄 参照： references/getting-started.md

• インストールと NuGet パッケージの設定（Syncfusion.Maui.Inputs）
• MauiProgram.cs でのハンドラー登録
• XAML および C# での基本的な SfRating の実装
• ItemCount プロパティと Value プロパティの設定
• 名前空間のインポートと初期設定
• シンプルな評価の例

精度と正確さ

📄 参照： references/precision-modes.md

• 標準精度：アイテム単位の評価（整数の星）
• 半分の精度：半ステップの評価（半分の星）
• 正確な精度：小数点以下まで正確な評価
• 適切な精度モードの選択
• 精度の種類ごとの使用例
• すべてのモードのコード例

外観のカスタマイズ

📄 参照： references/rating-shapes.md

• 定義済みの図形（星、ハート、ひし形、円）
• SVG パスデータを使用したカスタム図形
• Path プロパティとサイズ設定のガイドライン

📄 参照： references/appearance-styling.md

• アイテムサイズと間隔の設定
• 塗りつぶし色（RatedFill、UnratedFill）
• ストロークの色と太さ
• RatingSettings の包括的なガイド
• デザインのベストプラクティス

インタラクティブ機能

📄 参照： references/interactive-features.md

• 表示専用の評価に使用する IsReadOnly プロパティ
• ValueChanged イベントの処理
• ユーザー操作の制御
• イベントデータとシナリオ
• イベントを使用したデータバインディング