$npx -y skills add syncfusion/maui-ui-components-skills --skill syncfusion-maui-ratingImplements Syncfusion .NET MAUI Rating (SfRating) control. Use when implementing star ratings, review systems, feedback mechanisms, or product ratings in MAUI apps. Covers rating control configuration, star rating, half-star rating, custom rating shapes, rating precision, and rat
| 1 | # Implementing .NET MAUI Rating |
| 2 | |
| 3 | A comprehensive skill for implementing the Syncfusion .NET MAUI Rating control. The `SfRating` control provides a flexible and customizable rating interface with support for various precision modes, shapes, and styling options. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | Use this skill when users need to: |
| 8 | - Implement star ratings or review systems in MAUI applications |
| 9 | - Create product rating displays (e.g., e-commerce apps) |
| 10 | - Build feedback mechanisms for user experiences |
| 11 | - Display or collect ratings with custom precision (full, half, exact) |
| 12 | - Use custom rating shapes (heart, diamond, circle, or custom paths) |
| 13 | - Style rating controls with custom colors and strokes |
| 14 | - Handle rating value changes through events |
| 15 | - Create read-only rating displays |
| 16 | - Implement any rating UI component in .NET MAUI |
| 17 | |
| 18 | ## Component Overview |
| 19 | |
| 20 | The `SfRating` control is part of the `Syncfusion.Maui.Inputs` package and provides: |
| 21 | |
| 22 | - **Flexible Precision**: Standard (full), Half (half-step), or Exact (precise) rating modes |
| 23 | - **Multiple Shapes**: Star, Heart, Diamond, Circle, or custom SVG paths |
| 24 | - **Rich Customization**: Colors, strokes, sizes, spacing, and styling |
| 25 | - **Interactive & Display Modes**: Editable or read-only ratings |
| 26 | - **Event Support**: ValueChanged event for handling rating changes |
| 27 | - **Easy Integration**: Simple XAML and C# APIs |
| 28 | |
| 29 | **Common Use Cases:** |
| 30 | - Product reviews (1-5 stars) |
| 31 | - Movie/content ratings |
| 32 | - User feedback forms |
| 33 | - Service quality ratings |
| 34 | - Skill level indicators |
| 35 | - Preference selections |
| 36 | |
| 37 | ## Documentation and Navigation Guide |
| 38 | |
| 39 | ### Getting Started |
| 40 | 📄 **Read:** [references/getting-started.md](references/getting-started.md) |
| 41 | - Installation and NuGet package setup (`Syncfusion.Maui.Inputs`) |
| 42 | - Handler registration in `MauiProgram.cs` |
| 43 | - Basic `SfRating` implementation in XAML and C# |
| 44 | - Setting `ItemCount` and `Value` properties |
| 45 | - Namespace imports and initial setup |
| 46 | - Simple rating example |
| 47 | |
| 48 | ### Precision and Accuracy |
| 49 | 📄 **Read:** [references/precision-modes.md](references/precision-modes.md) |
| 50 | - **Standard Precision**: Full item rating (whole stars) |
| 51 | - **Half Precision**: Half-step rating (half stars) |
| 52 | - **Exact Precision**: Precise decimal rating |
| 53 | - Choosing the right precision mode |
| 54 | - Use cases for each precision type |
| 55 | - Code examples for all modes |
| 56 | |
| 57 | ### Visual Customization |
| 58 | 📄 **Read:** [references/rating-shapes.md](references/rating-shapes.md) |
| 59 | - Predefined shapes (Star, Heart, Diamond, Circle) |
| 60 | - Custom shapes with SVG path data |
| 61 | - Path property and sizing guidelines |
| 62 | |
| 63 | 📄 **Read:** [references/appearance-styling.md](references/appearance-styling.md) |
| 64 | - Item size and spacing configuration |
| 65 | - Fill colors (RatedFill, UnratedFill) |
| 66 | - Stroke colors and thickness |
| 67 | - RatingSettings comprehensive guide |
| 68 | - Design best practices |
| 69 | |
| 70 | ### Interactive Features |
| 71 | 📄 **Read:** [references/interactive-features.md](references/interactive-features.md) |
| 72 | - IsReadOnly property for display-only ratings |
| 73 | - ValueChanged event handling |
| 74 | - User interaction control |
| 75 | - Event data and scenarios |
| 76 | - Data binding with events |