HorusSoftwareUY / Xamarin.Forms.Skeleton

The new loading approach for cool apps in Xamarin Forms
MIT License
450 stars 52 forks source link

Skeleton for Xamarin and MAUI apps

The Skeleton control is a popular approach to loading content in mobile apps that provides one or more visual placeholders while content is being loaded. This technique is particularly useful for improving user experience, as it reduces perceived load times and provides a more engaging experience.

Setup

Platform Support

Platform Version
Xamarin.iOS iOS 8+
Xamarin.Android API 16+
Xamarin.Forms >= 4.0.0.425677
.net6 MAUI ALL

Usage

You must add this namespace to your xaml files:

xmlns:sk="clr-namespace:Xamarin.Forms.Skeleton;assembly=Xamarin.Forms.Skeleton"

Add the following properties to generate a loading animation:

<ListView RowHeight="90"
    SeparatorVisibility="None"
    SelectionMode="None"
    VerticalOptions="FillAndExpand"
    BackgroundColor="Transparent"
    ItemTemplate="{StaticResource ItemTemplate}"
    ItemsSource="{Binding Items}"
    sk:Skeleton.IsParent="True"
    sk:Skeleton.IsBusy="{Binding IsBusy}"
    sk:Skeleton.Animation="{sk:DefaultAnimation Fade}" />

Add the following properties to set a loading animation with a specific background color:

<Frame BackgroundColor="Transparent"
       HasShadow="False"
       CornerRadius="5"
       Padding="0"
       HorizontalOptions="Start"
       sk:Skeleton.IsBusy="{Binding IsBusy}"
       sk:Skeleton.BackgroundColor="#c6c6c5">
            <Label Text="{Binding Title}"
                    TextColor="#000000"
                    FontSize="20"
                    FontAttributes="Bold"
                    HorizontalOptions="Start"/>
</Frame>

Properties

IsParent (Boolean)

IsBusy (Boolean)

BackgroundColor (Color)

Hide (Boolean)

Animation (BaseAnimation)

AnimationInterval (Int)

AnimationParameter (Double?)

Animations

Skeleton Animation

Beat Animation

Fade Animation

Vertical Shake Animation

Horizontal Shake Animation

Custom Animation

Demo

MAUI

https://github.com/HorusSoftwareUY/Xamarin.Forms.Skeleton/tree/master/SkeletonSample

Xamarin.Forms:

https://github.com/HorusSoftwareUY/Xamarin.Forms.Skeleton/tree/master/SkeletonExample

Developed by

Contributions

Contributions are welcome! If you find a bug want a feature added please report it.

If you want to contribute code please file an issue, create a branch, and file a pull request.

License

MIT License - see LICENSE.txt