SlidingPaneLayout详解

作者: diygreen | 来源:发表于2016-05-26 06:39 被阅读7594次
    SlidingPaneLayout详解

    作者:李旺成

    时间:2016年5月25日


    简介

    SlidingPaneLayout 可能很多人都没用过,但这并不是一个新控件。SlidingPaneLayout 是 Support V4 包中提供的,2013 年 Google I/O 大会期间更新的。

    先来看看这个 SlidingPaneLayout 到底是什么?

    官方介绍

    了解一个控件,一般习惯先看它的继承结构和官方介绍:

    SlidingPaneLayout类

    继承自 ViewGroup,那说明这是个容器。继续看文档,我们可以了解到:
    SlidingPaneLayout 是一个水平的多层的布局控件,左侧或者第一个子视图是它的导航视图,其他的是内容视图。其实,这就是一个左滑菜单的官方实现。

    直接看看怎么使用吧!

    简单使用

    先看效果:

    简单使用

    上面介绍的时候说了,这就是一个容器,水平的多层的布局控件,那好就往里面放控件就好了,试试:

    在布局中使用:activity_simpleuse1.xml

    <?xml version="1.0" encoding="utf-8"?>
    <android.support.v4.widget.SlidingPaneLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:id="@+id/spl_root"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context=".simple.SimpleUse2Activity">
        <TextView
            android:id="@+id/tv_left"
            android:layout_width="120dp"
            android:layout_height="match_parent"
            android:text="左侧菜单"
            android:textSize="22sp"
            android:background="#ff0000"/>
        <TextView
            android:id="@+id/tv_right"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:text="这是内容"
            android:textSize="24sp"
            android:background="@color/colorPrimaryDark"/>
    </android.support.v4.widget.SlidingPaneLayout>
    

    好了,直接运行起来,对,就是上面动图的效果。

    结合 Fragment

    一般做侧滑菜单都会使用 Fragment 来解耦菜单和详情页面,当然 SlidingPaneLayout 也支持这样使用。

    结合Fragment使用

    在布局中使用:activity_simpleuse2.xml

    <?xml version="1.0" encoding="utf-8"?>
    <android.support.v4.widget.SlidingPaneLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:id="@+id/spl_root"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context=".simple.SimpleUse2Activity">
        <fragment
            android:id="@+id/fragment_leftmenu"
            android:name="com.diygreen.slidingpanelayoutdemo.simple.LeftMenuFragment"
            android:layout_width="100dp"
            android:layout_height="match_parent"
            android:layout_gravity="left"/>
        <fragment
            android:id="@+id/fragment_rightcontent"
            android:name="com.diygreen.slidingpanelayoutdemo.simple.RightContentFragment"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:layout_weight="1"
            android:layout_gravity="right"/>
    </android.support.v4.widget.SlidingPaneLayout>
    

    在 Java 代码中使用:SimpleUse2Activity.java

    public class SimpleUse2Activity extends AppCompatActivity implements
            LeftMenuFragment.BookMarkListener, SlidingPaneLayout.PanelSlideListener {
    
        private SlidingPaneLayout mRootSPL;
        private LeftMenuFragment mLeftFragment;
        private RightContentFragment mRightFragment;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_simpleuse2);
    
            initView();
            initListener();
        }
    
        private void initView() {
            mRootSPL = (SlidingPaneLayout) findViewById(R.id.spl_root);
            mLeftFragment = (LeftMenuFragment) getFragmentManager().findFragmentById(R.id.fragment_leftmenu);
            mRightFragment = (RightContentFragment) getFragmentManager().findFragmentById(R.id.fragment_rightcontent);
        }
    
        private void initListener() {
            mRootSPL.setPanelSlideListener(this);
            mLeftFragment.setListener(this);
        }
    
        @Override
        public void onChangeBookMark(String bookMark) {
            mRightFragment.setContent(bookMark);
        }
    
        @Override
        public void onPanelSlide(View panel, float slideOffset) {
        }
    
        @Override
        public void onPanelOpened(View panel) {
            mLeftFragment.setHasOptionsMenu(true);
        }
    
        @Override
        public void onPanelClosed(View panel) {
            mLeftFragment.setHasOptionsMenu(false);
        }
    }
    

    在这个 Activity 里面使用的两个 Fragment 很简单了,这里就不贴代码了,有兴趣的去源码里面看吧!

    滑动关闭 Activity

    上面用了两个小实例介绍了 SlidingPaneLayout 的简单使用,下面看看进阶的用法。

    iOS 7 提供了一个比较人性化的体验:手势滑动返回。Android 并不没有原生支持该功能,但是,当时刚出先这个效果的时候,就有大牛开源了一个库用于在 Android 上滑动返回。这里我们可以不借助这个开源库,利用 SlidingPaneLayout 就可以实现这个效果。

    先看效果:

    滑动关闭Activity

    思路分析

    说明,这不是我想出来的,我只是在这里做一个简单的介绍。

    1、效果分析
    我们分析一下滑动关闭的效果:就是随着手势右移,当前 Activity 的窗口整个向右移动,而其左侧滑出的区域可以看到下面的 Activity。

    2、关于左滑菜单
    有没有感觉这和一些左滑菜单很像,只是它的左侧“菜单”是透明的,而且可以覆盖整个屏幕。

    3、实现思路
    那好,可以这样,用一个透明的全屏布局作为左侧菜单,这样就可以看到当前 Activity 下面的 Activity了;然后,当菜单全部打开的时候关闭当前 Activity,这样就可以实现左滑关闭的效果了。

    编码实现

    1、实现透明 Activity
    为什么要用透明 Activity?不知道的可以参考一下这篇文章:Hacks控件篇-Hack7 移除背景以提升Activity启动速度

    先定义透明 Activity 的样式:

    <style name="DIY.SlideClose.Transparent.Theme" parent="AppTheme">
        <item name="android:windowBackground">@android:color/transparent</item>
        <item name="android:windowIsTranslucent">true</item>
        <item name="android:windowAnimationStyle">@style/DIY.Animation.SlidingBack</item>
        <item name="android:actionBarStyle">@style/DIYActionBar.Custom</item>
    </style>
    
    <style name="DIYActionBar.Custom" parent="@style/Widget.AppCompat.Light.ActionBar.Solid.Inverse">
        <item name="displayOptions">showCustom</item>
        <item name="android:background">@android:color/transparent</item>
        <item name="background">@android:color/transparent</item>
        <item name="android:displayOptions" tools:ignore="NewApi">showCustom</item>
        <item name="android:height">?actionBarSize</item>
    </style>
    
    <style name="DIY.Animation.SlidingBack" parent="@android:style/Animation.Activity">
        <item name="android:activityOpenEnterAnimation">@anim/slide_in_right</item>
        <item name="android:activityOpenExitAnimation">@anim/slide_out_right</item>
        <item name="android:activityCloseEnterAnimation">@anim/slide_in_right</item>
        <item name="android:activityCloseExitAnimation">@anim/slide_out_right</item>
        <item name="android:wallpaperOpenEnterAnimation">@anim/slide_in_right</item>
        <item name="android:wallpaperOpenExitAnimation">@anim/slide_out_right</item>
        <item name="android:wallpaperCloseEnterAnimation">@anim/slide_in_right</item>
        <item name="android:wallpaperCloseExitAnimation">@anim/slide_out_right</item>
        <item name="android:wallpaperIntraOpenEnterAnimation">@anim/slide_in_right</item>
        <item name="android:wallpaperIntraOpenExitAnimation">@anim/slide_out_right</item>
        <item name="android:wallpaperIntraCloseEnterAnimation">@anim/slide_in_right</item>
        <item name="android:wallpaperIntraCloseExitAnimation">@anim/slide_out_right</item>
    </style>
    

    然后,使用样式:

    <activity
        android:name=".slideclose.NextActivity"
        android:label="NextActivity"
        android:theme="@style/DIY.SlideClose.Transparent.Theme" />
    

    2、实现可以滑动删除的基类 Activity

    public class BaseSlideCloseActivity extends AppCompatActivity implements
            SlidingPaneLayout.PanelSlideListener {
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            initSlideBackClose();
            super.onCreate(savedInstanceState);
        }
    
        private void initSlideBackClose() {
            if (isSupportSwipeBack()) {
                SlidingPaneLayout slidingPaneLayout = new SlidingPaneLayout(this);
                // 通过反射改变mOverhangSize的值为0,
                // 这个mOverhangSize值为菜单到右边屏幕的最短距离,
                // 默认是32dp,现在给它改成0
                try {
                    Field overhangSize = SlidingPaneLayout.class.getDeclaredField("mOverhangSize");
                    overhangSize.setAccessible(true);
                    overhangSize.set(slidingPaneLayout, 0);
                } catch (Exception e) {
                    e.printStackTrace();
                }
                slidingPaneLayout.setPanelSlideListener(this);
                slidingPaneLayout.setSliderFadeColor(getResources()
                        .getColor(android.R.color.transparent));
    
                // 左侧的透明视图
                View leftView = new View(this);
                leftView.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
                slidingPaneLayout.addView(leftView, 0);
    
                ViewGroup decorView = (ViewGroup) getWindow().getDecorView();
    
    
                // 右侧的内容视图
                ViewGroup decorChild = (ViewGroup) decorView.getChildAt(0);
                decorChild.setBackgroundColor(getResources()
                        .getColor(android.R.color.white));
                decorView.removeView(decorChild);
                decorView.addView(slidingPaneLayout);
    
                // 为 SlidingPaneLayout 添加内容视图
                slidingPaneLayout.addView(decorChild, 1);
            }
        }
    
        protected boolean isSupportSwipeBack() {
            return true;
        }
    
        @Override
        public void onPanelSlide(View panel, float slideOffset) {
    
        }
    
        @Override
        public void onPanelOpened(View panel) {
            finish();
        }
    
        @Override
        public void onPanelClosed(View panel) {
    
        }
    }
    

    关键代码都有注释,直接看注释吧。

    3、使用可滑动删除的基类 Activity
    就和定义普通的 Activity 一样,这是需要继承上面的基类,并且在清单文件中使用透明样式:

    public class NextActivity extends BaseSlideCloseActivity {
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_next);
        }
    }
    

    小结

    好了,对 SlidingPaneLayout 的介绍就到这里了,SlidingPaneLayout 的使用还是很简单的,但是利用好了可以实现一些看上去可能比较难实现的效果。

    项目地址

    SlidingPaneLayoutDemo

    参考

    Android-通过SlidingPaneLayout高仿微信6.2最新版手势滑动返回(一)
    SlidingPaneLayout的基本使用
    Android UI开发第三十四篇——SlidingPaneLayout

    相关文章

      网友评论

      • 阿西吧喽:decorView.removeView(decorChild); 这代码起什么作用,移除第一个view,不加会有什么特别现象出现吗?
      • IT小生123:大神,我什么我实现的时候,左侧有一整屏的白屏,然后白屏滑过才是底下的界面呢?
        IT小生123:@IT小生123 说错了,是继承BaseSlideCloseActivity类
        IT小生123:哈哈,问题已解决,原因是我在AndroidManifest.xml里的Activity中没有加上android:theme="@style/DIY.SlideClose.Transparent.Theme"这句,注意:想让哪个Activity界面实现右滑返回的效果,就让那个Activity继承SlidingPaneLayout,并且加上theme。
      • 寒平洛一:请教一个问题:我用SlidingPaneLayout实现一个和QQ6.6类似的菜单效果,但是右滑菜单展开后,不能通过左滑菜单区域来收起菜单。就和知乎里这个问题一样https://www.zhihu.com/question/53142114
      • 胡哈哈哈:BaseSlideCloseActivity
      • 胡哈哈哈:写的很好,请教一个问题。aseSlideCloseActivity中init时decorChild.setBackgroundColor(getResources().getColor(android.R.color.white));的目的是什么?谢谢:D
        胡哈哈哈:@diygreen 恩 手动添加背景是指xml中添加background吗,以及decorView.getChildAt(0)是指当前页面视图吗?
        diygreen: @胡哈哈哈 因为应用了透明主题,如果手动添加背景,会发现你设置的contentView也是透明的

      本文标题:SlidingPaneLayout详解

      本文链接:https://www.haomeiwen.com/subject/fssarttx.html