Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/code-mc/loadtoast
Pretty material design toasts with feedback animations
https://github.com/code-mc/loadtoast
Last synced: 10 days ago
JSON representation
Pretty material design toasts with feedback animations
- Host: GitHub
- URL: https://github.com/code-mc/loadtoast
- Owner: code-mc
- License: apache-2.0
- Created: 2015-04-25T09:19:28.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-02-22T09:06:06.000Z (over 3 years ago)
- Last Synced: 2024-10-16T06:21:44.681Z (23 days ago)
- Language: Java
- Size: 1.3 MB
- Stars: 1,533
- Watchers: 50
- Forks: 223
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-android-ui - loadtoast - Android可自定义toast (Toast)
README
# Load Toast Library
The default toasts are ugly and don't really provide much more than a short message. This small library provides a better toast which will give the user feedback by morphing into a checkmark or cross (success and fail). The lifetime of the toast is completely controlled by you.
# Demo
# Usage
## Step 1
#### Gradle
```groovy
dependencies {
compile 'net.steamcrafted:load-toast:1.0.12'
}
```
## Step 2
The API is very simple, create a new toast by providing a context:
```java
LoadToast lt = new LoadToast(context);
```
Change the displayed text:
```java
lt.setText("Sending Reply...");
```
If you don't have a message to display, the toast will shrink to only show the circular loader.
Then proceed to show the toast:
```java
lt.show();
```
When your background thingy is done provide feedback to the user and hide the toast:
```java
// Call this if it was successful
lt.success();
// Or this method if it failed
lt.error();
// Or if no feedback is desired you can simply hide the toast
lt.hide();
```
To properly position the toast use the following method to adjust the Y offset:
```java
lt.setTranslationY(100); // y offset in pixels
```
You can also change the colors of the different toast elements:
```java
lt.setTextColor(Color.RED).setBackgroundColor(Color.GREEN).setProgressColor(Color.BLUE);
```
In some situations a border might be desired for increased visibility, by default it is transparent:
```java
// Change the border color
lt.setBorderColor(int color);
// Change the border width
lt.setBorderWidthPx(int widthPx);
lt.setBorderWidthDp(int widthDp);
lt.setBorderWidthRes(int resourceId);
```
When displaying a message in a RTL language you can force the text to marquee from left to right instead of the default right to left:
```java
// pass in false for RTL text, true for LTR text
lt.setTextDirection(boolean isLeftToRight);
```
These can be chained as you can see.
# License
Released under the [Apache 2.0 License](https://github.com/code-mc/loadtoast/blob/master/license.md)