• Stars
    star
    2,309
  • Rank 19,218 (Top 0.4 %)
  • Language
    Java
  • Created over 7 years ago
  • Updated almost 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Android Activity 滑动返回。支持微信滑动返回样式、横屏滑动返回、全屏滑动返回

🏃BGASwipeBackLayout-Android🏃

强烈建议与 StatusBarUtil 结合着一起使用

常见问题与反馈

1.使用透明主题时,滑动返回看见了 Launcher

保证栈底 Activity 的主题是不透明的。例如 demo 中的首个 Activity 是 SplashActivity,进入主界面后 SplashActivity 就销毁了,此时 MainActivity 就是栈底 Activity,需保证 MainActivity 的主题不透明

2.使用非透明主题时,滑动返回结束时立即触摸界面应用程序崩溃

把该崩溃界面里比较特殊的 View 的 class 添加到集合中作为「BGASwipeBackHelper.init」的第2个参数,例如地图控件。目前在库中已经添加了 WebView 和 SurfaceView,不用再次添加这两个了

功能介绍

  • 通过修改 support-v4 包中 SlidingPaneLayout 的源码来实现滑动返回布局
  • 支持非透明主题滑动返回,不影响 Activity 生命周期
  • 动态设置滑动返回是否可用
  • 动态设置是否仅仅跟踪左侧边缘的滑动返回
  • 动态设置是否是微信滑动返回样式
  • 动态设置是否显示滑动返回的阴影效果
  • 支持全屏、横屏和竖屏

效果图与示例 apk

普通滑动返回样式 微信滑动返回样式
BGASwipeBackLayoutDemo BGASwipeBackLayoutDemo-WeChat
配合滑动删除列表一起使用 配合 RecycerView 一起使用
bgaswipebacklayout-swipe-delete bgaswipebacklayout-recycler-index

点击下载 BGASwipeBackLayoutDemo.apk 或扫描下面的二维码安装

BGASwipeBackLayoutDemo apk 文件二维码

1.添加 Gradle 依赖

  • maven { url 'https://jitpack.io' } 添加到 root build.gradle 的 repositories 中
  • 在 app build.gradle 中添加如下依赖,末尾的「latestVersion」指的是徽章 里的版本名称,请自行替换
implementation 'com.github.bingoogolapple:BGASwipeBackLayout-Android:latestVersion'
// 换成己工程里依赖的 support-v4 的版本
implementation 'androidx.legacy:legacy-support-v4:1.0.0'

2.必须在 Application 的 onCreate 方法中执行 BGASwipeBackHelper.init 来初始化滑动返回

public class App extends Application {

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

        /**
         * 必须在 Application 的 onCreate 方法中执行 BGASwipeBackHelper.init 来初始化滑动返回
         * 第一个参数:应用程序上下文
         * 第二个参数:如果发现滑动返回后立即触摸界面时应用崩溃,请把该界面里比较特殊的 View 的 class 添加到该集合中,目前在库中已经添加了 WebView 和 SurfaceView
         */
        BGASwipeBackHelper.init(this, null);
    }
}

3.将下面的代码拷贝到你自己的 BaseActivity 中,建议参考 demo 里的这个 BaseActivity 来设置界面跳转动画

public abstract class BaseActivity extends AppCompatActivity implements BGASwipeBackHelper.Delegate {
    protected BGASwipeBackHelper mSwipeBackHelper;
    protected Toolbar mToolbar;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        // 「必须在 Application 的 onCreate 方法中执行 BGASwipeBackHelper.init 来初始化滑动返回」
        // 在 super.onCreate(savedInstanceState) 之前调用该方法
        initSwipeBackFinish();
        super.onCreate(savedInstanceState);
    }

    /**
     * 初始化滑动返回。在 super.onCreate(savedInstanceState) 之前调用该方法
     */
    private void initSwipeBackFinish() {
        mSwipeBackHelper = new BGASwipeBackHelper(this, this);

        // 「必须在 Application 的 onCreate 方法中执行 BGASwipeBackHelper.init 来初始化滑动返回」
        // 下面几项可以不配置,这里只是为了讲述接口用法。

        // 设置滑动返回是否可用。默认值为 true
        mSwipeBackHelper.setSwipeBackEnable(true);
        // 设置是否仅仅跟踪左侧边缘的滑动返回。默认值为 true
        mSwipeBackHelper.setIsOnlyTrackingLeftEdge(true);
        // 设置是否是微信滑动返回样式。默认值为 true
        mSwipeBackHelper.setIsWeChatStyle(true);
        // 设置阴影资源 id。默认值为 R.drawable.bga_sbl_shadow
        mSwipeBackHelper.setShadowResId(R.drawable.bga_sbl_shadow);
        // 设置是否显示滑动返回的阴影效果。默认值为 true
        mSwipeBackHelper.setIsNeedShowShadow(true);
        // 设置阴影区域的透明度是否根据滑动的距离渐变。默认值为 true
        mSwipeBackHelper.setIsShadowAlphaGradient(true);
        // 设置触发释放后自动滑动返回的阈值,默认值为 0.3f
        mSwipeBackHelper.setSwipeBackThreshold(0.3f);
        // 设置底部导航条是否悬浮在内容上,默认值为 false
        mSwipeBackHelper.setIsNavigationBarOverlap(false);
    }

    /**
     * 是否支持滑动返回。这里在父类中默认返回 true 来支持滑动返回,如果某个界面不想支持滑动返回则重写该方法返回 false 即可
     *
     * @return
     */
    @Override
    public boolean isSupportSwipeBack() {
        return true;
    }

    /**
     * 正在滑动返回
     *
     * @param slideOffset 从 0 到 1
     */
    @Override
    public void onSwipeBackLayoutSlide(float slideOffset) {
    }

    /**
     * 没达到滑动返回的阈值,取消滑动返回动作,回到默认状态
     */
    @Override
    public void onSwipeBackLayoutCancel() {
    }

    /**
     * 滑动返回执行完毕,销毁当前 Activity
     */
    @Override
    public void onSwipeBackLayoutExecuted() {
        mSwipeBackHelper.swipeBackward();
    }

    @Override
    public void onBackPressed() {
        // 正在滑动返回的时候取消返回按钮事件
        if (mSwipeBackHelper.isSliding()) {
            return;
        }
        mSwipeBackHelper.backward();
    }
}

4.强烈强烈强烈建议把 BGASwipeBackHelper 里的每个方法的注释看一遍,只看注释就好

demo 中用到的第三方库

  • StatusBarUtil A util for setting status bar style on Android App
  • BGABaseAdapter-Android 在 AdapterView 和 RecyclerView 中通用的 Adapter 和 ViewHolder。RecyclerView 支持 DataBinding 、多种 Item 类型、添加 Header 和 Footer。RecyclerView 竖直方向通用分割线 BGADivider,吸顶分类
  • BGAProgressBar-Android 带百分比数字的水平、圆形进度条
  • BGARefreshLayout-Android 多种下拉刷新效果、上拉加载更多、可配置自定义头部广告位
  • BGASwipeItemLayout-Android 类似 iOS 带弹簧效果的左右滑动控件,可作为 AbsListView 和 RecyclerView 的 item
  • 谷爹的 support 包

代码是最好的老师,更多详细用法请查看 demo🐾

关于我

个人主页 邮箱 BGA 系列开源库 QQ 群 GitHub 喵(专注于 GitHub 等一切与程序员有关的内容)
bingoogolapple.cn [email protected] BGA_CODE_CLUB GitHub喵

打赏支持

如果您觉得 BGA 系列开源库帮你节省了大量的开发时间,请扫描下方的二维码随意打赏,要是能打赏个 10.24 🐵就太👍了。您的支持将鼓励我继续创作:octocat:

如果您目前正打算购买通往墙外的梯子,可以使用我的邀请码「YFQ9Q3B」购买 Lantern,双方都赠送三个月的专业版使用时间🍻

License

Copyright (C) 2012 The Android Open Source Project
Copyright 2016 bingoogolapple

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.

More Repositories

1

BGAQRCode-Android

QRCode 扫描二维码、扫描条形码、相册获取图片后识别、生成带 Logo 二维码、支持微博微信 QQ 二维码扫描样式
C
7,871
star
2

BGARefreshLayout-Android

多种下拉刷新效果、上拉加载更多、可配置自定义头部广告位
Java
4,313
star
3

BGABanner-Android

引导界面滑动导航 + 大于等于1页时无限轮播 + 各种切换动画轮播效果
Java
4,160
star
4

BGABadgeView-Android

Android 徽章控件
Java
2,652
star
5

BGAPhotoPicker-Android

Android 图片选择、预览、九宫格图片控件、拖拽排序九宫格图片控件
Java
2,229
star
6

BGABaseAdapter-Android

在 AdapterView 和 RecyclerView 中通用的 Adapter 和 ViewHolder。RecyclerView 支持 DataBinding 、多种 Item 类型、添加 Header 和 Footer。RecyclerView 竖直方向通用分割线 BGADivider
Java
657
star
7

BGATransformersTip-Android

Android 通用 PopupWindow,再也不用找 UI 小姐姐切 .9 图片了,大致能为你节省 30 分钟的开发时间
Java
487
star
8

BGASwipeItemLayout-Android

类似 iOS 带弹簧效果的左右滑动控件,可作为 AbsListView 和 RecyclerView 的 item(作为 AbsListView 的 item 时的点击事件参考代码家的 https://github.com/daimajia/AndroidSwipeLayout )
Java
469
star
9

bga_issue_blog

Flutter 或 Vue 全家桶(Vue + VueRouter + Vuex + Axios)抓取 GitHub 上的 Issues,结合 GitHub Pages 搭建个人博客站点,支持 GitHub 登录和评论
Dart
270
star
10

BGAProgressBar-Android

带百分比数字的水平、圆形进度条
Java
252
star
11

BGATitleBar-Android

Android 仿 iOS UINavigationBar 风格的 TitleBar,适用于某些 UI 设计师只出 iOS 效果图的项目
Java
245
star
12

BGAFlowLayout-Android

Android 流式布局,可配置是否将每一行的空白区域平均分配给子控件
Java
202
star
13

BGAUpdate-Android

RxJava + Retrofit 下载新版 apk 文件,RxBus 监听下载进度
Java
194
star
14

AppInit

AppInit 是一款 Android 应用初始化框架,基于组件化的设计思路,功能灵活,使用简单。
Groovy
191
star
15

bingoogolapple.github.io

个人主页。同时也通过 Issues 记录学习笔记
HTML
86
star
16

BGACamera-Android

Android 相机开发学习笔记,参考 https://www.polarxiong.com/tag/camera
Kotlin
42
star
17

react-native-bga-badge-view

桥接 Android 中的自定义徽章控件到 React Native 的案例
Java
36
star
18

BGAAlertController-Android

仿写从 iOS8 开始支持的 UIAlertController
Java
34
star
19

BGARefreshLayoutDemo

测试 BGARefreshLayout 与 Activity、Fragment、ViewPager 的各种嵌套
Java
30
star
20

BGAWeiBo-Android

调用微博开放API模仿新浪微博Android客户端
Java
29
star
21

bga-back-top-vue

Vue-based back-top component 基于 Vue 2.x 实现的「滚动可滚动组件到顶部」的组件,支持多种自定义属性配置,以及通过 slot 插桩的方式深度定制 BgaBackTop 的内容。整个项目只需要在根组件中添加一次即可
Vue
29
star
22

BGAIndicator-Android

滑动指示器
Java
27
star
23

AndroidCustomViewPlayground

Android 自定义控件游乐场
Java
25
star
24

BGAOkVolley-Android

Volley+OkHttp+Gson
Java
24
star
25

HarmonyOS-Note

鸿蒙学习笔记
JavaScript
24
star
26

Graduation-Design

毕业设计
Java
20
star
27

bga-dart-full-stack-note

Dart 全栈开发学习笔记
JavaScript
18
star
28

BGAImageView-Android

Java
14
star
29

Meiqia-SDK-Android-UE-EC

Java
14
star
30

MediaNote-Android

Android音视频播放学习笔记
Java
12
star
31

BGAMenu

滑动菜单
Java
11
star
32

BGASelectView-Android

类似 web 开发中的 select 标签实现的级联效果
Java
11
star
33

bga-chrome-plugin-note

Chrome 插件开发学习笔记
JavaScript
10
star
34

BGAAnnotation-Android

Android Annotation
Java
9
star
35

XMPPNote-Android

Android平台XMPP学习笔记
Java
8
star
36

Android-Training

2013年android实训
Java
8
star
37

AndroidGameNote

AndroidGameNote
Java
7
star
38

PublishAar

发布Aar到Maven中央仓库和Bintray中
7
star
39

ControlToggleView

控制开关,点击开关后提供回调接口来处理是否执行某项操作
Java
6
star
40

NDKNote-AndroidStudio

AndroidStudio 版的 NDK 学习笔记
C
6
star
41

DataBindingNote

DataBinding学习笔记
Java
6
star
42

MaterialDesignSupportNote

MaterialDesignSupportLibrary学习笔记
Java
5
star
43

OCNote-PartOne

OC学习笔记第一部分
Objective-C
5
star
44

AndroidNote-PartOne

Android学习笔记
Java
5
star
45

RedEnvelope

过年期间自动抢支付宝红包
Java
5
star
46

SwiftNote-PartOne

Swift学习笔记第一部分
Swift
4
star
47

spring-boot-kotlin

Spring Boot Kotlin
JavaScript
3
star
48

plugin-idea

IDEA 插件学习
Kotlin
3
star
49

SwiftNote-PartTwo

Swift学习笔记第二部分
Objective-C
3
star
50

GradlePluginNote

Groovy
3
star
51

AptNote

Java
3
star
52

AlgorithmAndDesignPatternNote

算法和设计模式学习笔记
Java
3
star
53

dsl-note

Groovy、Gradle、Kotlin 学习笔记
Java
3
star
54

GradleNote

Gradle学习笔记
Java
2
star
55

bga-js-full-stack-note

JS 全栈开发学习笔记
TypeScript
2
star
56

bga-ss-docker

ShadowSocks Docker 镜像,带 UI 界面
Dockerfile
2
star
57

BGABlogBackup

博客备份
CSS
2
star
58

bga-vite-plugin-crx-hmr

用于开发 Chromium manifest v3 插件的 Vite 插件,主要提供热重载功能,快速更新,高效开发
TypeScript
2
star
59

cc-dxg-2d

基于 Cocos Creator 开发的智能版大西瓜小芝麻
TypeScript
2
star
60

bga-vscode-plugin-note

VS Code 插件开发学习笔记
TypeScript
2
star
61

bga-rust-full-stack-note

Rust 全栈开发学习笔记
Rust
2
star
62

js-full-stack-demo

JavaScript
1
star
63

xcx-wx-note

微信小程序学习笔记
JavaScript
1
star
64

BGAChartViewDemo-iOS

iOS自定义图表控件案例
Objective-C
1
star
65

NodeJSNote

NodeJS学习笔记
JavaScript
1
star
66

ReactNativeNote

ReactNative学习笔记
JavaScript
1
star
67

bga-ci-docker

CI 相关 Docker 镜像
Dockerfile
1
star
68

JSFullStackNote

JSFullStackNote
JavaScript
1
star
69

BGACalendar-Android

Android日历和时间选择控件
Java
1
star
70

golang-note

Golang 学习笔记
Go
1
star
71

gang-hui-parking-payment

港汇停车缴费
1
star
72

PythonNote

Python 学习笔记
Python
1
star
73

BGAImageLoader-Android

Java
1
star
74

OCNote-PartTwo

OC学习笔记第二部分
Objective-C
1
star
75

taro-note

taro 学习笔记
JavaScript
1
star