Skip to content

k0shk0sh/Alerter

 
 

Repository files navigation

Alerter

General

This library aims to overcome the limitations of Toasts and Snackbars, while reducing the complexity of your layouts.

Default Alert

A customisable Alert view is dynamically added to the Decor View of the Window, overlaying all content.

Usage

With simplicity in mind, the Alerter employs the builder pattern to facilitate easy integration into any app.

From an Activity -

Alerter.create(this)
       .setTitle("Alert Title")
       .setText("Alert text...")
       .show();

Or from a Fragment -

Alerter.create(getActivity())
       .setTitle("Alert Title")
       .setText("Alert text...")
       .show();

Customisation

Background Colour

Alerter.create(this)
       .setTitle("Alert Title")
       .setText("Alert text...")
       .setBackgroundColor(R.color.colorAccent)
       .show();

Coloured Alert

Icon

Alerter.create(this)
       .setText("Alert text...")
       .setIcon(R.drawable.ic_face)
       .show();

Custom Icon Alert

On screen duration, in milliseconds

Alerter.create(this)
       .setTitle("Alert Title")
       .setText("Alert text...")
       .setDuration(10000)
       .show();

Without title

Alerter.create(this)
       .setText("Alert text...")
       .show();

Text Only Alert

Adding an On Click Listener

 Alerter.create(ExampleActivity.this)
        .setTitle("Alert Title")
        .setText("Alert text...")
        .setDuration(10000)
        .setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Toast.makeText(ExampleActivity.this, "OnClick Called", Toast.LENGTH_LONG).show();
            }
        })
        .show();

On Click Alert

Verbose text

 Alerter.create(ExampleActivity.this)
        .setTitle("Alert Title")
        .setText("The alert scales to accommodate larger bodies of text. " +
                 "The alert scales to accommodate larger bodies of text. " +
                 "The alert scales to accommodate larger bodies of text.")
        .show();

Verbose Alert

Gradle

dependecies {
    compile 'com.tapadoo.android:alerter:1.0.1'
}

Sample

Clone this repo and check out the app module.

Licence

See the LICENSE file for license rights and limitations (MIT).

Copyright 2016 Tapadoo, Dublin.

Alt Text

About

An Android Alterting Library

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%