Skip to content

Latest commit

 

History

History
99 lines (80 loc) · 4.1 KB

README.md

File metadata and controls

99 lines (80 loc) · 4.1 KB
Raw

ForegroundViews

Views that support a foreground. Inspired by Chris Banes' gist and this post as well as this.

Sample Gif

Build Status

Gradle Dependency

Add this in your root build.gradle file (not your module build.gradle file):

allprojects {
	repositories {
		...
		maven { url "https://jitpack.io" }
	}
}

Then, add the library to your project build.gradle

dependencies {
    implementation 'com.github.Commit451.ForegroundViews:foregroundviews:latest.version.here'
    // for ConstraintLayout support
    implementation 'com.github.Commit451.Foregroundviews:foregroundviews-constraintlayout:latest.version.here'
}

Usage

Usage is very similar for each of the foreground views. Within XML:

<com.commit451.foregroundviews.ForegroundLinearLayout
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:clickable="true"
  android:foreground="?attr/selectableItemBackgroundBorderless"
  android:orientation="vertical"
  android:padding="16dp">

  <!-- Other views go here -->

</com.commit451.foregroundviews.ForegroundLinearLayout>

for ViewGroups and:

<com.commit451.foregroundviews.ForegroundImageView
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:background="@color/colorPrimary"
  android:clickable="true"
  android:foreground="?attr/selectableItemBackgroundBorderless"
  android:src="@drawable/header_image_1"
  android:tint="@color/colorAccent" />

for an ImageView. The key is the foreground XML attribute, which can also be set in code:

Drawable drawable = ContextCompat.getDrawable(this, R.drawable.foreground);
ForegroundImageView foregroundImageView = (ForegroundImageView) findViewById(R.id.image);
foregroundImageView.setForeground(drawable);

Supported Views

  • ForegroundImageView
  • ForegroundLinearLayout
  • ForegroundRelativeLayout
  • ForegroundButton
  • ForegroundTextView
  • ForegroundConstraintLayout

There may be others that people want, so pull requests are encouraged! Please note that FrameLayout and CardView already support a foreground for all API levels.

Create Your Own Views

If you take a look at the source, you will see that the supported views all are very similar in construction. Operations are overridden in the views and then passed along to the ForegroundDelegate so that the foreground logic is easily shared and reusable on new views. Most of the time, copying the source of ForegroundLinearLayout and then modifying the name and the extended view is all you need to do.

Note

Foregrounds were added to View as of Android 6.0 (API 23). This library calls through to the 6.0+ methods whenever it is possible. If you have the ability to target 6.0+ (lol yeah right) then you have no need for a library like this. We look forward to the day when targeting 6.0+ is the standard and this library can be deprecated.

License

Copyright 2016 Gabriele Mariotti
Copyright 2016 Eric Cochran
Copyright 2016 Chris Banes
Copyright 2016 Commit 451

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.