CollapsingToolbarLayout は、折りたたみ可能なタイトルバーを実現するために主に使用されます。通常、AppBarLayout の子ビューとして使用されます。以下に、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 など）があります。スクロールビューは通常、システムのデフォルトの Behavior が設定されています。具体的には次のようになります。
//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の紹介は以上です。