SpringFloatingActionMenu

A menu layout view with makovkastar's FloatingActionButton, which means you still can use the features of FAB like auto hide while scrolling.

这是一个makovkastar的FloatingActionButton基础上的控件,主要效果是点击FAB会弹出菜单,并有动画效果.所以FAB的所有特性都能用,比如当列表滚动自动隐藏等.

Screenshot 截图

Sample App download

示例App下载

Usage 用法

Add the dependency to your build.gradle.

在build.gradle添加依赖

dependencies {
   compile 'com.tiancaicc.springfloatingactionmenu:library:0.0.2'
}

setup in Activity onCreatemethod

在onCreate方法中设置

       //create your own FAB
       /必须手动创建FAB, 并设置属性
        final FloatingActionButton fab = new FloatingActionButton(this);
        fab.setType(FloatingActionButton.TYPE_NORMAL);
        fab.setImageResource(icon);
        fab.setColorPressedResId(R.color.colorPrimary);
        fab.setColorNormalResId(R.color.fab);
        fab.setColorRippleResId(R.color.text_color);
        fab.setShadow(true);
        
        new SpringFloatingActionMenu.Builder(this)
                .fab(fab)
                //add menu item via addMenuItem(bgColor,icon,label,label color,onClickListener)
                //添加菜单按钮参数依次是背景颜色,图标,标签,标签的颜色,点击事件
                .addMenuItem(R.color.photo, R.mipmap.ic_messaging_posttype_photo, "Photo", R.color.text_color,this)
                .addMenuItem(R.color.chat, R.mipmap.ic_messaging_posttype_chat, "Chat", R.color.text_color,this)
                .addMenuItem(R.color.quote, R.mipmap.ic_messaging_posttype_quote, "Quote", R.color.text_color,this)
                .addMenuItem(R.color.link, R.mipmap.ic_messaging_posttype_link, "Link", R.color.text_color,this)
                .addMenuItem(R.color.audio, R.mipmap.ic_messaging_posttype_audio, "Audio", R.color.text_color,this)
                .addMenuItem(R.color.text, R.mipmap.ic_messaging_posttype_text, "Text", R.color.text_color,this)
                .addMenuItem(R.color.video, R.mipmap.ic_messaging_posttype_video, "Video", R.color.text_color,this)
                //you can choose menu layout animation
                //设置动画类型
                .animationType(SpringFloatingActionMenu.ANIMATION_TYPE_TUMBLR)
                //setup reveal color while the menu opening
                //设置reveal效果的颜色
                .revealColor(R.color.colorPrimary)
                //set FAB location, only support bottom center and bottom right
                //设置FAB的位置,只支持底部居中和右下角的位置
                .gravity(Gravity.RIGHT | Gravity.BOTTOM)
                .onMenuActionListner(new OnMenuActionListener() {
                    @Override
                    public void onMenuOpen() {
                        //set FAB icon when the menu opened
                        //设置FAB的icon当菜单打开的时候
                        fab.setImageResource(icon_closed);
                    }

                    @Override
                    public void onMenuClose() {
                        //set back FAB icon when the menu closed
                        //设置回FAB的图标当菜单关闭的时候
                        fab.setImageResource(icon_opend);
                    }
                })
                .build();

Note you should include toolbar in your layout xml manually and not use theme style or you will find the reveal effect not cover the whole screen.

注意不能使用系统提供的主题的toolbar,不然reveal效果就不会覆盖全屏,应该手动在xml中添加toolbar.

For more usage, you can check out the example.

更多的用法可以参考example.

实现原理

实现原理

Dependencies 依赖

• rebound
• backboard
• FloatingActionButton
• SystemBarTint

CHANGE LOG

version 0.0.2:

• Avoid clicks on views behind the menu when is open. Thanks to @amanzan;
• Fix bug when menu is invisible and still hold the touch event. Thanks to @brucetoo;
• Fix bug when MenuItemView is not visible,it's onClick event still can work. Thanks to @brucetoo;
• Add support to disable FAB movement;
• Fix: In Last Collapsing animation of menu leaves traces of menu items on screen;
• Fix animation unstable caused by FAB get clicked too fast.

LICENSE

Copyright (C) 2016 tiancaiCC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.