https://github.com/rock3r/uplift

A playground for elevation on Android
https://github.com/rock3r/uplift

android demo elevation material-design ui

Last synced: 3 days ago
JSON representation

A playground for elevation on Android

• Host: GitHub
• URL: https://github.com/rock3r/uplift
• Owner: rock3r
• License: apache-2.0
• Created: 2017-10-25T08:30:24.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2020-09-01T08:08:02.000Z (about 4 years ago)
• Last Synced: 2024-10-26T20:33:32.388Z (17 days ago)
• Topics: android, demo, elevation, material-design, ui
• Language: Kotlin
• Size: 7.17 MB
• Stars: 350
• Watchers: 9
• Forks: 26
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Uplift [![GitHub release](https://img.shields.io/github/release/rock3r/uplift.svg?style=flat-square&colorB=F6836E)](https://github.com/rock3r/uplift/releases) [![GitHub license](https://img.shields.io/github/license/rock3r/uplift.svg?style=flat-square&colorB=F6836E)](https://github.com/rock3r/uplift/blob/master/LICENSE)

![Uplift](art/moving-banner-github.gif)



	     

	



Unbeknownst to most, elevation shadows are actually not completely inflexible. Besides setting the

elevation height itself, you can tweak the shadows in clever ways to obtain subtler shadows,

or simply some specific effect. This can be seen in action in the [Squanchy](http://squanchy.net)

schedule screen, which uses a custom `OutlineProvider` to cast shadows for the cards that look more

like diffuse shadows (although they're very much still the area shadow that the Material guidelines

specify, there is no custom drawing code there).

For more details, you can refer to the [accompanying blogpost](https://blog.sebastiano.dev/playing-with-elevation-in-android/),

and to the follow up posts for Android P: [part 1](https://blog.sebastiano.dev/playing-with-elevation-in-android-part-1/) and

[part 2](https://blog.sebastiano.dev/playing-with-elevation-in-android-part-2/).

### Tinting shadows (Android P+)

Starting with Android P (API 28) you can specify the colour that elevation shadows take on. You can

individually tint the area and the spot shadows — although you probably want the same colour for

both, most of the time. Remember, though, that shadow colours' alphas are premultiplied by a factor

that is defined by the `ambientShadowAlpha` and `spotShadowAlpha` theme attributes, which are set by

default to `0.039` for ambient shadows and `0.19` for spot shadows.

If you want to learn more about it, and learn how to bypass these limitations, you can refer to the

dedicated blog posts, starting with the [first part](https://blog.sebastiano.dev/playing-with-elevation-in-android-part-1/). 

## More on Uplift

You can test Uplift by downloading it from the [Play Store](https://play.google.com/store/apps/details?id=me.seebrock3r.elevationtester)

or get the apk from the [Releases tab](https://github.com/rock3r/elevation-tester/releases/latest).



## Licence

See the [`LICENSE`](LICENSE) file. tl;dr it's Apache 2.0.

The app uses Alessandro Crugnola's [`android-target-tooltip`](https://github.com/sephiroth74/android-target-tooltip) library for

the onboarding, which is licensed under the MIT license.