GitHub - limitlessvirtual/LIVBubbleMenu-iOS: An animated and customisable bubble menu for iOS8.

#LIVBubbleMenu

An animated bubble menu using the pop animation library (https://github.com/facebook/pop). The menu is fully customizable in terms of radius, number of items, animation speed, bounciness, background, alpha ect.

Note: An Android Version is also available (coming soon).

##Setup

You can either:

Copy the the LIVBubbleMenu directly into your Project
Include the following cocoapod (preferred):

##Usage

Import the required header file:

#import <LIVBubbleMenu/LIVBubbleMenu.h>

//or without pod

#import "LIVBubbleMenu.h"

Create the LIVBubbleMenu with an array of images and set certain properties:

//Array of UIImages for each bubble
NSArray* images = [NSArray arrayWithObjects:
                     	[UIImage imageNamed:@"angry"],
                        [UIImage imageNamed:@"confused"],
                        [UIImage imageNamed:@"cool"],
                        [UIImage imageNamed:@"grin"],
                        [UIImage imageNamed:@"happy"],
                        [UIImage imageNamed:@"neutral"],
                        [UIImage imageNamed:@"sad"],
                        nil];

//Create the component centered in window
LIVBubbleMenu *bubbleMenu = [[LIVBubbleMenu alloc] initCenteredInWindowWithRadius:150 menuItems:images];

//Set optional properties
bubbleMenu.bubbleRadius = 80;
bubbleMenu.bubbleSpringBounciness = 30.0f;

//Show the menu
[bubbleMenu show];

###Initialisation

There are two ways to create the bubble menu:

At a certain point in a view:

[[LIVBubbleMenu alloc] initWithPoint:CGPointMake(100,100) radius:150 menuItems:array inView:self.view];

Centered in the window:

LIVBubbleMenu *bubbleMenu = [[LIVBubbleMenu alloc] initCenteredInWindowWithRadius:150 menuItems:images];

###Delegates

The following delegates are available:

//User selected a bubble
-(void)livBubbleMenu:(LIVBubbleMenu *)bubbleMenu tappedBubbleWithIndex:(NSUInteger)index {
    NSLog(@"User has selected bubble index: %tu", index);
}

//The bubble menu has been hidden
-(void)livBubbleMenuDidHide:(LIVBubbleMenu *)bubbleMenu {
    NSLog(@"LIVBubbleMenu has been hidden");
}

##Customizable Properties

Property	Type	Description	Default Value
menuItemImages	NSArray*	UIImages for each bubble menu item.	-
menuRadius	int	The overall radius of the bubble menu.	-
isAnimating	BOOL	Flag whether the animation is currently hiding or showing	-
parentView	UIView*	The parent view that the bubble menu gets added to.	-
bubbleRadius	float	Radius of each bubble item	40.0f
bubbleAlpha	float	Float of each bubble item	0.97f
bubbleShowDelayTime	float	The delay between each bubble item popping in	0.15f
bubbleHideDelayTime	float	The delay between each bubble item popping out	0.15f
bubbleSpringBounciness	float	Spring bounciness of the bubble item popping in	20.0f
bubbleSpringSpeed	float	The spring speed of the bubble when popping in (default is 3.0f)	3.0f
bubblePopInDuration	float	The amount of seconds it takes for a bubble to reach its show position	1.0f
bubblePopOutDuration	float	The amount of seconds it takes for a bubble to reach its hide position	1.0f
bubbleStartAngle	float	Initial angle to start bubbles	0.0f
bubbleTotalAngle	float	Total available degrees in the bubble menu	360.0f
easyButtons	BOOL	Simple vx complex button styling (set NO if buttons have alpha channel)	YES
hasBackground	BOOL	Toggles whether the menu has a background that fades in	YES
backgroundColor	UIColor*	The color of the background	Black
backgroundAlpha	float	The alpha of the background (0.2 by default)	0.2f
backgroundFadeDuration	float	The amount of seconds it takes for the background to fade in/out	1.2f

##Requirements

ARC, iOS 7.1+, Xcode 5+

##Upcoming Features

~~Bubble hide animation starting at tapped bubble index~~ Done (v1.1.0)
Different types of animations
More properties to customize
Have an idea? Pop an email to info@limitlessvirtual.com

##Credits The component is originally based on the awesome AAShareBubbles by Almas Adilbek.

Emoticons in the demo are by Keyamoon

Thanks to the following developers who have contributed:

Brendan Kirchner (waterskier2007)
Matt Condon (Shrugs)