YoungPeanut

love this world

YoungPeanut

android-[译]掌握CoordinatorLayout

Google I/O 15上,谷歌发布了一个新的 support library,里面包含了一些遵循Material Design’s spec的UI组件,比如,AppbarLayout, CollapsingToolbarLayoutCoordinatorLayout。 这些组件配合起来使用可以产生强大的效果,那么让我们通过这篇文章来学习如何使用这些组件。

###CoordinatorLayout

从名字可以看出,这个ViewGroup是用来协调它的子View的。看下图: CoordinatorLayout

这个例子中的各个View相互影响,却被和谐的组织在了一起。这就是使用`CoordinatorLayout`最简单的实例:

<?xml version="1.0" encoding="utf-8"?>

<android.support.design.widget.CoordinatorLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/background_light"
    android:fitsSystemWindows="true"
    >

    <android.support.design.widget.AppBarLayout
        android:id="@+id/main.appbar"
        android:layout_width="match_parent"
        android:layout_height="300dp"
        android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar"
        android:fitsSystemWindows="true"
        >

        <android.support.design.widget.CollapsingToolbarLayout
            android:id="@+id/main.collapsing"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:layout_scrollFlags="scroll|exitUntilCollapsed"
            android:fitsSystemWindows="true"
            app:contentScrim="?attr/colorPrimary"
            app:expandedTitleMarginStart="48dp"
            app:expandedTitleMarginEnd="64dp"
            >

            <ImageView
                android:id="@+id/main.backdrop"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:scaleType="centerCrop"
                android:fitsSystemWindows="true"
                android:src="@drawable/material_flat"
                app:layout_collapseMode="parallax"
                />

            <android.support.v7.widget.Toolbar
                android:id="@+id/main.toolbar"
                android:layout_width="match_parent"
                android:layout_height="?attr/actionBarSize"
                app:popupTheme="@style/ThemeOverlay.AppCompat.Light"
                app:layout_collapseMode="pin"
                />
        </android.support.design.widget.CollapsingToolbarLayout>
    </android.support.design.widget.AppBarLayout>

    <android.support.v4.widget.NestedScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_behavior="@string/appbar_scrolling_view_behavior"
        >

        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:textSize="20sp"
            android:lineSpacingExtra="8dp"
            android:text="@string/lorem"
            android:padding="@dimen/activity_horizontal_margin"
            />
    </android.support.v4.widget.NestedScrollView>

    <android.support.design.widget.FloatingActionButton
        android:layout_height="wrap_content"
        android:layout_width="wrap_content"
        android:layout_margin="@dimen/activity_horizontal_margin"
        android:src="@drawable/ic_comment_24dp"
        app:layout_anchor="@id/main.appbar"
        app:layout_anchorGravity="bottom|right|end"
        />
</android.support.design.widget.CoordinatorLayout>

看一下上面Layout的结构,CoordinatorLayout包含三个子View: 一个AppbarLayout,一个scrolleable View,一个指定了⚓️锚点的FloatingActionBar

<CoordinatorLayout>
    <AppbarLayout/>
    <scrollableView/>
    <FloatingActionButton/>
</CoordinatorLayout>

###AppBarLayout

首先,AppBarLayout是一个LinearLayout,它的子View默认纵向排列, 可以通过一些参数控制子View的滑动行为。这么说你还是很难理解,所以无图无真相,上GIF:

AppBarLayout

这张图最上面是一个可折叠图片(collapsing image),图片下面的蓝色View就是AppBarLayout,它包含了一个Toolbar,一个有标题和子标题的LinearLayout,一个带有Tab的TabLayout

<AppBarLayout>
    <CollapsingToolbarLayout
        app:layout_scrollFlags="scroll|snap"
        />

    <Toolbar
        app:layout_scrollFlags="scroll|snap"
        />

    <LinearLayout
        android:id="+id/title_container"
        app:layout_scrollFlags="scroll|enterAlways"
        />

    <TabLayout /> <!-- no flags -->
</AppBarLayout>

AppbarLayout的直接子View的操控行为,可以通过给子View添加layout_scrollFlags属性来控制。关于这个属性的值:scroll,在这个例子中用到了这个值。如果一个子View没有赋值scroll,那么滑动的时候,它就会一直静态显示,而其他scroll的View就会被划到它的后面隐藏。

另一个值snap的作用是避免一个View停留在动画的中间状态,也就是说滑动结束的时候一个View要么全部显示,要么全部隐藏,不会展示View的部分。

上面的LinearLayout指定了enterAlways,所以下拉的时候,它就会一直出现。TabLayout 没有指定,所以它一直静态显示。

由此,给子View使用不同的layout_scrollFlags就会生成不同的AppBarLayout。全部属性值参照官方文档,文章最后我也会提供几个放在Github上的实例。

###AppbarLayout flags

*SCROLL_FLAG_ENTER_ALWAYS:((entering) / (scrolling on screen))下拉的时候,这个View也会跟着滑出。

*SCROLL_FLAG_ENTER_ALWAYS_COLLAPSED:另一种enterAlways,但是只显示折叠后的高度。

*SCROLL_FLAG_EXIT_UNTIL_COLLAPSED:((exiting) / (scrolling off screen))上拉的时候,这个View会跟着滑动直到折叠。

*SCROLL_FLAG_SCROLL:跟着滑动方向滑动。

*SCROLL_FLAG_SNAP:滑动结束的时候,如果这个View部分显示,它就会滑动到离它最近的上边缘或下边缘。

###CoordinatorLayout Behaviors

打开Android Studio (>= 1.4),用模版Scrolling Activity新建一个项目,然后直接编译运行。看到:

Scrolling Activity

查看生成的代码,没发现滑动时候Fab大小变化动画的相关代码,Why? 答案在FloatingActionButton的源代码中,感谢Android Studio v1.2自带了反编译源代码的功能,ctrl/cmd + click我们来FloatingActionButton的源码中究竟干了什么。

/*
 * Copyright (C) 2015 The Android Open Source Project
 *
 *  Floating action buttons are used for a
 *  special type of promoted action. 
 *  They are distinguished by a circled icon 
 *  floating above the UI and have special motion behaviors 
 *  related to morphing, launching, and the transferring anchor point.
 * 
 *  blah.. blah.. 
 */
@CoordinatorLayout.DefaultBehavior(
    FloatingActionButton.Behavior.class)
public class FloatingActionButton extends ImageButton {
    ...

    public static class Behavior 
        extends CoordinatorLayout.Behavior<FloatingActionButton> {

        private boolean updateFabVisibility(
           CoordinatorLayout parent, AppBarLayout appBarLayout, 
           FloatingActionButton child {

           if (a long condition) {
                // If the anchor's bottom is below the seam, 
                // we'll animate our FAB out
                child.hide();
            } else {
                // Else, we'll animate our FAB back in
                child.show();
            }
        }
    }

    ...
}

其实那个大小变化动画是design包中的Behavior控制的,上面的CoordinatorLayout.Behavior<FloatingAcctionButton>控制显示或隐藏FAB,interesting?

###SwipeDismissBehavior

在 design support library 中,我们发现了SwipeDismissBehavior,有了它,我们可以在CoordinatorLayout中轻松实现滑动删除功能。

swipe

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_swipe_behavior);
    mCardView = (CardView) findViewById(R.id.swype_card);

    final SwipeDismissBehavior<CardView> swipe 
        = new SwipeDismissBehavior();

        swipe.setSwipeDirection(
            SwipeDismissBehavior.SWIPE_DIRECTION_ANY);

        swipe.setListener(
            new SwipeDismissBehavior.OnDismissListener() {
            @Override public void onDismiss(View view) {
                Toast.makeText(SwipeBehaviorExampleActivity.this,
                    "Card swiped !!", Toast.LENGTH_SHORT).show();
            }

            @Override 
            public void onDragStateChanged(int state) {}
        });

        LayoutParams coordinatorParams = 
            (LayoutParams) mCardView.getLayoutParams();

        coordinatorParams.setBehavior(swipe);
    }

###Custom Behaviors

自定义Behavior并不难,首先介绍两个元素:child 和 dependency。

child

####Childs and dependencies 要改变行为的那个View就是child,dependency是作为触发器影响child的那个View。这个例子中child是ImageView,dependency是Toolbar,然后,Toolbar滑动的时候,ImageView跟着滑动。

gif

下面开始创建自定义Behavior,首先,继承CoordinatorLayout.Behavior<T>T就是child的类型,上面例子是那个ImageView,然后我们重写方法 *layoutDependsOn *onDependentViewChanged 每当UI变化的时候就会调用layoutDependsOn,鉴定完dependency后一定要返回true。上面例子中用户一滑动就会自动调用layoutDependsOn,然后开始控制child 的行为。

 @Override
   public boolean layoutDependsOn(
      
      CoordinatorLayout parent, 
      CircleImageView, child, 
      View dependency) {

      return dependency instanceof Toolbar; 
  } 

layoutDependsOn返回true后就开始调用onDependentViewChanged,在这个方法中我们利用dependency来实现动画,转换,动作。

public boolean onDependentViewChanged(

      CoordinatorLayout parent, 
      CircleImageView avatar, 
      View dependency) {


      modifyAvatarDependingDependencyState(avatar, dependency);
   }

   private void modifyAvatarDependingDependencyState(
    CircleImageView avatar, View dependency) {
        //  avatar.setY(dependency.getY());
        //  avatar.setBlahBlat(dependency.blah / blah);
    } 

放在一起就是:

public static class AvatarImageBehavior 
   extends 
CoordinatorLayout.Behavior<CircleImageView> {

   @Override
   public boolean layoutDependsOn(

    CoordinatorLayout parent, 
    CircleImageView, child, 
    View dependency) {

       return dependency instanceof Toolbar; 
  } 

   

  public boolean onDependentViewChanged(
      
    CoordinatorLayout parent, 
    CircleImageView avatar, 
    View dependency) {

      modifyAvatarDependingDependencyState(avatar, dependency);
   }

  private void modifyAvatarDependingDependencyState(
    CircleImageView avatar, View dependency) {
        //  avatar.setY(dependency.getY());
        //  avatar.setBlahBlah(dependency.blah / blah);
    }    
}

YoungPeanut.github.io

博客

原文

###Resources

Coordinator Behavior Example- Github

Coordinator Examples- Github

Introduction to coordinator layout on Android- Grzesiek Gajewski