AirySnackbar ????

A custom and customizable Android snackbar library.

Installation

Step 1. Add the JitPack repository to your build file

  allprojects {
  repositories {
   ...
   maven { url 'https://jitpack.io' }
  }
 }

Step 2. Add the dependency

  dependencies {
     implementation 'com.github.akndmr:AirySnackbar:LatestVersion'
 }

Demo

airysnackbar_sample.mov

Usage

Show a AirySnackbar

   AirySnackbar.make(
                    source = AirySnackbarSource.ActivitySource(activity = this),
                    type = Type.Custom,
                    attributes =
                    listOf(
                        TextAttribute.Text(text = "Custom color bg AirySnackbar"),
                        TextAttribute.TextColor(textColor = R.color.black),
                        IconAttribute.Icon(iconRes = R.drawable.ic_custom),
                        IconAttribute.IconColor(iconTint = R.color.teal_200),
                        SizeAttribute.Margin(left = 24, right = 24, unit = SizeUnit.DP),
                        SizeAttribute.Padding(top = 12, bottom = 12, unit = SizeUnit.DP),
                        RadiusAttribute.Radius(radius = 8f),
                        GravityAttribute.Top,
                        AnimationAttribute.FadeInOut
                    )
                ).show()

We have 3 parameters for a snackbar, as listed below.

Parameter	Type	Description
`source`	`AirySnackbarSource`	ActivitySource, DialogSource, ViewSource
`type`	`AirySnackbarType`	Success, Error, Info, Warning, Default, Custom
`attributes`	`List<AirySnackbarAttribute>`	IconAttribute, TextAttribute, SizeAttribute, RadiusAttribute, GravityAttribute, AnimationAttribute

AirySnackbarSource

Provides parent ViewGroup and context for snackbar.

Source	Description
`ActivitySource`	Provides window?.decorView as source.
`DialogSource`	Provides dialog's window?.decorView as source and dies if dialog is destroyed before snackbar itself.
`ViewSource`	Provides view's parent (android.R.id.content) as source and dies if view is destroyed before snackbar itself.

Note:

Choose right source wisely. Watch the video below to see possible side effects of sources.

airysnackbarsource_activity_vs_dialog.mov

AirySnackbarType

There are predefined types like Success and Error. Only difference between types is background color for now. You can prefer Custom type to set your own background color. Custom(@ColorRes val bgColor: Int)

AirySnackbarAttribute

Type	Attributes
`TextAttribute`	Text, TextColor, TextSize
`IconAttribute`	Icon, IconColor, NoIcon
`SizeAttribute`	Margin, Padding
`RadiusAttribute`	Radius
`GravityAttribute`*	Top, Bottom
`AnimationAttribute`**	FadeInOut, SlideInOut

*Recommended gravity is the default top gravity. Using bottom may cause some issues.
**Recommended animation is the default FadeInOut animation. Using SlideInOut animation with top(default) gravity will cause issues.

Roadmap

Fix animation issues or remove slide animation.
Add custom duration.
Fix bottom gravity issues or remove bottom option.

AirySnackbar

General

Additional

Promotion