Skip to content

oubowu/SlideBack

Repository files navigation

高仿微信视差手势滑动返回库(实验性质,请勿用于商业开发)

实现思路参考自「Slidr」和「and_swipeback

功能

  • 无需设置Activity主题透明
  • 支持动态切换全局或边缘滑动,亦可动态禁止或恢复滑动
  • 支持动态设置边缘响应和滑动关闭距离的阈值
  • 页面边缘附有阴影并随滑动距离而渐变
  • 优化了与RecyclerView、ViewPager等滑动控件手势冲突
  • 支持屏幕旋转

效果图

Demo Demo

使用方法

1. 继承Application实现Activity生命周期的监听,ActivityHelper用于保存Activity栈供侧滑库使用

public class MyApplication extends Application {

    private ActivityHelper mActivityHelper;

    private static MyApplication sMyApplication;

    @Override
    public void onCreate() {
        super.onCreate();

        mActivityHelper = new ActivityHelper();
        registerActivityLifecycleCallbacks(mActivityHelper);

        sMyApplication = this;

    }

    public static ActivityHelper getActivityHelper(){
        return sMyApplication.mActivityHelper;
    }
    
}

2.在需要滑动的Activity使用SlideBackHelper去attach当前Activity

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_second);

    mSlideBackLayout = SlideBackHelper.attach(
            // 当前Activity
            this,
            // Activity栈管理工具
            MyApplication.getActivityHelper(),
            // 参数的配置
            new SlideConfig.Builder()
                    // 屏幕是否旋转
                    .rotateScreen(true)
                    // 是否侧滑
                    .edgeOnly(false)
                    // 是否禁止侧滑
                    .lock(false)
                    // 边缘滑动的响应阈值,0~1,对应屏幕宽度*percent
                    .edgePercent(0.1f)
                    // 关闭页面的阈值,0~1,对应屏幕宽度*percent
                    .slideOutPercent(0.5f).create(),
            // 滑动的监听
            null);
           
    // 其它初始化
}

3.如果开启了屏幕旋转,SlideBackLayout需要监听Activity的结束事件,例如这里的onBackPressed,所以你需要在调用结束事件的地方加上SlideBackLayout.isComingToFinish()

@Override
public void onBackPressed() {
    super.onBackPressed();
    mSlideBackLayout.isCommingToFinish();
    overridePendingTransition(R.anim.anim_none, R.anim.anim_slide_out);
}

4.SlideBackHelper.attach会返回处理侧滑的SlideBackLayout,可在适当时候动态控制侧滑几个参数

  // 是否启用边缘滑动
  mSlideBackLayout.edgeOnly(boolean);
  // 是否禁止滑动
  mSlideBackLayout.lock(boolean);
  // 设置边缘滑动的响应阈值
  mSlideBackLayout.setEdgeRangePercent(float);
  // 设置关闭页面的阈值
  mSlideBackLayout.setSlideOutRangePercent(float);

存在问题

旋转屏幕后上一个Activity的布局也会随之旋转,但是ToolBar比例还是维持旋转之前的比例,无从下手,希望有大神告知>_<
沉浸式状态栏支持有问题
多个滑动页面快速返回有空指针问题,只能等页面取点焦点的时候才能滑动

License

Copyright 2016 oubowu

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

A library to close an activity with swipe gestures.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages