简介
老规矩,先来看下 CollapsingToolbarLayout 文档:
从文档中可以看到,CollapsingToolbarLayout 存在于 design 包中,且继承于FrameLayout
。
CollapsingToolbarLayout 通常用来在布局中包裹一个 Toolbar,是对 Toolbar 的再次封装,以实现具有“折叠效果“的顶部栏。CollapsingToolbarLayout 是不能独立存在的,它必须只能作为 AppBarLayout 的直接子View
来使用。
CollapsingToolbarLayout 具备以下几个特点:
可折叠标题(Collapsing title)
当布局完全显示时,标题最大化;当布局逐渐移出屏幕时,标题逐渐变小。可以通过 setTitle(CharSequence) 来设置显示的标题。标题外观可以通过collapsedTextAppearance
和expandedTextAppearance
进行调整。内容纱布(Content scrim)
当滚动位置到达临界点时,内容纱布会显示或隐藏。可以通过 setContentScrim(Drawable) 来设置内容纱布。状态栏纱布(Status bar scrim)
当滚动位置到达临界点时,状态栏纱布会显示或隐藏(位于状态栏后)。可以通过 setStatusBarScrim(Drawable) 来设置状态栏纱布。状态栏纱布只能支持 Android 5.0 LOLLIPOP 及以上的设备,并且还要设置android:fitsSystemWindows="true"
。视差滚动子 View(Parallax scrolling children)
子 View 可以选择以“视差”的方式来进行滚动。(视觉效果上就是子 View 滚动的比其他 View 稍微慢些)。设置方法为:app:layout_collapseMode="parallax"
子 View 位置固定(Pinned position children)
子 View 可以选择是否在全局空间上固定位置,这对于 Toolbar 来说非常有用,因为当布局在移动时,可以将 Toolbar 固定位置而不受移动的影响。 设置方法为:app:layout_collapseMode="pin"
。
注:不要在运行时手动为 Toolbar 添加子View
。在运行期间,Toolbar 会自动添加一个“虚拟的 View” 从而让我们能为 标题 计算出可用空间,如果你手动添加子View
,这个过程会被干扰。
示例
直接看布局:
<?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.support.design.widget.AppBarLayout
android:layout_width="match_parent"
android:layout_height="wrap_content">
<android.support.design.widget.CollapsingToolbarLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:layout_scrollFlags="scroll|exitUntilCollapsed">
<ImageView
android:layout_width="match_parent"
android:layout_height="300dp"
android:scaleType="centerCrop"
android:src="@drawable/girl"
app:layout_collapseMode="parallax" />
<android.support.v7.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?android:attr/actionBarSize"
app:layout_collapseMode="pin"
app:title="I am Toolbar" />
</android.support.design.widget.CollapsingToolbarLayout>
</android.support.design.widget.AppBarLayout>
<android.support.v4.widget.NestedScrollView
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:layout_behavior="@string/appbar_scrolling_view_behavior">
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@string/large_text" />
</android.support.v4.widget.NestedScrollView>
</android.support.design.widget.CoordinatorLayout>
在布局中,用 AppBarLayout 包裹一个 CollapsingToolbarLayout, CollapsingToolbarLayout 内部有两个子控件,一个是ImageView
,其app:layout_collapseMode="parallax"
,即以视差模式滚动;另一个是
Toolbar,其app:layout_collapseMode="pin"
,即固定位置。
上面布局的效果如下图所示:
在 Android 5.0 系统之上,如果想充分利用系统状态栏空间(即进入时全屏(不显示状态栏),达到最小高度时,显示状态栏),那么可以进行如下设置:
- 为需要更好的让背景图和系统状态栏融合的子
View
以及它的父控件设置这个属性:android:fitsSystemWindows="true"
<?xml version="1.0" encoding="utf-8"?>
<android.support.design.widget.CoordinatorLayout
...
android:fitsSystemWindows="true">
<android.support.design.widget.AppBarLayout
...
android:fitsSystemWindows="true">
<android.support.design.widget.CollapsingToolbarLayout
...
android:fitsSystemWindows="true"
>
<ImageView
...
android:fitsSystemWindows="true"
/>
...
</android.support.design.widget.CoordinatorLayout>
- 新建一个资源文件夹:values-v21,并为其添加透明主题:
<resources>
<style name="CollapsingTheme" parent="AppTheme">
<item name="android:statusBarColor">@android:color/transparent</item>
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
</style>
</resources>
values 也存在对应的空实现:
<style name="CollapsingTheme" parent="AppTheme"></style>
- 最后为当前这个
Activity
设置主题:
android:theme="@style/CollapsingTheme"
效果如下图所示:
其他特效
- 为 CollapsingToolbarLayout 添加内容纱布(Content scrim):方法:在 CollapsingToolbarLayout 布局中添加:
app:contentScrim="@color/colorAccent"
,使用一个明显点的颜色,方便看到效果。
效果图如下:
- 为 CollapsingToolbarLayout 添加状态栏纱布(Status bar scrim):方法:在 CollapsingToolbarLayout 布局中添加:
app:statusBarScrim="@color/colorAccent"
,使用一个明显点的颜色,方便看到效果。
效果图如下:
- 为 CollapsingToolbarLayout 同时添加内容纱布和状态栏纱布,效果会好许多:
配置:
...
...
<android.support.design.widget.CollapsingToolbarLayout
...
app:contentScrim="@color/colorPrimary"
app:statusBarScrim="@color/colorPrimaryDark">
...
...
</android.support.design.widget.CollapsingToolbarLayout>
...
...
效果图如下: