ShimmerRecyclerViewX

A custom recycler view with shimmer views to indicate that views are loading for AndroidX. This will only work if you are using AndroidX RecyclerView as a dependency.

Getting Started

Make sure to have Android Studio

Gradle

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

implementation 'com.github.mike14u:shimmer-recyclerview-x:1.0.3'

Usage

• showShimmerAdapter() - set up a demo adapter a predefined number of child demo views.
• hideShimmerAdapter() - restores your adapter to show the actual child elements.

Demo Screen

There are two kinds of shimmer animation which you can see here:

1. This type of shimmer effect uses the whole ViewHolder item to animate on.

List Demo	Grid Demo

2. Here the shimmer effect only applied on for those views which background color is nontransparent.

List Demo	Grid Demo

Shimmer effect types

1. As you can see the first demo examples show that the whole ViewHolder item is animated. To achieve the desired effect, the children of the ShimmerLayout should have a nontransparent background.

2. You can achieve the second kind of shimmer effect by adding only one ViewGroup child to the ShimmerLayout with a transparent background. This ViewGroup will have the other views with nontransparent backgrounds on which the effect will be seen.

   You may wonder how can you add background to the root view of the ViewHolder, if you do not have direct access to the ShimmerLayout and the only child has a nontransparent background. The solution for this is to use the shimmer_demo_view_holder_item_background attribute.

Attributes and Methods

Following are the attributes and methods to initialise the demo views.

XML

<com.mikelau.views.shimmer.ShimmerRecyclerViewX
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:id="@+id/shimmer_recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:shimmer_demo_child_count="10"
        app:shimmer_demo_grid_child_count="2"
        app:shimmer_demo_layout="@layout/layout_demo_grid"
        app:shimmer_demo_layout_manager_type="grid"
        app:shimmer_demo_angle="20"
        />

where @layout/layout_demo_grid refers to your sample layout that should be shown during loading spinner. Now on your activity onCreate, initialize the shimmer as below:

ShimmerRecyclerViewX shimmerRecyclerX = findViewById(R.id.shimmer_recycler_view_x);
shimmerRecyclerX.showShimmerAdapter();

Credits

• https://github.com/mike14u - ShimmerRecyclerView support for AndroidX
• https://github.com/sharish - ShimmerRecyclerView for Android
• https://github.com/veghtomi - Shimmer Layout / Original Reference
• http://supercharge.io/ - Shimmer Layout / Original Reference

References

• https://github.com/sharish/ShimmerRecyclerView
• https://github.com/team-supercharge/ShimmerLayout/

License

Copyright 2018 Mike Lau

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.