Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vlonjat-gashi/progress-activity
Easily add loading, empty and error states in your app.
https://github.com/vlonjat-gashi/progress-activity
android error-handling error-page loading-screen progress-bar
Last synced: 3 days ago
JSON representation
Easily add loading, empty and error states in your app.
- Host: GitHub
- URL: https://github.com/vlonjat-gashi/progress-activity
- Owner: vlonjat-gashi
- Created: 2015-08-21T11:07:18.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-06-09T12:21:54.000Z (over 4 years ago)
- Last Synced: 2024-10-30T04:49:34.448Z (about 1 month ago)
- Topics: android, error-handling, error-page, loading-screen, progress-bar
- Language: Java
- Homepage:
- Size: 150 KB
- Stars: 1,015
- Watchers: 20
- Forks: 171
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-github-android-ui - progress-activity - 进度条空视图及错误视图库 (空白页)
README
[](https://android-arsenal.com/details/1/2386)
# progress-activity
If you are tired of constantly having to set up progress bars, empty views and error views, than this library is for you.
### About
Using progress-activity you can easily add states like:
- progress bar while the content is loading,
- empty view to indicate when there are no data to display,
- error view to indicate when something goes wrong with a button to try again.
### Screenshots
### Features
- show/hide progress bar,
- show/hide empty view,
- show/hide error view,
- show content when the data is ready to be displayed,
### Usage
Add ```com.vlonjatg.progressactivity.ProgressFrameLayout``` or ```com.vlonjatg.progressactivity.ProgressLinearLayout``` or ```com.vlonjatg.progressactivity.ProgressRelativeLayout``` to your layout depending on your usecase:
```xml
```
Then in your code:
To display the loading view:
```java
progressActivity.showLoading();
```
To display the empty view:
```java
progressActivity.showEmpty(emptyDrawable, "Empty Shopping Cart",
"Please add things in the cart to continue.");
```
To display the error view:
```java
progressActivity.showError(errorDrawable, "No Connection",
"We could not establish a connection with our servers. Try again when you are connected to the interne.",
"Try Again", errorClickListener);
```
To show the content, use:
```java
progressActivity.showContent()
```
### Get It
```
repositories {
maven { url "https://jitpack.io" }
}
dependencies {
compile 'com.github.vlonjatg:progress-activity:2.0.5'
}
```
### Customization
There are a bunch of attributes to customize the views.
```xml
```
### Example
An [example](https://github.com/vlonjatg/progress-activity/tree/master/sample) is available.
### Developed By
Vlonjat Gashi - [Twitter](https://twitter.com/vlonjatg)
### Attributes
This library is inspired by [AndroidProgressLayout](https://github.com/antonkrasov/AndroidProgressLayout) library from Anton Krasov.
### License
progress-activity is available under the [MIT](http://opensource.org/licenses/MIT) licence.
```
The MIT License (MIT)
Copyright (c) 2015 Vlonjat Gashi
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
```