无需继承的Activity侧滑返回库 类全面屏返回手势效果 仿“即刻”侧滑返回
Clone or download
Latest commit aa1f035 Jan 18, 2019

README.md

SlideBack

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


前情

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

  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'
	}
  • 代码使用
    // 在需要滑动返回的Activity中注册,最好但非必须在onCreate中
    SlideBack.with(this)
            .callBack(new SlideBackCallBack() {
                @Override
                public void onSlideBack() {
                    finish();
                }
            })
            .register();

    // onDestroy时解绑
    // 内部使用WeakHashMap,理论上不解绑也行,但最好还是手动解绑一下
    SlideBack.unregister(this);

OJBK!So easy!

  • 旧方法仍然可用
点击展开查看
// 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
        .callBack(SlideBackCallBack) // 回调
        .viewHeight(viewHeightDP) // 控件高度 默认屏高/4
        .arrowSize(arrowSizeDP) // 箭头大小 默认5dp
        .maxSlideLength(maxSlideLengthDP) // 最大拉动距离(控件最大宽度) 默认屏宽/12
        .sideSlideLength(sideSlideLengthDP) // 侧滑响应距离 默认控件最大宽度/2
        .dragRate(dragRate) // 阻尼系数 默认3(越小越灵敏)
        .register();
  • Fragment 支持,详见 issues#2
    1. 在Fragment的父级Activity中注册SlideBack
    2. 在SlideBackCallBack中remove栈顶的Fragment

性能

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

分析

源码分析MD:Analysis.md

感谢

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

更新

  1. 提供新的可配置更多参数的注册方法(旧方法仍然可用) - 1.0.4
  2. 滑动事件冲突问题,修复 issues#1 - 1.0.3
  3. 删除无用依赖,添加Java引用示例 - 1.0.2
  4. 检查警告,修改类名,更新README.md - 1.0.1
  5. 初版发布 - 1.0.0

计划

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

支持

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

其他

  • 赏杯咖啡
Alipay WeChat Pay