FadingActionBar

FadingActionBar is a library which implements the cool fading action bar effect that can be seen in the new Play Music app.

This library uses the techniques outlined by Cyril Mottier in a popular blog post.

The three most commonly used action bar implementations are supported: stock (API 11+), ActionBarCompat and ActionBarSherlock.

Try out the sample application:

Or browse the source code of the sample application for a complete example of use.

Including in your project

The library is pushed to Maven Central as a AAR, so you just need to add the following dependency to your build.gradle.

dependencies {
    compile 'com.github.manuelpeinado.fadingactionbar:fadingactionbar:3.1.0'
}

If your project doesn't use the stock action bar, but one of the compatibility implementations, you would use the following:

dependencies {
    // Use the following if your project uses ActionBarCompat
    compile 'com.github.manuelpeinado.fadingactionbar:fadingactionbar-abc:3.1.0'
    // Or the following if your project uses ActionBarSherlock
    compile 'com.github.manuelpeinado.fadingactionbar:fadingactionbar-abs:3.1.0'
}

Usage

Using the library is really simple, just look at the source code of the provided samples:

You can even use the library from a fragment, which is useful when implementing a dual phone/tablet layout.

See the demos included in the sample application for a complete overview of the features supported by the library.

Known Issues

There is an important issue with the library and ListViews. More specifically, things don't work quite right when the activity is re-created due to a configuration change. So, unless you handle configuration changes yourself (or your activity is portrait/landscape only), I strongly suggest you stick to having your content in a ScrollView until a solution to this issue is found.

Acknowledgements

Thanks to Cyril Mottier for sharing the techniques that make this library possible.
Thanks to Antonio Leiva for writing the Navigation Drawer sample.
Thanks to Michał Motyczko for coming up with a fix for an important bug.

Who's using it

#ДАНСwithme. This app attempts to organise information from various social network streams into a single source.
Pearl Jam Lyrics. Unofficial app for Pearl Jam fans that want to have all the lyrics of their favorite band in the palm of their hands.
Weatherize. A weather app that is designed to look great and tell you the weather like a human does, not a machine.

Does your app use FadingActionBar? If you want to be featured on this list drop me a line.

Developed By

Manuel Peinado Gallego - manuel.peinado@gmail.com

License

Copyright 2013,2014 Manuel Peinado

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

hdodenhof/FadingActionBar