diff --git a/README.md b/README.md index 4f3fb8a..e360b97 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ -##效果演示: -##注意:因为 好几个同学都遇到了刷新不及时以及类似的问题,所以请暂时不要用这个库,我会在近期修复,下面放一个替代的库 -####[SlidingMenu](https://github.com/jfeinstein10/SlidingMenu),造成的不便请大家谅解 -##首先是实现效果的总览: +## 效果演示: +## 注意:因为 好几个同学都遇到了刷新不及时以及类似的问题,所以请暂时不要用这个库,我会在近期修复,下面放一个替代的库 +#### [SlidingMenu](https://github.com/jfeinstein10/SlidingMenu),造成的不便请大家谅解 +## 首先是实现效果的总览: ![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/summary1.png)![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/summary2.png) -##然后是单独动画效果的演示: +## 然后是单独动画效果的演示: 动画分类|演示图|动画分类|效果图 :--|:--|:--|:-- 位移动画|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/1.gif)|缩放动画|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/2.gif) @@ -11,17 +11,17 @@ 全局图片沉浸|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/5.gif)|模糊背景|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/6.gif) 动态模糊|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/7.gif)|反向动态模糊|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/8.gif) 组合动画1|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/9.gif)|组合动画2|![这里写图片描述](https://github.com/Brioal/SwipeMenuDemo/blob/master/art/10.gif) -###好了,就演示这么多了,因为组合动画太多了,演示不完的 -###简单计算一下: +### 好了,就演示这么多了,因为组合动画太多了,演示不完的 +### 简单计算一下: ``` (位移动画(3种)*缩放动画(2种)*透明动画(2种)*旋转动画(6种),图片背景效果(4种)=288(种), 另外包括缩放,透明度,3D旋转,动态模糊都能设置范围,所以可定制的效果就更多了. ``` -###使用方法: -###用于测试的`Demo`上演示了很多效果,同时动态的显示了当前效果要进行的代码设置方法,同时还包含一些小提示,建议您先下个`Demo`先看看.[Demo下载](http://www.brioal.cn/apks/SwipeMenuDemo.apk) -###`xml`布局文件中的使用方法: +### 使用方法: +### 用于测试的`Demo`上演示了很多效果,同时动态的显示了当前效果要进行的代码设置方法,同时还包含一些小提示,建议您先下个`Demo`先看看.[Demo下载](http://www.brioal.cn/apks/SwipeMenuDemo.apk) +### `xml`布局文件中的使用方法: ``` ``` -###布局文件非常简单,包含两个`xml`布局,上边的是菜单布局,下边的是内容布局 -###如果是最简单的使用那么这样设置已经足够了,默认的是固定不动的滑动方式 -###如果要对滑动的参数和效果进行定制,那么可以看一下资源文件中的设置(都有注释,理解起来不难) +### 布局文件非常简单,包含两个`xml`布局,上边的是菜单布局,下边的是内容布局 +### 如果是最简单的使用那么这样设置已经足够了,默认的是固定不动的滑动方式 +### 如果要对滑动的参数和效果进行定制,那么可以看一下资源文件中的设置(都有注释,理解起来不难) ``` @@ -59,14 +59,14 @@ ``` -###关于动画代码这里解释一下 -###为了方便定制动画效果,用一个4位数字来表示不同的动画组合,个位代表的旋转动画效果序号,十位代表透明度动画效果,千位代表缩放动画效果,万位代表位移动画效果,各个位置的起始都是1,有几种动画效果上限就是多少.比如位移动画有三种,则万位的范围就为1~3,其他依次类推. -####注:因为背景,模糊效果会引入多余的组件,所以只在需要的时候添加进去,故不包含在动画代码中,设置方式下面再说. -###再贴一个`xml`属性与代码的实现表格 +### 关于动画代码这里解释一下 +### 为了方便定制动画效果,用一个4位数字来表示不同的动画组合,个位代表的旋转动画效果序号,十位代表透明度动画效果,千位代表缩放动画效果,万位代表位移动画效果,各个位置的起始都是1,有几种动画效果上限就是多少.比如位移动画有三种,则万位的范围就为1~3,其他依次类推. +#### 注:因为背景,模糊效果会引入多余的组件,所以只在需要的时候添加进去,故不包含在动画代码中,设置方式下面再说. +### 再贴一个`xml`属性与代码的实现表格 代码实现|xml实现|功能 :--|:--|:-- -`void setStyleCode(int type)`|sm_type`|设置动画效果代码 +`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`|设置起始缩放 @@ -84,15 +84,15 @@ `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: +## 提供的方法就这么多,也不难理解,这里再说一点注意事项 +### 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 { @@ -104,7 +104,7 @@ ``` -##Step 2. Add the dependency +## Step 2. Add the dependency ``` dependencies { @@ -113,12 +113,12 @@ ``` -##或者可以下载`Demo`提取`module`添加 +## 或者可以下载`Demo`提取`module`添加 -##另外说一点其他的,本人开学大四,喜欢`Android`开发,目前还没有确定的工作,如果您有推荐可以进入我的另外一个博客查看简历:[Brioal`s Blog](http://www.brioal.cn/wordpress/) -##如果觉得我写的东西多多少少有一点可取之处,可以点个star,多的话也能写到简历装一下是吧~~麻烦了 -##大部分大学应该是不开`Android`开发的,在这里与所有自学`Android`的同学们共勉~自学不容易啊!! -##另外我建了个qq群,方便交流,欢迎各种大神,新手老手加入,群号码:`375276053` -##差点忘了,本库用到的一些代码片段来自网络,贴一下地址,感谢大神的代码: -###[沉浸状态栏](https://github.com/laobie/StatusBarUtil) -###[教你一分钟实现动态模糊效果](http://mp.weixin.qq.com/s?__biz=MzA5MzI3NjE2MA==&mid=2650236619&idx=1&sn=7f4f97babcad9f62607e544efaf2d86e&scene=23&srcid=0809CmU7E9JVZ0ZIyCvG4nLh#rd) +## 另外说一点其他的,本人开学大四,喜欢`Android`开发,目前还没有确定的工作,如果您有推荐可以进入我的另外一个博客查看简历:[Brioal`s Blog](http://www.brioal.cn/wordpress/) +## 如果觉得我写的东西多多少少有一点可取之处,可以点个star,多的话也能写到简历装一下是吧~~麻烦了 +## 大部分大学应该是不开`Android`开发的,在这里与所有自学`Android`的同学们共勉~自学不容易啊!! +## 另外我建了个qq群,方便交流,欢迎各种大神,新手老手加入,群号码:`375276053` +## 差点忘了,本库用到的一些代码片段来自网络,贴一下地址,感谢大神的代码: +### [沉浸状态栏](https://github.com/laobie/StatusBarUtil) +### [教你一分钟实现动态模糊效果](http://mp.weixin.qq.com/s?__biz=MzA5MzI3NjE2MA==&mid=2650236619&idx=1&sn=7f4f97babcad9f62607e544efaf2d86e&scene=23&srcid=0809CmU7E9JVZ0ZIyCvG4nLh#rd)