SlideBack

Introduction: 无需继承的 Activity 侧滑返回库 类全面屏返回手势效果 仿“即刻”侧滑返回
More: Author   ReportBugs   
Tags:

无需继承的 Activity 侧滑返回库 类全面屏返回手势效果 仿“即刻”侧滑返回 JitPack


前情

最近一直在研究侧滑返回效果的实现,目前比较多的方案如下:

  1. 背景透明主题。问题是性能与神坑"Only fullscreen activities can request orientation"。
  2. 将上页 ContentView 绘制到当前页,侧滑时动画推入推出。(也许挺不错?)
  3. 类全面屏返回手势。即刻 App的效果(下图)。

本库这里选择了方案 3。

预览

即刻 App 本库 Demo 下载


Demo 下载

使用

  • 引用类库 *请将 last-version 替换为最新版本号
     // 1.添加 jitpack 仓库
     allprojects {
         repositories {
             ...
             maven { url 'https://jitpack.io' }
         }
     }
     // 2.添加项目依赖(last-version 替换为最新版本号)
     dependencies {
         implementation 'com.github.ParfoisMeng:SlideBack:last-version'
     }
    
  • 代码简单使用,详见下方 API

      // 在需要滑动返回的 Activity 中注册,最好但非必须在 onCreate 中
      SlideBack.with(this)
              .callBack(new SlideBackCallBack() {
                  @Override
                  public void onSlideBack() {
                      finish();
                  }
              })
              .register();
    
      // onDestroy 时解绑
      // 内部使用 WeakHashMap,理论上不解绑也行,但最好还是手动解绑一下
      SlideBack.unregister(this);
    

OJBK!So easy!

  • Fragment 支持,详见 issues#2
    1. 在 Fragment 的父级 Activity 中注册 SlideBack
    2. 在 SlideBackCallBack 中 remove 栈顶的 Fragment
旧方法仍然可用,点击展开查看 // Kotlin class SecondActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // 在需要滑动返回的 Activity 中注册 SlideBack.register(this) { Toast.makeText(this, "SlideBack", Toast.LENGTH_SHORT).show() } } override fun onDestroy() { super.onDestroy() // onDestroy 时记得解绑 // 内部使用 WeakHashMap,理论上不解绑也行,但最好还是手动解绑一下 SlideBack.unregister(this) } } // Java public class SecondActivity extends AppCompatActivity { @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 在需要滑动返回的 Activity 中注册 SlideBack.register(this, new SlideBackCallBack() { @Override public void onSlideBack() { Toast.makeText(SecondActivity.this, "SlideBack", Toast.LENGTH_SHORT).show(); } }); } @Override protected void onDestroy() { super.onDestroy(); // onDestroy 时记得解绑 // 内部使用 WeakHashMap,理论上不解绑也行,但最好还是手动解绑一下 SlideBack.unregister(this); } } // 如果需要在有可滑动 View(RecycleView/ScrollView 等)的 Activity 中使用,请使用此注册方法。 // haveScroll:页面是否有滑动 SlideBack.register(Activity activity, boolean haveScroll, SlideBackCallBack callBack)

API

SlideBack.with(this) // 新 构建侧滑管理器 - 用于更丰富的自定义配置
        .haveScroll(false) // 是否包含滑动控件 默认 false
        .edgeMode(edgeMode) // 边缘侧滑模式 默认左
        .callBack(new SlideBackCallBack() { // 回调
            @Override
            public void onSlideBack() {
                // TODO 回调事件
            }
        })
        .callBack(new SlideCallBack() { // 回调 2 适用于设置左右模式 *两种回调同时写,后者会覆盖前者
            @Override
            public void onSlide(int edgeFrom) {
                // TODO edgeFrom(滑动来源): EDGE_LEFT(左侧) EDGE_RIGHT(右侧)
            }
        })
        .viewHeight(viewHeightDP) // 控件高度 默认屏高/4
        .arrowSize(arrowSizeDP) // 箭头大小 默认 5dp
        .maxSlideLength(maxSlideLengthDP) // 最大拉动距离(控件最大宽度) 默认屏宽/12
        .sideSlideLength(sideSlideLengthDP) // 侧滑响应距离 默认控件最大宽度/2
        .dragRate(dragRate) // 阻尼系数 默认 3(越小越灵敏)
        .register();

性能

附一张性能截图。可以看出来中间进行了很多次 onCreate & onDestroy,最后内存和开始时一致:

MEMORY

分析

源码分析 MD:Analysis.md & Analysis_v2.md

感谢

感谢 ChenTianSaber 的开源库 SlideBack掘金)提供的思路与源码

更新

  1. 包含滑动控件的页面设置 EDGE_BOTH 时右侧滑动失效的 Bug 修复 issues#6 - 1.0.6
  2. 支持设置屏幕左右侧侧滑 issues#4 - 1.0.5
  3. 提供新的可配置更多参数的注册方法(旧方法仍然可用) - 1.0.4
  4. 滑动事件冲突问题,修复 issues#1 - 1.0.3
  5. 删除无用依赖,添加 Java 引用示例 - 1.0.2
  6. 检查警告,修改类名,更新 README.md - 1.0.1
  7. 初版发布 - 1.0.0

计划

  1. 源码分析 MD 给郭婶投两稿也没通过……啥时候有想法再重写吧 :-(
  2. 目前滑动事件冲突的解决方案(1.0.3)不是很理想,但市面上好像都是这么解决的,如果您有更好的方案,请与我沟通,十分欢迎 PR。
  3. 看情况吧......

支持

劳烦各位大佬给个 Star 让我出去好装 B 行嘛!

其他

已使用996 License,为程序员发声,为自己发声。

996.icu

Support Me
Apps
About Me
Google+: Trinea trinea
GitHub: Trinea