An open API service indexing awesome lists of open source software.

https://github.com/skyehoefling/circlebuttonmenu


https://github.com/skyehoefling/circlebuttonmenu

circle circle-flyout flyout menu xamarin xamarin-forms xamarin-plugin

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# Circle Button Menu for Xamarin.Forms
A Circle Button Menu Control for Xamarin.Forms

## Setup

* Available on NuGet: [![NuGet](https://img.shields.io/nuget/v/CircleButtonMenu.svg?label=NuGet)](https://www.nuget.org/packages/CircleButtonMenu)
* Install into your PCL/.NET Standard and Client Projects

## Build

* [![Build status](https://ci.appveyor.com/api/projects/status/eqdh0b3479m2lf40?svg=true)](https://ci.appveyor.com/project/ahoefling/circlebuttonmenu)
* CI NuGet Feed: [https://ci.appveyor.com/nuget/CircleButtonMenu](https://ci.appveyor.com/nuget/CircleButtonMenu)

### Platform Support
CircleButtonMenu is available for use in the following supported platforms.

| Platform | Supported | Version |
|------------------|-----------|-------------|
| Xamarin.Android | Yes | API 23 + |
| Xamarin.iOS | Yes | iOS 10 + |

![Demo](demo.gif)
![Demo-Circle](demo-circle.gif)

## Usage ##

#### iOS and Android####
Initialize the renderer in the AppDelegate (iOS) and MainActivity (Android)

```c#
Xamarin.Forms.Init();
CircleButtonMenuRenderer.Init();
```

### XAML: ####
Add the namespace in the xmlns:

```xml
xmlns:controls="clr-namespace:CircleButtonMenu.Abstractions;assembly=CircleButtonMenu.Abstractions"
```

Add the control:

```xml

```

View Model:
```c#
public IEnumerable Controls = new [] { "resource1", "resource2" };
public ICommand ControlSelected = new Command(() => /* do something */ );
```

## Bindable Properties

| Property | Description | Default Value | Version |
|-------------------|--------------------------------------------------------|----------------------------|---------|
| FillColor | Gets or Sets the fill color for the circle. | `Color.Black` | v1.0.9 |
| StrokeColor | Gets or Sets the circle border color | `Color.Black` | v1.0.9 |
| OpenImageSource | Gets or Sets the open menu `ImageSource` | `null` | v1.0.9 |
| CloseImageSource | Gets or Sets the close menu `ImageSource` | `null` | v1.0.9 |
| ItemsSource | Gets or Sets the menu buttons | `null` | v1.0.9 |
| IndexSelected | Gets or Sets the command for IndexSelected | `null` | v1.0.9 |
| Direction | Gets or Sets the direction the controls will flyout in | `Up` | Preview |
| Flow | Gets or Sets the flow of the controls, ex: Snake | `Expand` | Preview |

## Created By: [@Andrew_Hoefling](https://twitter.com/andrew_hoefling)

* Twitter: [@Andrew_Hoefling](https://twitter.com/andrew_hoefling)
* Blog: [andrewhoefling.com](http://www.andrewhoefling.com)

### License

The MIT License (MIT) see License File