Alerter

General

Category
Free
Tag
Design
License
MIT License
Min SDK
16 (Android 4.1 Jelly Bean)
Registered
Feb 16, 2017
Favorites
15
Link
https://github.com/Tapadoo/Alerter
See also
MaterialColdStart
Scoops
Material Palette
DroidMVP
ArcLayout

Additional

Language
Java
Version
N/A
Created
Feb 3, 2017
Updated
Mar 7, 2017
Owner
Tapadoo
Contributors
Diogo Bernardino (diogobernardino)
Ed George (ed-george)
smuriana
riclage
Iiro Krankka (roughike)
kpmmmurphy
juliosueiras
otormaigh
8
Activity
Badge
Generate
Download
Source code
APK file

Show card

Alerter

General

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

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

Gradle

dependencies {
    compile 'com.tapadoo.android:alerter:1.0.6'
}

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();

Icon

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

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();

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();

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();

Visibility Callbacks

 Alerter.create(ExampleActivity.this)
        .setTitle("Alert Title")
        .setOnShowListener(new OnShowAlertListener() {
            @Override
            public void onShow() {
                Toast.makeText(ExampleActivity.this, "Alert Shown", Toast.LENGTH_LONG).show();
            }
        })
        .setOnHideListener(new OnHideAlertListener() {
            @Override
            public void onHide() {
                Toast.makeText(ExampleActivity.this, "Alert Hidden", Toast.LENGTH_LONG).show();
            }
         })
        .show();

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.