https://github.com/enisn/xamarin.forms.statemanager
A simple UI state manager for Xamarin Forms
https://github.com/enisn/xamarin.forms.statemanager
state state-management xamarin xamarin-forms xamarinforms
Last synced: about 1 year ago
JSON representation
A simple UI state manager for Xamarin Forms
- Host: GitHub
- URL: https://github.com/enisn/xamarin.forms.statemanager
- Owner: enisn
- Created: 2020-06-23T16:53:11.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-07-05T07:21:54.000Z (almost 4 years ago)
- Last Synced: 2025-03-19T00:23:57.835Z (about 1 year ago)
- Topics: state, state-management, xamarin, xamarin-forms, xamarinforms
- Language: C#
- Homepage:
- Size: 442 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Xamarin.Forms.StateManager
A simple & light UI state manager for Xamarin Forms.
## Why?
### Performance
Normally, states can be managed via binding `IsVisible` property of Views Controls. But when you use `IsVisible` property, that object will be initilized and allocated lots of memory on ram and it makes latency when openning page.
This StateManager uses **DataTemplate** instead of initializing all components. Only views related to the current state will be initialized and when state has changed, they will be removed and next state elements will be placed at UI.
### Ease of use
This StateManager makes much more easier to manage states on XAML pages. This provides much more manageable XAML code and easy to read.
On the situation below, both of component will be initialized at the beginning:
```xml
```
But state manager provides you to completely seperate your states and it uses **lazy load** for better performance.
# Instructions
## Set-Up
- Install NuGet Package `Xamarin.Forms.StateManager` only to your portable library.
***
## Usage
- Add following namespace at the top of your XAML page:
`xmlns:sm="clr-namespace:Xamarin.Forms.StateManager.Controls;assembly=Xamarin.Forms.StateManager"`
- Use **StateManager** anywhere you need:
```xml
```
- You must define a default State at your **ViewModel**
```csharp
public class MainViewModel : BindableObject
{
private string currentState = "Failed"; // Must define a default state
private string content;
private static readonly Random random = new Random();
public MainViewModel()
{
this.LoadCommand = new Command(Load);
}
public string CurrentState { get => currentState; set { currentState = value; OnPropertyChanged(); } }
public string Content { get => content; set { content = value; OnPropertyChanged(); } }
public ICommand LoadCommand { get; set; }
private async void Load()
{
this.CurrentState = "Loading";
await Task.Delay(2000);
var tmp = random.Next(0, 100);
if (tmp > 50)
{
this.CurrentState = "Failed";
}
else
{
this.CurrentState = "Loaded";
this.Content = "This is loaded content.";
}
}
}
```