BoomMenu
![Lisense](https://camo.githubusercontent.com/ced2b59a9bf1d674e799fa2e1eb8e75c392e3db96b748a3a7dd848f73dc6bed7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d417061636865253230322d6c69676874677265792e737667)
##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.
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/text-inside-button.gif)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/ham-button.gif)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/text-outside-button.gif)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/actionbar-example.gif)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/list-example.gif)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/share-example.gif)
##Gradle & Maven
compile 'com.nightonke:boommenu:2.0.3'
<dependency>
<groupId>com.nightonke</groupId>
<artifactId>boommenu</artifactId>
<version>2.0.3</version>
<type>pom</type>
</dependency>
##Demo
![](https://github.com/Nightonke/BoomMenu/raw/master/Apk/BoomMenu.png)
Or by link:
Boom V2.0.3 in Github
Boom V2.0.3 in Fir
##Wiki
Check the wiki to use BMB.
###Documentation Chapters
- Basic Usage
How to use BMB in just several lines of code?
- Simple Circle Button
Add simple circle buttons with just an image for each to BMB.
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/BoomButton/SimpleCircleButton.png)
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.
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/BoomButton/TextInsideCircleButton.png)
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.
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/BoomButton/TextOutsideCircleButton.png)
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.
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/BoomButton/HamButton.png)
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.
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/button-place-alignment-enum/button-place-alignment-1.png)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/button-place-alignment-enum/button-place-alignment-2.png)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/button-place-alignment-enum/button-place-alignment-3.png)
8. [Different Ways to Boom](https://github.com/Nightonke/BoomMenu/wiki/Different-Ways-to-Boom)
Different animations when the buttons boom or re-boom.
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/boom-enum/boom-enum-parabola-2.png)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/boom-enum/boom-enum-parabola-3.png)
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 [email protected] / [email protected]. 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
![WoWoViewPager](https://camo.githubusercontent.com/56c2a0390ee05f3fdd522755bf7e889977087daa1d685b9d181615e6742e501d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230576f576f5669657750616765722532302d253230416e64726f69642532304c6962726172792532302d627269676874677265656e2e737667)
![BoomMenuButton-Android](https://camo.githubusercontent.com/baa22265b3f4a1d3d6d261f88ff754410927fd77e108249d18d9fee1a84e0697/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230426f6f6d4d656e75427574746f6e2532302d253230416e64726f69642532302532304c6962726172792532302d677265656e2e737667)
![CoCoin](https://camo.githubusercontent.com/5913e006ce32b4e9641dafb87fb4f399e13ff06d7695b154e8aa5be6463f977f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230436f436f696e2532302d253230416e64726f69642532304170702532302d79656c6c6f77677265656e2e737667)
![BlurLockView](https://camo.githubusercontent.com/eb75833c730e59fcafcd0ac7ed815fa6b2c068d982404dc8502b8b1bc2b58d9a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230426c75724c6f636b566965772532302d253230416e64726f69642532304c6962726172792532302d79656c6c6f77677265656e2e737667)
![LeeCo](https://camo.githubusercontent.com/d877094d934b6ab121bbfc3bf3a35923e85dff9c7680bbb3d8a372e8dcc979e2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2532304c6565436f2532302d253230416e64726f69642532304170702532302d79656c6c6f772e737667)
![GithubWidget](https://camo.githubusercontent.com/debd73c8c080d23e9ff65e178688c20fe89cd0ece7c16a0c57d6aef198cd042f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2532304769746875625769646765742532302d253230416e64726f69642532304170702532302d6f72616e67652e737667)
![JellyToggleButton](https://camo.githubusercontent.com/22fb408263faf035adf68ea83cc1c970290d4f7aa3b9195ce5454a87ea4090f0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2532304a656c6c79546f67676c65427574746f6e2532302d253230416e64726f69642532304c6962726172792532302d7265642e737667)
![FaceOffToggleButton](https://camo.githubusercontent.com/93f8ce5c188a7c207bff81a5e3838661a781ef6da42c137870081e07e58d1804/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230466163654f6666546f67676c65427574746f6e2532302d253230416e64726f69642532304c6962726172792532302d6c69676874677265792e737667)
![BoomMenuButton-iOS](https://camo.githubusercontent.com/9d018c485d0d88577b657143ae75f23a08b57f5b85059154a2a5bc4e23c866eb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230426f6f6d4d656e75427574746f6e2532302d253230694f532532304c6962726172792532302d626c75652e737667)