BoomMenu
![Lisense](https://camo.githubusercontent.com/37cbec5b8df0e8cda6b082ac74bafb2bb2063d50951d51be40daaaf37d02634d/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?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/ham-button.gif?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/text-outside-button.gif?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/actionbar-example.gif?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/list-example.gif?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/share-example.gif?raw=true)
##Gradle & Maven
compile 'com.nightonke:boommenu:2.0.0'
<dependency>
<groupId>com.nightonke</groupId>
<artifactId>boommenu</artifactId>
<version>2.0.0</version>
<type>pom</type>
</dependency>
##Demo
![](https://github.com/Nightonke/BoomMenu/raw/master/Apk/BoomMenu%20V2.0.0.png?raw=true)
Or by link:
Boom V2.0.0 in Github
Boom V2.0.0 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?raw=true)
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?raw=true)
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?raw=true)
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?raw=true)
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?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/button-place-alignment-enum/button-place-alignment-2.png?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/button-place-alignment-enum/button-place-alignment-3.png?raw=true)
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?raw=true)
![](https://github.com/Nightonke/BoomMenu/raw/master/Pictures/boom-enum/boom-enum-parabola-3.png?raw=true)
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...
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?
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 Nightonke@outlook.com / 2584541288@qq.com. 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/2af8dfe94f1e9343c7cb10a115d71ba149b79bdf8312433c505e8e3721546a48/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230576f576f5669657750616765722532302d253230416e64726f69642532304c6962726172792532302d627269676874677265656e2e737667)
![BoomMenuButton-Android](https://camo.githubusercontent.com/a2ef9edd3617c7d2258853613fac5edfda1fe619e28cdde21f601189cc89b220/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230426f6f6d4d656e75427574746f6e2532302d253230416e64726f69642532302532304c6962726172792532302d677265656e2e737667)
![CoCoin](https://camo.githubusercontent.com/e79ba3cf06ae4214364dd8d9e9ba7c31f170a92c13202bfb3c09c1a574131063/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230436f436f696e2532302d253230416e64726f69642532304170702532302d79656c6c6f77677265656e2e737667)
![BlurLockView](https://camo.githubusercontent.com/e7b67f449622b514fd470478482a881441647aea0fff95f0f542f291c507f1d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230426c75724c6f636b566965772532302d253230416e64726f69642532304c6962726172792532302d79656c6c6f77677265656e2e737667)
![LeeCo](https://camo.githubusercontent.com/dd09dbdc5f8ef9b0458526ceb128a70b646e12b4635997634e32db085d8a55be/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2532304c6565436f2532302d253230416e64726f69642532304170702532302d79656c6c6f772e737667)
![GithubWidget](https://camo.githubusercontent.com/341dd74320ea08f545987a4838bc73b2f5c79be6305708025b9fc0541b8c7bb7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2532304769746875625769646765742532302d253230416e64726f69642532304170702532302d6f72616e67652e737667)
![JellyToggleButton](https://camo.githubusercontent.com/3597baf48ab6f3e5db7e7c09f24fc01057b8116bb297078b61c349a19160de08/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2532304a656c6c79546f67676c65427574746f6e2532302d253230416e64726f69642532304c6962726172792532302d7265642e737667)
![FaceOffToggleButton](https://camo.githubusercontent.com/3abd8e57fce6045ac9f2c2d15eb416f19c7185e5d582f4d2587a3c4ff2402be1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230466163654f6666546f67676c65427574746f6e2532302d253230416e64726f69642532304c6962726172792532302d6c69676874677265792e737667)
![BoomMenuButton-iOS](https://camo.githubusercontent.com/4c6fd5aeb10777725b7ada0ce1d18cc9606e684f861846b9da2a537edf441276/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f253230426f6f6d4d656e75427574746f6e2532302d253230694f532532304c6962726172792532302d626c75652e737667)