AirySnackbar

General

Category
Free
Tag
Snackbars
License
N/A
Min SDK
21 (Android 5.0–5.0.2 Lollipop)
Registered
Jan 22, 2024
Favorites
0
Link
https://github.com/akndmr/AirySnackbar
See also
InfoBar Compose
Snacky
ChocoBar
ProteinBar
BindingSnackbar

Additional

Language
Kotlin
Version
1.0.1 (Dec 3, 2022)
Created
Jul 1, 2022
Updated
Apr 25, 2023
Owner
Akın (akndmr)
Contributor
Akın (akndmr)
1
Activity
Badge
Generate
Download
Source code

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.