簡介

在各種不同的應用中，大家可能會經常見到這樣一個效果：Toolbar是透明的，有著一個背景圖片以及大標題，隨著頁面向上滑動，其標題逐漸縮放到Toolbar上，而背景圖片則在滑動到一定程度後變成了Toolbar的顏色，這種效果也即是折疊式效果。其實這種效果在GitHub上面已經有很多開源庫實現了，但是Google在其推出的Design Library庫中也給出了一個這種控件，讓我們很方便地實現了這種效果。這個控件是CollapsingToolbarLayout，它是一個增強型的FrameLayout。那麼，本篇文章就給大家詳細地介紹該控件的使用方法以及注意事項。

效果

本文結合一個Demo來進行演示，下面是最終的顯示效果，也即折疊式Toolbar的效果：

引入

使用該控件，需要引入Android Design Library這個庫，同時地，我們需要把app的主題也要做相應的修改以便適應這個控件，所以我們也需要appcompat這個庫，那麼我們在build.gradle文件中引入如下：

dependencies {
    compile 'com.android.support:cardview-v7:24.1.0'  //cardview
    compile 'com.android.support:design:24.1.0'
    compile 'com.android.support:appcompat-v7:24.1.0'
}

本文內容均基於官方文檔，有興趣的讀者可以前往官方文檔進一步查看（自備梯子）。

知識儲備

接下來，筆者一步步地介紹該控件的用法。首先，我們先來了解這個控件的常用xml屬性。

一、常用xml屬性介紹

1)contentScrim：當Toolbar收縮到一定程度時的所展現的主體顏色。即Toolbar的顏色。
2)title:當titleEnable設置為true的時候，在toolbar展開的時候，顯示大標題，toolbar收縮時，顯示為toolbar上面的小標題。
3)scrimAnimationDuration：該屬性控制toolbar收縮時，顏色變化的動畫持續時間。即顏色變為contentScrim所指定的顏色進行的動畫所需要的時間。
4)expandedTitleGravity：指定toolbar展開時，title所在的位置。類似的還有expandedTitleMargin、collapsedTitleGravity這些屬性。
5)collapsedTitleTextAppearance：指定toolbar收縮時，標題字體的樣式，類似的還有expandedTitleTextAppearance。

二、常見的標志位

一般開發中，CollapsingToolbarLayout不會單獨出現在布局文件中，而是作為另一個控件CoordinatorLayout的子元素出現，那麼CoordinatorLayout又是什麼呢？其實CoordinatorLayout這個控件很強大，能對其子元素實現多種不同的功能，一個常見的用法就是：給它的一個子元素A設置一個layout_scrollFlags的屬性，然後給另外一個子元素B設置一個layout_behavior=”@string/appbar_scrolling_view_behavior”的屬性，這個子元素B一般是一個可以滑動的控件，比如RecyclerView、NestedScrollView等，那麼當子元素B滑動的時候，子元素A就會根據其layout_scrollFlags的屬性值而做出不同的改變，所以我們要為CollapsingToolbarLayout設置layout_scrollFlags屬性。

layout_scrollFlags

我們來看看layout_scrollFlags有哪幾個屬性可以選擇：
* scroll:所有想要滑動的控件都要設置這個標志位。如果不設置這個標志位，那麼View會固定不動。
* enterAlways:設置了該標志位後，若View已經滑出屏幕，此時手指向下滑，View會立刻出現，這是另一種使用場景。
* enterAlwaysCollapsed:設置了minHeight，同時設置了該標志位的話，view會以最小高度進度屏幕，當滑動控件滑動到頂部的時候才會拓展為完整的高度。
* exitUntilCollapsed:向上滑動時收縮當前View。但view可以被固定在頂部。
可能直接用語言來描述還是有點太抽象，下面會以實際的效果給大家展示這幾個標志位的具體作用。

layout_collapseMode

上面提到CollapsingToolbarLayout是一個FrameLayout，它內部能有多個子元素，而子元素也會有不同的表現。比如說，在上面的GIF圖中，toolbar在縮放後是固定在頂部的，而imageview則是隨著布局的滾動而滾動，也即存在一個相對滾動的過程。所以這些子元素可以添加layout_collapseMode標志位進而產生不同的行為。其實這裡也只有兩種標志位，分別是：
* pin：有該標志位的View在頁面滾動的過程中會一直停留在頂部，比如Toolbar可以被固定在頂部
* parallax：有該標志位的View表示能和頁面同時滾動。與該標志位相關聯的一個屬性是：layout_collapseParallaxMultiplier，該屬性是視差因子，表示該View與頁面的滾動速度存在差值，造成一種相對滾動的效果。

三、常用的層級關系

上面說到CollapsingToolbarLayout一般作為CoordinatorLayout的子元素出現，其實如果要實現上面的效果，還需要另外一個控件：AppBarLayout。該控件也是Design庫的控件，作用是把其所有子元素當做一個AppBar來使用。一般來說，實現折疊式Toolbar可以使用以下的層級關系：

從上面的層級關系來看，最外面的一層是CoordinatorLayout，它有兩個子元素，分別是AppBarLayout和RecyclerView(可滑動控件)，而AppBarLayout則包裹著CollapsingToolbarLayout，CollapsingToolbarLayout的子元素分別是被折疊的View(可以是一張圖片，也可以是一個布局)以及我們的Toolbar。

例子①

有了以上的知識儲備，我們就可以開始動手寫代碼了，我們的目標是實現上面的gif圖的效果。
1、在activity_main.xml文件中(注：以下注釋只是為了方便說明)：

    android:layout_width="match_parent"
    android:layout_height="match_parent">

    

        
            app:expandedTitleMarginEnd="10dp"           
            app:expandedTitleMarginStart="10dp"
            app:collapsedTitleTextAppearance="@style/TextAppearance.AppCompat.Title"    
            app:layout_scrollFlags="scroll|exitUntilCollapsed">             


            
                app:layout_collapseParallaxMultiplier="0.5"/>    

                    
        

    

       

        

            
            
            
            
            
            
            
            

        
    

與其相關聯的item_card.xml布局文件：

2、在MainActivity.java文件中再做出一些處理：

    private ImageView iv;
    private CollapsingToolbarLayout collapsingToolbarLayout;
    private Toolbar toolbar;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        collapsingToolbarLayout = (CollapsingToolbarLayout) findViewById(R.id.collapsing_toolbar_layout);
        iv = (ImageView) findViewById(R.id.iv);
        toolbar = (Toolbar) findViewById(R.id.toolbar);

        setSupportActionBar(toolbar);
        toolbar.setNavigationIcon(R.mipmap.ic_drawer_home);
        collapsingToolbarLayout.setTitle("DesignLibrarySample");
        collapsingToolbarLayout.setCollapsedTitleTextColor(Color.WHITE);
        collapsingToolbarLayout.setExpandedTitleColor(Color.WHITE);
        iv.setImageResource(R.mipmap.ic_bg);
    }

上面，我們為collapsingToolbarLayout設置了標題，以及收縮時標題的顏色和展開時標題的顏色等。經過上面的一個簡單例子，就能實現上面gif圖所顯示的折疊式Toolbar的效果了。

這裡先小結一下：在CoordinatorLayout作為父布局的情況下，給滑動控件設置一個layout_behavior=”@string/appbar_scrolling_view_behavior”標志位(該Behavior系統以及幫我們實現)，那麼當帶有這個標志位的控件滑動的時候會觸發帶有scroll_flags標志位的另一個控件進行滑動，此時imageview的layout_collapseMode是parallax，所以它會以有視差的方式來相對滑動，而toolbar設置了pin的標記位，所以在收縮後會固定在屏幕頂部。

例子②

在例子①內，我們為CollapsingToolbarLayout設置的scroll_flags是”scroll | exitUntilCollapsed”，那麼我們把標志位換成別的會有什麼不同的效果呢？
在activity_main.xml內，作如下修改：

然後別的不作改動，效果如下：

顯然，所造成的效果發生了變化，這裡toolbar並不一致固定在頂部了，而是隨著滑動而滑出了屏幕之外，同時如果手指向下滑動，toolbar會逐漸出現並保持著最小的高度，等到回到了最頂部後，toolbar會展開成原來的樣子。
那麼，基於以上的例子，如果上面少了一個“enterAlwaysCollapsed”這個標志位又會怎樣呢？該標志位的作用上面也已經解釋過了，是控制toolbar以最小的高度進入屏幕，並且在滑動控件滑動到最頂端的時候再展開成完整的高度。如果少了這個標志位，在我們手指向下滑的時候，toolbar也會逐漸出現，但是與上面gif圖不同的是，toolbar會繼續展開變成原來的樣子，即出現imageview。圖這裡就不放出來了，讀者可以自行驗證~

通過以上的兩個小例子，我們對CollapsingToolbarLayout有了一定的認識，也學會了它的使用方法了，使用它能讓我們的應用變得更加美觀。那麼最後，我們再來談談注意事項，也即筆者開發過程中遇到的坑。

注意事項

1、Android Design Support Library的使用需要配合特定的主題，一般用AppCompat下的主題即可，也可以自定義主題，繼承自AppCompat的主題，否則會報錯。另外如果使用Android Studio的話，主題的相關代碼需要在styles.xml(v21)文件內做出相應的修改，否則使用Android 5.0以上的機子做測試的話也會報錯。
2、由於使用了AppCompat的主題，那麼我們的Activity應該繼承自AppCompatActivity。
3、筆者之前使用design support library的版本號是23.1.0，在此版本上，CollapsingToolbarLayout沒有設置collapsedTitleTextAppearance屬性，標題可以正常顯示，然而到了24.1.0版本，即上面所用的版本，如果沒有設置collapsedTitleTextAppearance屬性，則當toolbar收縮後，其標題文字變得非常小。所以我們要設置collapsedTitleTextAppearance=”@style/TextAppearance.AppCompat.Title”這個屬性，才能變得正常。
4、如果沒有為CollapsingToolbarLayout設置一個title，那麼會使用ActionBar自帶的標題來顯示應用的名稱，這是因為調用了setSupportActionBar(toolbar)函數。

最後附上代碼的地址：DesignSupportLibrarySample