https://github.com/code-mc/loadtoast

Pretty material design toasts with feedback animations
https://github.com/code-mc/loadtoast

Last synced: 5 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 (almost 4 years ago)
• Last Synced: 2024-11-21T18:44:27.651Z (22 days ago)
• Language: Java
• Size: 1.3 MB
• Stars: 1,533
• Watchers: 50
• Forks: 224
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-github-android-ui - loadtoast - Android可自定义toast (Toast)
• awesome-android-ui - https://github.com/code-mc/loadtoast

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

![](http://i.imgur.com/WwoxLMu.gif)

# 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)