Awesome
效果演示:
注意:因为 好几个同学都遇到了刷新不及时以及类似的问题,所以请暂时不要用这个库,我会在近期修复,下面放一个替代的库
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'
}