# StyleableToast

**Repository Path**: ouyangpengdev/StyleableToast

## Basic Information

- **Project Name**: StyleableToast
- **Description**: A library that takes the standard Android toast to the next level with a variety of styling options. Style your toast either from code or styles.xml
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-03-23
- **Last Updated**: 2025-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Android StyleableToast

An Android library that takes the standard Android Toast to the next level with many styling options that gives your app and user experience an extra unique feeling! Style your Toast either by code or in styles.xml!

<a href="https://github.com/Muddz/StyleableToast/raw/master/demo.apk">Download the demo.apk</a>


## Features

- Style toasts in a styles.xml or from code.
- Set background color of the toast.
- Set the corner radius of the toast for different shapes.
- Set the transparency of your toast.
- Set a stroke color and width of your toast.
- Style the toast text with a text color or bold effect.
- Set a custom font for the toast text.
- Set a icon next to the toast text.
- Set an spinning animation effect on your icon (see below example)
- Works from Api 16+

## Update version: 1.0.9 |  03 June 2017
- **IMPORTANT** Replaced constructor initialisation with builder pattern!
- Support for RTL when icons is used.
- Added a `getStyleableToast()` method.
- Made default values so user don't have to type every value manually.
- Improved synchronization when using both Styles.xml and code together to style a toast.
- Refactoring of methods and comments and simplified codes.


## CASES:
![alt tag](https://github.com/Muddz/StyleableToast/blob/master/showcase.png)

## With spinIcon(); method:
![alt tag](https://media.giphy.com/media/hoq66naJQkECI/giphy.gif)


## Usage with a style from styles.xml:


**1) Style your toast in styles.xml. All available attributes:**
```xml
    <style name="MyToast">
    <item name="android:textColor"></item>
    <item name="android:textStyle"></item> only bold!
    <item name="android:fontFamily"></item> For custom fonts just add the path -> fonts/myfont.ttf
    <item name="android:colorBackground"></item>
    <item name="android:strokeWidth"></item>   API 21+
    <item name="android:strokeColor"></item>   API 21+
    <item name="android:radius"></item>  radius for corners of the toast shape
    <item name="android:alpha"></item>   value between 0-255 where 255 is full solid
    <item name="android:icon">/</item>  drawable id of the icon. R.drawable.xx
    </style>
```

**2) Pass your style in the static constructor and call show(); and you're done!**

```java
    StyleableToast.makeText(context, "Hello World!", Toast.LENGTH_LONG, R.style.StyledToast).show();
```

## With Builder pattern:
```java
        st = new StyleableToast
                .Builder(this)
                .text("Hello world!")
                .textColor(Color.WHITE)
                .backgroundColor(Color.BLUE)
                .build();
```

-----
    
## Installation

Add the depedency in your build.gradle. The library is distributed via jCenter

```groovy
dependencies {
    compile 'com.muddzdev:styleabletoast:1.0.9'   
}
```
 ----

## License

    Copyright 2017 Muddii Walid (Muddz)

    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.