circlebuttonmenu's Introduction

Circle Button Menu for Xamarin.Forms

A Circle Button Menu Control for Xamarin.Forms

Setup

Available on NuGet:
Install into your PCL/.NET Standard and Client Projects

Build

CI NuGet Feed: 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 +

Usage

iOS and Android####

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

Xamarin.Forms.Init();
CircleButtonMenuRenderer.Init();

XAML:

Add the namespace in the xmlns:

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

Add the control:

<controls:CircleButtonMenu FillColor="Black"
                           StrokeColor="Red"
                           OpenImageSource="plus"
                           CloseImageSource="minus"
                           Direction="DownLeft"
                           Flow="Expand"
                           ItemsSource="{Binding Controls}"
                           IndexSelected="{Binding ControlSelected}" />

View Model:

public IEnumerable<string> 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

Twitter: @Andrew_Hoefling
Blog: andrewhoefling.com

License

The MIT License (MIT) see License File

circlebuttonmenu's People

Contributors

Stargazers

Watchers

circlebuttonmenu's Issues

Crash when disposing of control

Using the control with Prism NavigationService, the control is embedded in a PageView which itself is within a TabbedPageView. When swapping out navigation stacks, the app crashes.

Stack Trace:

  at CircleButtonMenu.Abstractions.CircleButtonMenu.OnItemsSourcePropertyChanged (Xamarin.Forms.BindableObject bindable, System.Object oldValue, System.Object newValue) [0x0002e] in C:\projects\circlebuttonmenu\src\CircleButtonMenu.Abstractions\CircleButtonMenu.cs:220 
  at Xamarin.Forms.BindableObject.SetValueActual (Xamarin.Forms.BindableProperty property, Xamarin.Forms.BindableObject+BindablePropertyContext context, System.Object value, System.Boolean currentlyApplying, Xamarin.Forms.Internals.SetValueFlags attributes, System.Boolean silent) [0x0011b] in D:\agent_work\1\s\Xamarin.Forms.Core\BindableObject.cs:605 
  at Xamarin.Forms.BindableObject.SetValueCore (Xamarin.Forms.BindableProperty property, System.Object value, Xamarin.Forms.Internals.SetValueFlags attributes, Xamarin.Forms.BindableObject+SetValuePrivateFlags privateAttributes) [0x0015b] in D:\agent_work\1\s\Xamarin.Forms.Core\BindableObject.cs:399 
  at Xamarin.Forms.BindingExpression.ApplyCore (System.Object sourceObject, Xamarin.Forms.BindableObject target, Xamarin.Forms.BindableProperty property, System.Boolean fromTarget) [0x001f9] in D:\agent_work\1\s\Xamarin.Forms.Core\BindingExpression.cs:174 
  at Xamarin.Forms.BindingExpression.Apply (System.Object sourceObject, Xamarin.Forms.BindableObject target, Xamarin.Forms.BindableProperty property) [0x0006b] in D:\agent_work\1\s\Xamarin.Forms.Core\BindingExpression.cs:77 
  at Xamarin.Forms.Binding.Apply (System.Object newContext, Xamarin.Forms.BindableObject bindObj, Xamarin.Forms.BindableProperty targetProperty) [0x00042] in D:\agent_work\1\s\Xamarin.Forms.Core\Binding.cs:126 
  at Xamarin.Forms.BindableObject.ApplyBindings (System.Boolean skipBindingContext) [0x0003b] in D:\agent_work\1\s\Xamarin.Forms.Core\BindableObject.cs:430 
  at Xamarin.Forms.BindableObject.ApplyBindings () [0x00000] in D:\agent_work\1\s\Xamarin.Forms.Core\BindableObject.cs:134 
  at Xamarin.Forms.BindableObject.SetInheritedBindingContext (Xamarin.Forms.BindableObject bindable, System.Object value) [0x0005a] in D:\agent_work\1\s\Xamarin.Forms.Core\BindableObject.cs:128 
  at Xamarin.Forms.Element.SetChildInheritedBindingContext (Xamarin.Forms.Element child, System.Object context) [0x00000] in D:\agent_work\1\s\Xamarin.Forms.Core\Element.cs:511 
  at Xamarin.Forms.Element.OnBindingContextChanged () [0x00021] in D:\agent_work\1\s\Xamarin.Forms.Core\Element.cs:354 
  at Xamarin.Forms.View.OnBindingContextChanged () [0x00042] in D:\agent_work\1\s\Xamarin.Forms.Core\View.cs:99 
  at Xamarin.Forms.Grid.OnBindingContextChanged () [0x00006] in D:\agent_work\1\s\Xamarin.Forms.Core\Grid.cs:147 
  at Xamarin.Forms.BindableObject.SetInheritedBindingContext (Xamarin.Forms.BindableObject bindable, System.Object value) [0x00060] in D:\agent_work\1\s\Xamarin.Forms.Core\BindableObject.cs:129 
  at Xamarin.Forms.Element.SetChildInheritedBindingContext (Xamarin.Forms.Element child, System.Object context) [0x00000] in D:\agent_work\1\s\Xamarin.Forms.Core\Element.cs:511 
  at Xamarin.Forms.TemplatedPage.SetChildInheritedBindingContext (Xamarin.Forms.Element child, System.Object context) [0x00008] in D:\agent_work\1\s\Xamarin.Forms.Core\TemplatedPage.cs:35 
  at Xamarin.Forms.Element.OnBindingContextChanged () [0x00021] in D:\agent_work\1\s\Xamarin.Forms.Core\Element.cs:354 
  at Xamarin.Forms.Page.OnBindingContextChanged () [0x00000] in D:\agent_work\1\s\Xamarin.Forms.Core\Page.cs:206 
  at Xamarin.Forms.ContentPage.OnBindingContextChanged () [0x00000] in D:\agent_work\1\s\Xamarin.Forms.Core\ContentPage.cs:16 
  at Xamarin.Forms.BindableObject.BindingContextPropertyChanged (Xamarin.Forms.BindableObject bindable, System.Object oldvalue, System.Object newvalue) [0x0000e] in D:\agent_work\1\s\Xamarin.Forms.Core```