What is layout_collapseParallaxMultiplier used in CollapsingToolbarLayout?

Priyank Patel picture Priyank Patel · Sep 26, 2015 · Viewed 16.8k times · Source

What is layout_collapseParallaxMultiplier used in CollapsingToolbarLayout ?

I have seen the android developer doc, but I didn't understand.

please explain this parameter & it's effect when it used with layout_collapseMode with example.

Below is a simple example of xml.

<android.support.design.widget.CollapsingToolbarLayout ... >
<ImageView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:fitsSystemWindows="true"
        android:src="@drawable/random_pattern"
        android:scaleType="fitXY"
        app:layout_collapseMode="parallax"
        app:layout_collapseParallaxMultiplier="0.75"/>
 </android.support.design.widget.CollapsingToolbarLayout>

Answer

DmitryArc picture DmitryArc · Oct 19, 2015

In very simple words:

When scrolling we see the following - appbar image starts hiding under the content and beyond the top edge of the screen. Parameter layout_collapseParallaxMultiplier determines what part of the image (in percent) will be hidden under the bottom content.

So, for example, setting this parameter to value 1.0 means that top boundary of appbar's image is bound to the top edge of the screen and doesn't move when scrolling. And main content is moving up the top of the image.

When the parameter is not set this corresponds to the value 0.5 and image will be overlapped above and below synchronously.