多达288种动画效果定制的侧滑菜单库
Switch branches/tags
Clone or download
Latest commit 3872e86 Mar 17, 2018

README.md

效果演示:

注意:因为 好几个同学都遇到了刷新不及时以及类似的问题,所以请暂时不要用这个库,我会在近期修复,下面放一个替代的库

SlidingMenu,造成的不便请大家谅解

首先是实现效果的总览:

这里写图片描述这里写图片描述

然后是单独动画效果的演示:

动画分类 演示图 动画分类 效果图
位移动画 这里写图片描述 缩放动画 这里写图片描述
透明度动画 这里写图片描述 旋转动画 这里写图片描述
全局图片沉浸 这里写图片描述 模糊背景 这里写图片描述
动态模糊 这里写图片描述 反向动态模糊 这里写图片描述
组合动画1 这里写图片描述 组合动画2 这里写图片描述

好了,就演示这么多了,因为组合动画太多了,演示不完的

简单计算一下:


(位移动画(3种)*缩放动画(2种)*透明动画(2种)*旋转动画(6种),图片背景效果(4种)=288(种),
另外包括缩放,透明度,3D旋转,动态模糊都能设置范围,所以可定制的效果就更多了.

使用方法:

用于测试的Demo上演示了很多效果,同时动态的显示了当前效果要进行的代码设置方法,同时还包含一些小提示,建议您先下个Demo先看看.Demo下载

xml布局文件中的使用方法:

<?xml version="1.0" encoding="utf-8"?>
<com.brioal.swipemenu.view.SwipeMenu
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/main_swipemenu"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.brioal.swipemenudemo.MainActivity">

    <include layout="@layout/left_menu"/>

    <include layout="@layout/right_content"/>

</com.brioal.swipemenu.view.SwipeMenu>

布局文件非常简单,包含两个xml布局,上边的是菜单布局,下边的是内容布局

如果是最简单的使用那么这样设置已经足够了,默认的是固定不动的滑动方式

如果要对滑动的参数和效果进行定制,那么可以看一下资源文件中的设置(都有注释,理解起来不难)

<declare-styleable name="SwipeMenu">
        <!--动画的代码-->
        <attr name="sm_type" format="integer"/>
        <!--滑出菜单的范围-->
        <attr name="sm_dragoffset" format="dimension"/>
        <!--滑出菜单距边界的值-->
        <attr name="sm_menuoffset" format="dimension"/>
        <!--滑动开始的缩放值-->
        <attr name="sm_startscale" format="float"/>
        <!--滑动开始的alpha值-->
        <attr name="sm_startalpha" format="float"/>
        <!--滑动开始的3D旋转角度-->
        <attr name="sm_start3dangle" format="integer"/>
    </declare-styleable>

关于动画代码这里解释一下

为了方便定制动画效果,用一个4位数字来表示不同的动画组合,个位代表的旋转动画效果序号,十位代表透明度动画效果,千位代表缩放动画效果,万位代表位移动画效果,各个位置的起始都是1,有几种动画效果上限就是多少.比如位移动画有三种,则万位的范围就为1~3,其他依次类推.

注:因为背景,模糊效果会引入多余的组件,所以只在需要的时候添加进去,故不包含在动画代码中,设置方式下面再说.

再贴一个xml属性与代码的实现表格

代码实现 xml实现 功能
void setStyleCode(int type) 'sm_type` 设置动画效果代码
void setMenuOffset(int menuOffset) sm_menuoffset 设置拉出菜单距离右边界的距离
void setDragWipeOffset(int dragWipeOffset) sm_dragoffset 设置触发滑动的范围,为0则是全屏
void setStartScale(float minScale) sm_startscale 设置起始缩放
void setStartAlpha(float startAlpha) sm_startalpha 设置起始透明度
void setStart3DAngle(int start3DAngle) sm_start3dangle 设置起始3D旋转角度
void setFullColor(Activity activity, int headColor) 设置全局颜色
void setBackImage(Activity activity, int backBitmap, int headColor) 设置全局图片背景并沉浸
void setBlur(Activity activity, int backBitmap, int headColor, float blur) 设置全局模糊背景并指定模糊程度
void setChangedBlur(Activity activity, int backBitmap, int headColor) 设置全局动态模糊(范围默认0~25f)
void setReverseChangedBlur(Activity activity, int backBitmap, int headColor) 设置反向动态模糊背景(范围默认0~25f)
void setChangedBlur(Activity activity, int backBitmap, int headColor, float startBlur, float endBlur) 设置指定范围的动态模糊
void setOnMenuShowingListener(onSwipeProgressListener listener) 设置滑动监听,回调获取菜单从隐藏到显示的进度,范围(0~1.0f)
void changeAllColor(int color) 改变全局颜色(需要先设置全局颜色否则报错)
void isMenuShowing() 返回当前菜单是否显示
void showMenu() 显示菜单
void hideMenu() 隐藏菜单

提供的方法就这么多,也不难理解,这里再说一点注意事项

1.默认是不设置全局背景或者颜色的,所以如果需要全局颜色沉浸和背景沉浸请做相关设置.两种沉浸都兼容到4.4

2.全局颜色支持动态更换,全局图片背景不支持,当时想的是应该没有这种需求,当然如果有的话可以跟我反馈我会添加.

3.旋转动画其实就一个3D旋转效果比较好,其他的都是瞎添的,如果要用除3D旋转之外的旋转效果建议和透明度动画一起使用,可防止卡顿(单独用中心旋转卡顿明显,毕竟绘图的代价摆在那)

为了方便同学们对效果进行设置,我在演示Demo中添加了参数设置显示的效果,就在RecyclerView的第一个Item,并且是可以动态更改的,当前的效果需要如何设置参数全部在上面显示出来了.

另外用RecyclerView来显示提示的另一个目的是演示滑动冲突的处理,默认的是菜单和内容都是可以处理横向纵向的滑动操作的,只有当滑动在靠近菜单内容交集点的时候才会触发滑动.当然也可以设置全屏滑动和设置触发的范围,具体方法查看上面表格内的方法,这里就不重复了.

使用介绍就到这里了,下面介绍如何添加依赖库:

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			maven { url "https://jitpack.io" }
		}
	}
	
	

Step 2. Add the dependency

	dependencies {
	        compile 'com.github.Brioal:SwipeMenuDemo:1.5'
	}
	
	

或者可以下载Demo提取module添加

另外说一点其他的,本人开学大四,喜欢Android开发,目前还没有确定的工作,如果您有推荐可以进入我的另外一个博客查看简历:Brioal`s Blog

如果觉得我写的东西多多少少有一点可取之处,可以点个star,多的话也能写到简历装一下是吧~~麻烦了

大部分大学应该是不开Android开发的,在这里与所有自学Android的同学们共勉~自学不容易啊!!

另外我建了个qq群,方便交流,欢迎各种大神,新手老手加入,群号码:375276053

差点忘了,本库用到的一些代码片段来自网络,贴一下地址,感谢大神的代码:

沉浸状态栏

教你一分钟实现动态模糊效果