Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ThomasLebrun/XamarinBehaviorsToolkit
The Behaviors Toolkit for Xamarin is a complete framework to easily add common and reusable interactivity to your Xamarin applications.
https://github.com/ThomasLebrun/XamarinBehaviorsToolkit
android behaviors ios toolkit xamarin xamarin-application xaml
Last synced: about 2 months ago
JSON representation
The Behaviors Toolkit for Xamarin is a complete framework to easily add common and reusable interactivity to your Xamarin applications.
- Host: GitHub
- URL: https://github.com/ThomasLebrun/XamarinBehaviorsToolkit
- Owner: ThomasLebrun
- License: mit
- Created: 2016-01-27T21:55:04.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-02-09T08:17:08.000Z (over 8 years ago)
- Last Synced: 2024-04-26T05:37:02.474Z (5 months ago)
- Topics: android, behaviors, ios, toolkit, xamarin, xamarin-application, xaml
- Language: C#
- Homepage:
- Size: 39.1 KB
- Stars: 39
- Watchers: 8
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-xamarin - Behaviors Toolkit ★34 - A means of adding common and reusable interactivity to your Xamarin applications with minimal code. (Architecture)
README
# **The Behaviors Toolkit for Xamarin**
The Behaviors Toolkit for Xamarin is an easy-to-use means of adding common and reusable interactivity to your Xamarin applications with minimal code. Use of the Behaviors Toolkit for Xamarin is governed by the MIT License.
## Build Status
[](https://ci.appveyor.com/project/ThomasLebrun/xamarinbehaviorstoolkit)
## Getting Started
As a primary Windows (XAML) developer, I've always enjoyed using the behaviors to easily add, with just some lines of code, some great features to any controls.
Since I work with Xamarin, I've always thought it could be a good idea to get this functionality in the Xamarin projects.
So welcome to the home of the **Behaviors Toolkit for Xamarin**, a custom implementation of the XAML behaviors for the Xamarin (Android / iOS) projects!
## Current Release
Current release (**0.0.3**) is available from Nuget:
https://www.nuget.org/packages/Xamarin.Behaviors.Toolkit/
## Code Example
**Using a behavior**
To attach a behavior to a control (Button, EditText, etc.), you just have to use the **AttachBehavior** method.
Take a look at the following code sample (for Xamarin.Android) showing how to use a behavior in an application, just with a snippet of code:
```cs
var mySecondEditText = FindViewById(Resource.Id.MySecondEditText);
mySecondEditText.AttachBehavior(new SelectAllOnFocusBehavior());
```
**Creating a behavior**
The Behaviors Toolkit for Xamarin use the same architecture as the Microsoft behaviors which can be used in any XAML application. To create your own behavior, you just have to inherit from the **Behavior\** class and override the methods **OnAttached** and/or **OnDetaching**. To reference the control on which the behavior is attached, you can access the property **AssociatedObject**:
```cs
///
/// Behavior used on an EditText object and used to hide the software keyboard when one of the following key is pressed: "Done", "Search" or "Go"
///
public class HideKeyboardOnEnterKeyBehavior : Behavior
{
///
/// Gets or sets the application context.
///
///
/// The application context.
///
public Context ApplicationContext { get; set; }
private EventHandler _editorActionEventHandler;
///
/// Method to override when the behavior is attached to the view.
///
/// ApplicationContext property needs to be set in order to use this behavior.
protected override void OnAttached()
{
if (this.ApplicationContext == null)
{
throw new InvalidOperationException("ApplicationContext property needs to be set in order to use this behavior.");
}
_editorActionEventHandler = (sender, args) =>
{
if (args.ActionId == ImeAction.Done || args.ActionId == ImeAction.Search || args.ActionId == ImeAction.Go || args.ActionId == ImeAction.Next)
{
var inputManager = (InputMethodManager)this.ApplicationContext.GetSystemService(Context.InputMethodService);
inputManager.HideSoftInputFromWindow(this.AssociatedObject.WindowToken, HideSoftInputFlags.None);
args.Handled = true;
}
};
this.AssociatedObject.EditorAction += _editorActionEventHandler;
}
///
/// Method to override when the behavior is removed from the view.
///
protected override void OnDetaching()
{
if (_editorActionEventHandler != null)
{
this.AssociatedObject.EditorAction -= _editorActionEventHandler;
}
}
}
```
Here is another sample behavior, for Xamarin.iOS applications:
```cs
///
/// Behavior used on an EditText object and used to select all the text within it when it has focus
///
public class SelectAllOnFocusBehavior : Behavior
{
private EventHandler _editingDidBeginEventHandler;
///
/// Method to override when the behavior is attached to the view.
///
protected override void OnAttached()
{
_editingDidBeginEventHandler = (sender, e) =>
{
this.AssociatedObject.PerformSelector(new Selector("selectAll"), null, 0.0f);
};
this.AssociatedObject.EditingDidBegin += _editingDidBeginEventHandler;
}
///
/// Method to override when the behavior is removed from the associatedObject.
///
protected override void OnDetaching()
{
if (_editingDidBeginEventHandler != null)
{
this.AssociatedObject.EditingDidBegin -= _editingDidBeginEventHandler;
}
}
}
```
## Todo
- Add more built-in behaviors for Xamarin.Android projects
- Add more built-in behaviors for Xamarin.iOS projects
## More Info
- Want to contribute? We accept any interesting pull requests!
- [Report a bug or ask a question](https://github.com/ThomasLebrun/XamarinBehaviorsToolkit/issues)
- [License](http://opensource.org/licenses/MIT)