Loader View for Android
What It Is
Provide both TextView and ImageView the ability to show shimmer (animation loader) before any text or image is shown. Useful when waiting for data to be loaded from the network. Example below
Features / Usage
-
Loader View for TextView defined in layout XML
<com.elyeproj.loaderviewlibrary.LoaderTextView android:layout_width="match_parent" android:layout_height="wrap_content" />
-
Loader View for ImageView defined in layout XML
<com.elyeproj.loaderviewlibrary.LoaderImageView android:layout_width="100dp" android:layout_height="100dp" />
-
Define the % width of the TextView that shows the loading animation with
width_weight
<com.elyeproj.loaderviewlibrary.LoaderTextView android:layout_width="match_parent" android:layout_height="wrap_content" app:width_weight="0.4" />
-
Define the % height of the TextView that shows the loading animation with
height_weight
<com.elyeproj.loaderviewlibrary.LoaderTextView android:layout_width="match_parent" android:layout_height="wrap_content" app:height_weight="0.8" />
-
Define use gradient of the TextView or ImageView that shows the gradient with
use_gradient
<com.elyeproj.loaderviewlibrary.LoaderTextView android:layout_width="match_parent" android:layout_height="wrap_content" app:use_gradient="true" />
-
Setting the Text Style as BOLD would darken the loading shimmer
-
Other feature of TextView and ImageView is still applicable.
-
Reset and show shimmer (animation loader) again by calling the below API
myLoaderTextView.resetLoader(); myLoaderImageView.resetLoader();
Requirement
Android SDK API Version 15 and above.
Importing the Library
On your module build.gradle
, add
dependencies {
compile 'com.elyeproj.libraries:loaderviewlibrary:1.3.0'
}
What's new in 1.3.0
- Support AppCompat
- Support TextView drawable
What's new in 1.2.2
- Support down to minSdkVersion 15
What's new in 1.2.1
- Add ability to reset loaderShimmer as per point 8 in Feature section
- Fix bugs related to orientation changes (gradient width not resized and shimmer non-stop animating)
Licence
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or 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.