Skip to content
A custom view that displays an image, a title, and a subtitle. Use it for errors, empty states, or just messages with images!
Kotlin
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper Update gradle version Aug 9, 2018
graphics Update README for v3.0.0 Jul 13, 2017
library Improve Kotlin code after auto-convert Aug 12, 2018
sample Use project version name and code in sample app Aug 11, 2018
.gitignore Initial commit Dec 31, 2014
LICENSE Add LICENSE Jul 13, 2017
README.md Update README Aug 11, 2018
bintray.gradle Change publish config to use bintray Jul 13, 2017
build.gradle Fix sample app Aug 9, 2018
gradle.properties Bump version to 4.0.0 (6) Aug 11, 2018
gradlew Initial commit Dec 31, 2014
gradlew.bat Initial commit Dec 31, 2014
install.gradle Change publish config to use bintray Jul 13, 2017
settings.gradle

README.md

ErrorView

A custom view that displays an image, a title, and a subtitle. It can be used for various purposes like displaying errors, empty states, or just messages with images.

Get apk

Download

implementation 'tr.xip.errorview:library:4.0.0'

Note: You might have to add jcenter() to your repositories.

Pre-3.0 versions were com.github.xiprox.errorview:library:x.y.z.

If you're migrating from v2, you may find the changelog in the releases page helpful.

Usage

Image

setImage(int res)
setImage(Drawable)
setImage(Bitmap)

setImageTint(int color)

setImageVisible(boolean)

setImageSize(int width) // The ImageView adjusts its height to preserve aspect ratio.

.isImageVisible
app:ev_image="@drawable/,,,"
app:ev_imageTint="@color/..."
app:ev_imageVisible="boolean"
app:ev_imageSize="123dp"

Title

setTitle(String)
setTitle(int res)
setTitleColor(int color)
setTitleVisible(boolean)
.title
.isTitleVisible
app:ev_title="@string/..."
app:ev_titleColor="@color/..."
app:ev_titleVisible="boolean"

Subtitle

setSubtitle(String)
setSubtitle(int res)
setSubtitleColor(int color)
setSubtitleVisible(boolean visible)
.subtitle
.isSubtitleVisible
app:ev_subtitle="@string/..."
app:ev_subtitleColor="@color/..."
app:ev_subtitleVisible="boolean"

Retry button

setRetryText(String)
setRetryText(int res)
setRetryColor(int color)
setRetryVisible(boolean)
.retryText
.isRetryVisible
app:ev_retryText="@string/..."
app:ev_retryBackground="@drawable/..."
app:ev_retryColor="@color/..."
app:ev_retryVisible="boolean"

Retry listener

setRetryListener(RetryListener)

Builder pattern

All set methods return ErrorView, so you can chain them like such:

errorView.setImage(image).setTitle(e.title).setSubtitle(e.message).setRetryVisible(false)

Theming

You can theme ErrorView app-wide:

<style name="AppTheme" parent="Theme.AppCompat.DayNight.DarkActionBar">
    ...
    <item name="ev_style">@style/MyErrorView</item>
</style>
 
<style name="MyErrorView">
    <item name="ev_retryText">@string/error_retry</item>
    <item name="ev_image">@drawable/sadface</item>
</style>

You can also apply themes to specific ErrorViews:

<tr.xip.errorview.ErrorView
    android:id="@+id/specialErrorView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:theme="@style/MySpecialErrorView"/>
<style name="MySpecialErrorView">
    <item name="ev_imageSize">120dp</item>
    <item name="ev_retryColor">@color/apptheme_accent>>
</style>

And yes, ErrorView supports AppCompat.DayNight out-of-the-box. In fact the above style snippet is from the sample app.

Further customization

If you are looking for further customization, you can always do something like the following, albeit a bit hacky:

val image = errorView.findViewById(R.id.ev_image)
val title = errorView.findViewById(R.id.ev_title)
val subtitle = errorView.findViewById(R.id.ev_subtitle)
val retryButton = errorView.findViewById(R.id.ev_retry)

These view ids will not be changed unless there is a major version increment (e.g. 4.0.0 -> 5.0.0).

License

Copyright (C) 2014 İhsan Işık

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.

Apache License Version 2.0 (LICENSE)

You can’t perform that action at this time.