Material DesignコンポーネントのCollapsingToolbarLayout

CollapsingToolbarLayout は、折りたたみ可能なタイトルバーを実現するために主に使用され、一般的には AppBarLayout の子 View として使用されます。以下に CollapsingToolbarLayout の使用法をまとめます。主な内容は以下の通りです：

よく使う属性
2 つのフラグ
表示効果

よく使う属性#

// タイトルを表示するかどうか
app:titleEnabled="true"
// タイトル内容
app:title="CollapsingToolbarLayout"
// 拡張時のタイトルの位置
app:expandedTitleGravity="left|bottom"
// 折りたたみ時のタイトルの位置
app:collapsedTitleGravity="left"
// CollapsingToolbarLayout 折りたたみ時の Toolbar の背景色
app:contentScrim ="@color/colorPrimary"
// CollapsingToolbarLayout 折りたたみ時の色の変化の持続時間
app:scrimAnimationDuration="1200"
// 色が可視高さのどの位置から変化し始めるか
app:scrimVisibleHeightTrigger="150dp"
// ステータスバーの色の変化（Android 5.0）
app:statusBarScrim="@color/colorAccent"
// スクロールコンポーネントとジェスチャーとの関係を設定
app:layout_scrollFlags="scroll|exitUntilCollapsed"

タイトルは、折りたたみレイアウトが完全に表示されると大きくなり、折りたたみレイアウトが上にスライドするにつれて表示範囲が小さくなるとタイトルも小さくなります。タイトルの色を設定するには、以下のようにします：

// タイトルを設定
ctlCollapsingLayout.setTitle("CollapsingToolbarLayout");
// CollapsingToolbarLayout 拡張時の色を設定
ctlCollapsingLayout.setExpandedTitleColor(Color.parseColor("#ffffff"));
// CollapsingToolbarLayout 折りたたみ時の色を設定
ctlCollapsingLayout.setCollapsedTitleTextColor(Color.parseColor("#46eada"));

このタイトルの色の変化プロセスは CollapsingToolbarLayout によって行われ、もちろん他の属性もコード内で設定できます。

2 つのフラグ#

2 つの重要な属性についても触れておきます。フラグとして記憶できます：

layout_scrollFlags
layout_collapseMode

layout_scrollFlags：一般的に CoordinatorLayout、AppBarLayout などのコンポーネントで構成されたインターフェースでは、通常スクロールビュー（例：NestedScrollView）があり、スクロールビューにはシステムのデフォルトのビヘイビアが設定されています。具体的には以下の通りです：

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

スクロールビューに合わせて移動するコンポーネント（例：ToolBar、CollapsingToolbarLayout など）は、異なるアクションを指定するために layout_scrollFlags 属性を設定する必要があります。layout_scrollFlags の値の具体的な意味については、以前の記事を参照してください：Material Design コンポーネントの AppBarLayout。

layout_collapseMode：layout_collapseMode には選択できる 2 つの値があります。pin を設定した View はページが上にスクロールするにつれてトップに固定され、parallax を設定した View はページのスクロールに合わせてスクロールします。この時、別の属性 layout_collapseParallaxMultiplier と組み合わせて視差スクロール効果を形成できます。

CollapsingToolbarLayout の紹介はここまでです。もちろん、例がなければなりません。以下は簡単な使用例で、レイアウトは以下の通りです：

<?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"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.manu.materialdesignsamples.samples.SampleCollapsingToolbarLayoutActivity">

    <android.support.design.widget.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="200dp">
        <android.support.design.widget.CollapsingToolbarLayout
            android:id="@+id/ctlCollapsingLayout"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:titleEnabled="true"
            app:title="CollapsingToolbarLayout"
            app:expandedTitleGravity="left|bottom"
            app:collapsedTitleGravity="left"
            app:contentScrim ="@color/colorPrimary"
            app:scrimAnimationDuration="1200"
            app:scrimVisibleHeightTrigger="150dp"
            app:statusBarScrim="@color/colorAccent"
            app:layout_scrollFlags="scroll|exitUntilCollapsed">
            <ImageView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                app:layout_collapseMode="parallax"
                app:layout_collapseParallaxMultiplier="0.6"
                android:background="@drawable/ic_collapsing_title"/>
            <android.support.v7.widget.Toolbar
                android:id="@+id/toolbar"
                android:layout_width="match_parent"
                android:layout_height="70dp"
                android:minHeight="?attr/actionBarSize"
                app:layout_collapseMode="pin">
            </android.support.v7.widget.Toolbar>
        </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">
        <android.support.v7.widget.RecyclerView
            android:id="@+id/rvCollapsing"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>
    </android.support.v4.widget.NestedScrollView>
</android.support.design.widget.CoordinatorLayout>

表示効果#

以下は表示効果です。具体的には以下の通りです：

CollapsingToolbarLayout の紹介はこれで終了です。