Android library implementing a fading effect for the action bar, similar to the one found in the Play Music app
Java Groovy
Latest commit 1c148b9 Aug 29, 2014 @ManuelPeinado Update README.md

README.md

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.

Example Image

Try out the sample application:

Android app on Google Play

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.2'
}

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.2'
    // Or the following if your project uses ActionBarSherlock
    compile 'com.github.manuelpeinado.fadingactionbar:fadingactionbar-abs:3.1.2'
}

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.
  • Last.fm for Android. Do you think the official Last.fm app feels a little bit outdated? Check out this one! It has a scrobbler, and a non-ugly holo interface.
  • Watch South Park Episodes. Watch full-length South Park episodes directly from your phone! Browse through your favorite season or search for your favorite episode!
  • Gas Monitor. An application designed around individuals who keep track of their fill history on their vehicles: from price, gallons, date purchased, and miles traveled.
  • RSS Reader. Get all your news in a simple and fluid application.
  • Night of the museums. A unique and easy way to be closer to the art and history of the region of Yekaterinburg, Nevyansk, Irbit and Nizhny Tagil (Russia).
  • Lffl Feed Reader. Lffl feed reader is a free app that allows you to stay up to date on the latest news of your favorite linux blogs using a modern and minimal interface.
  • Club Douala Ravensburg. This app gives you access to the program of the Club Douala Ravensburg (Germany).

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

Follow me on Twitter Follow me on Google+ Follow me on LinkedIn

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.