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][1].
The three most commonly used action bar implementations are supported: stock (API 11+), ActionBarCompat and ActionBarSherlock.
![Example Image][2]
Try out the sample application:
<a href="https://play.google.com/store/apps/details?id=com.manuelpeinado.fadingactionbar.demo">
<img alt="Android app on Google Play"
src="https://developer.android.com/images/brand/en_app_rgb_wo_45.png" />
</a>
Or browse the [source code of the sample application][3] 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:
* [If your content should be in a `ScrollView`][4].
* [If your content should be in a `ListView`][5].
* [If your content is a `WebView`][6].
You can even use the library [from a fragment][7], 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][8] for sharing the techniques that make this library possible.
* Thanks to [Antonio Leiva][9] for writing the Navigation Drawer sample.
* Thanks to [Michał Motyczko][10] for coming up with a fix for an important bug.
Who's using it
--------------
* [#ДАНСwithme][11]. This app attempts to organise information from various social network streams into a single source.
* [Pearl Jam Lyrics][12]. Unofficial app for Pearl Jam fans that want to have all the lyrics of their favorite band in the palm of their hands.
* [Weatherize][13]. 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][14]. 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][15]. Watch full-length South Park episodes directly from your phone! Browse through your favorite season or search for your favorite episode!
* [Gas Monitor][16]. 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][17]. Get all your news in a simple and fluid application.
* [Night of the museums][18]. 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][19]. 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.
*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>
<a href="https://twitter.com/mpg2">
<img alt="Follow me on Twitter"
src="https://raw.github.com/ManuelPeinado/NumericPageIndicator/master/art/twitter.png" />
</a>
<a href="https://plus.google.com/106514622630861903655">
<img alt="Follow me on Google+"
src="https://raw.github.com/ManuelPeinado/NumericPageIndicator/master/art/google-plus.png" />
</a>
<a href="http://www.linkedin.com/pub/manuel-peinado-gallego/1b/435/685">
<img alt="Follow me on LinkedIn"
src="https://raw.github.com/ManuelPeinado/NumericPageIndicator/master/art/linkedin.png" />
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.
[1]: http://cyrilmottier.com/2013/05/24/pushing-the-actionbar-to-the-next-level/
[2]: https://raw.github.com/ManuelPeinado/FadingActionBar/master/art/readme_pic.png
[3]: https://github.com/ManuelPeinado/FadingActionBar/tree/master/samples-stock
[4]: https://github.com/ManuelPeinado/FadingActionBar/blob/master/samples-stock/src/com/manuelpeinado/fadingactionbar/demo/ScrollViewActivity.java
[5]: https://github.com/ManuelPeinado/FadingActionBar/blob/master/samples-stock/src/com/manuelpeinado/fadingactionbar/demo/ListViewActivity.java
[6]: https://github.com/ManuelPeinado/FadingActionBar/blob/master/samples-stock/src/com/manuelpeinado/fadingactionbar/demo/WebViewActivity.java
[7]: https://github.com/ManuelPeinado/FadingActionBar/blob/master/samples-stock/src/com/manuelpeinado/fadingactionbar/demo/SampleFragment.java
[8]: http://cyrilmottier.com
[9]: https://github.com/antoniolg
[10]: https://github.com/mozarcik/
[11]: https://play.google.com/store/apps/details?id=com.yavorivanov.android.danswithme
[12]: https://play.google.com/store/apps/details?id=com.juannale.pearljamlyricsapp
[13]: https://play.google.com/store/apps/details?id=com.etheralstudios.weatherize
[14]: https://play.google.com/store/apps/details?id=com.garli.lastfm
[15]: https://play.google.com/store/apps/details?id=com.praxis.splol
[16]: https://play.google.com/store/apps/details?id=com.designloaf.gasmonitor
[17]: https://play.google.com/store/apps/details?id=com.simukoni.mobile.rss
[18]: https://play.google.com/store/apps/details?id=ru.xlebstudio.nightmuseum
[19]: https://play.google.com/store/apps/details?id=com.ivanenr.lfflfeedreader