gloomyluo / BoomMenu

A menu which can ... BOOM! - Android

BoomMenu

##2.0.0 Comes Finally

Approximately 8 months ago, I got an inspiration to creating something that can boom and show menu, which I named it Boom-Menu-Button, BMB. But at that time, I just a fresh-man in Android, knowing little about designing. The codes I wrote serveral months ago are ugly and performed low-efficient.

Between months, I always think about BMB and try to write a better design pattern for implements of BMB. My first try is BMB-iOS, which contains more family characteristics, for instance, buttons-alignment, text-inside/outside-button.

And now the BMB-Android 2.0.0 comes.

##Gradle & Maven

compile 'com.nightonke:boommenu:2.0.7'

<dependency>
  <groupId>com.nightonke</groupId>
  <artifactId>boommenu</artifactId>
  <version>2.0.7</version>
  <type>pom</type>
</dependency>

##Demo
Or by link:
Boom V2.0.7 in Github
Boom V2.0.7 in Fir

##Wiki Check the wiki to use BMB.

###Documentation Chapters

1. Basic Usage
   How to use BMB in just several lines of code?
2. Simple Circle Button
   Add simple circle buttons with just an image for each to BMB.

3. [Text Inside Circle Button](https://github.com/Nightonke/BoomMenu/wiki/Text-Inside-Circle-Button) Add text inside circle buttons with a text and image inside for each to BMB.

4. [Text Outside Circle Button](https://github.com/Nightonke/BoomMenu/wiki/Text-Outside-Circle-Button) Add text outside circle buttons with a text and image outside for each to BMB.

5. [Ham Button](https://github.com/Nightonke/BoomMenu/wiki/Ham-Button) Add ham buttons with with a title, subtitle and image inside for each to BMB.

6. [Share Style](https://github.com/Nightonke/BoomMenu/wiki/Share-Style) Make a share-style BMB. 7. [Button Place Alignments](https://github.com/Nightonke/BoomMenu/wiki/Button-Place-Alignments) Place all the buttons to anywhere on screen.

8. [Different Ways to Boom](https://github.com/Nightonke/BoomMenu/wiki/Different-Ways-to-Boom) Different animations when the buttons boom or re-boom.

9. [Ease Animations for Buttons](https://github.com/Nightonke/BoomMenu/wiki/Ease-Animations-for-Buttons) Use different and cute ease-animations for buttons. 1. [Different Order for Buttons](https://github.com/Nightonke/BoomMenu/wiki/Different-Order-for-Buttons) Different order enum for boom-buttons. 10. [Other Animations Attributes for Buttons](https://github.com/Nightonke/BoomMenu/wiki/Other-Animations-Attributes-for-Buttons) Delay, duration, rotate-degrees, frames... 11. [Click Event and Listener](https://github.com/Nightonke/BoomMenu/wiki/Click-Event-and-Listener) Listener for clicking each button or animation-states. 12. [Control BMB](https://github.com/Nightonke/BoomMenu/wiki/Control-BMB) Boom or re-boom BMB programmatically. 13. [Use BMB in Action Bar](https://github.com/Nightonke/BoomMenu/wiki/Use-BMB-in-Action-Bar) How to put BMB in action bar? 14. [Use BMB in List](https://github.com/Nightonke/BoomMenu/wiki/Use-BMB-in-List) Matters need attention when you need a BMB in list-view or recycler-view. 15. [Use BMB in Fragment](https://github.com/Nightonke/BoomMenu/wiki/Use-BMB-in-Fragment) Example for use BMB in fragment. 16. [Attributes for BMB or Pieces on BMB](https://github.com/Nightonke/BoomMenu/wiki/Attributes-for-BMB-or-Pieces-on-BMB) How to change the size or margins of dots on BMB? 17. [Cache Optimization & Boom Area](https://github.com/Nightonke/BoomMenu/wiki/Cache-Optimization-&-Boom-Area) What if I want BMB to boom in just its parent-view? 1. [Version History](https://github.com/Nightonke/BoomMenu/wiki/Version-History) What's more for every version? 18. [Structure for BMB](https://github.com/Nightonke/BoomMenu/wiki/Structure-for-BMB) Structure for BMB when I designed it, for sharing and communicating.

##Issues & Feedbacks Try to tell me the bugs or enhancements about BMB, or contact me with [e-mail] / [e-mail]. Before doing that, having a careful read on readme, wiki and issues is really helpful.

##ReadMe for Version 1.0.9 or Below If you still wanna use version 1.0.9 or below, you can find the README below:

English README 中文文档

But I strongly suggest you to use the newest version.

##What I'm Doing