RatingViewControl 1.1.3-alpha

This is a prerelease version of RatingViewControl.

dotnet add package RatingViewControl --version 1.1.3-alpha

NuGet\Install-Package RatingViewControl -Version 1.1.3-alpha

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="RatingViewControl" Version="1.1.3-alpha" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add RatingViewControl --version 1.1.3-alpha

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: RatingViewControl, 1.1.3-alpha"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install RatingViewControl as a Cake Addin
#addin nuget:?package=RatingViewControl&version=1.1.3-alpha&prerelease

// Install RatingViewControl as a Cake Tool
#tool nuget:?package=RatingViewControl&version=1.1.3-alpha&prerelease

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Maui.RatingView

Maui.RatingView - is a cross platform plugin for MAUI which allow you to use the rating capabilities in your application with ease and flexibility.

Desktop

https://github.com/Eel2000/Maui.RatingView/assets/44249870/c764d534-39e2-446f-8d4e-eaf60ace56e4

Mobile(Android)

https://github.com/Eel2000/Maui.RatingView/assets/44249870/c40b60e8-dbe3-40ca-b0cd-9b0b55059c35

Getting Started with the Rating View Ccontrol

Configuration

Add the package reference to your project's .csproj file
Look for the RatingViewControl into your project's package manager

   dotnet add package RatingViewControl --version 1.1.2-alpha

Using the control

First Add the reference to the control into your xaml file like this

xmlns:rv="clr-namespace:RatingView.Views;assembly=RatingView"

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:rv="clr-namespace:RatingView.Views;assembly=RatingView"
             x:Class="MauiApp2.MainPage">

</ContentPage>

Then use the control in your xaml page like shown below.

 <rv:RatingControl Maximum="6" Size="40" Fill="Red" Value="3" />

Attributes and use

Attribute	Description
Shape	the shape to display. the is 4 supported types (Heart,Like,Displike,Star)
Maximum	the maximun rating value. the default maximum value is `5`
Size	the size of the shape. the default shape's size is `20px`
Fill	The color used when the shape is filled. the default color is `Orange`
Value	support double values, the current rate value
EmptyColor	The color of filling when the shape is empty. the default color is `White`
StrokeColor	The color of the shape's stroke. the default value is `Gray`
StrokeThickness	The thickness of the shape's stroke. the default value is `7px`
Spacing	defines the space between drawn shapes. By default the space defined is `10px`
AllowRating	A boolean value which define if the click event can be handled to change(update) the rating value
Command	Used when the `AllowRating` is defined to `True` this command attribute can be used to perfom a specifique action on rating value changed
CommandParameter	of type of object which is the parameter passed to the command when executed. Note that this parameter when handle in your code will be of type of `Rating` object which is the model containt int the library it has 2 Properties `Value` : which is the rating value `Paramter` : the command parameter passed from the xaml page
BindControl	This property allows to bind a specique rating view to another one, usefull in some scenario. Eg : Youtube Liking behavior
Animate	This property define is the Shape scale should change when Touched or Overlayed (For Desktop App only at this time )

Examples

Liking fingers

 <VerticalStackLayout Spacing="5">
    <Label Text="Liking" HorizontalOptions="Center"/>
    <HorizontalStackLayout Spacing="10" HorizontalOptions="CenterAndExpand">
        <rv:RatingControl x:Name="likedBtn" Maximum="1" Value="{Binding Liked}" Size="40" AllowRating="True"
               Fill="ForestGreen" Command="{Binding LikeDislikeCommand}" BindControl="{x:Reference unLikedBtn}"
                      StrokeThickness="5" Shape="Like"/>

        <rv:RatingControl x:Name="unLikedBtn" Maximum="1" Value="{Binding UnLiked}" Size="40" AllowRating="True"
                          Fill="DarkRed" Command="{Binding LikeDislikeCommand}" 
                          BindControl="{x:Reference likedBtn}"
                          StrokeThickness="5" Shape="Dislike"/>
    </HorizontalStackLayout>
</VerticalStackLayout>

Output

https://github.com/Eel2000/Maui.RatingView/assets/44249870/94e49c5a-15ae-4eae-91d7-d2f310ec8e14

Linking Heart

<rv:RatingControl Maximum="1" 
                  Size="40" 
                  Fill="Red" 
                  Shape="Heart" 
                  AllowRating="True" />

OutPut

https://github.com/Eel2000/Maui.RatingView/assets/44249870/ce31a3ac-1621-44df-a224-5ed02c2b7880

Created By: Eliezer Bwana

LinkedIn: Eliezer Bwana
Twitter: @BwanaEliezer

License

The MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

Product	Compatible and additional computed target framework versions.
.NET	net7.0 is compatible. net7.0-android was computed. net7.0-android33.0 is compatible. net7.0-ios was computed. net7.0-ios16.1 is compatible. net7.0-maccatalyst was computed. net7.0-maccatalyst16.1 is compatible. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net7.0-windows10.0.19041 is compatible. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net7.0
- No dependencies.
net7.0-android33.0
- No dependencies.
net7.0-ios16.1
- No dependencies.
net7.0-maccatalyst16.1
- No dependencies.
net7.0-windows10.0.19041
- No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
1.1.3-alpha	236	7/20/2023
1.1.2-alpha	87	7/19/2023
1.0.0-alpha	89	7/12/2023

this version is still in pre-release mode