Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ionoy/Ammy2
https://github.com/ionoy/Ammy2
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/ionoy/Ammy2
- Owner: ionoy
- License: mit
- Created: 2018-05-16T12:47:28.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-12-02T14:47:03.000Z (almost 6 years ago)
- Last Synced: 2024-05-28T13:24:28.514Z (4 months ago)
- Language: C#
- Size: 2.15 MB
- Stars: 29
- Watchers: 9
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-xamarin-forms - Clarity ★25
README
# **Ammy** is an application framework for XAML based platforms
## **How to install**
`install-package Ammy.XamarinForms`
(other platforms coming soon)
## **Main values**
* **Code should be readable.** As few boilerplate as possible.
* **Code should be reusable.** Do not repeat yourself. Make sure to separate common patterns for later reuse.
* **Code should be local.** Easily switch between the UI and corresponding application logic.
* **Code should be live** Write code live, without restarting your application. (this requires LiveSharp extension)
## **Hello World example**
```cs
public class App : Application {
public App() => MainPage = new HelloWorld();
}
public class HelloWorld : AmmyPage
{
public override View BuildContent()
{
var currentValue = CreateBindableValue("World");
return StackLayout.Children(
Entry.Text(currentValue),
Label.Text(currentValue, v => "Hello, " + v)
);
}
}
```
As you can see, both **data** and **presentation** are in the same method. But don't get your pitchforks up - **IT'S OKAY**. Your **data** still doesn't know anything about the **view** and most of the communication is still done with binding. Although now it's easier to navigate between the view and the code.
## **Won't it become unreadable when I add more UI?**
Unlike with XAML, you can easily extract stuff away. Visual Studio has built-in refactorings for that.
```cs
public override View BuildContent()
{
return StackLayout.Children(
Header("My application name"),
Label.Text("Content")
);
}
public Grid Header(string applicationName)
{
return Grid.Children(
Label.Text(applicationName)
)
}
```
Note that both methods can have separate data and logic.
## **Commands and interaction**
You can pass labmda function to the `Command` extension method and it will be executed on click.
```cs
public override View BuildContent()
{
var counter = CreateBindableValue(0);
// define local function for Button's Command
void increment() => counter.Value++;
return StackLayout.Children(
Label.Text(counter),
Button.Text("Increment")
.Command(increment)
);
}
```
You can still use the good old `ICommand` interface if you want.
## **Validation**
Validation is done by `BindableValue` and `BindableModel`.
```cs
public override View BuildContent()
{
var summerMonth = CreateBindableValue("", validateSummerMonth);
void validateSummerMonth(string month, Validator validator) {
if (month != "June" && month != "July" && month != "August")
validator.AddError("Month can either be June, July or August");
}
return StackLayout.Children(
Entry.Text(summerMonth),
Label.Text(summerMonth.ValidationMessage)
);
}
```
