GDSCToast

Custom Toast Library by Google Developer Student Club University of Brawijaya

Prerequisites

• For old version of gradle (before arctic fox update)

  Add this in your root build.gradle file (project scope)

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

• For gradle version 7 or latest

  Add this in your root setting.gradle file :

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Dependency

Add this to your module's build.gradle file :

dependencies {
	...
	implementation 'com.github.KylixEza:GDSCToast:version'
}

you can check the version on jitpack badge above or on release tag

Usage

Each function start with 'build...' like buildNormalToast always returns a Toast object, so you can customize your own Toast. But if you just want to show the toast without any customization, you can use function that start with 'show...' like showNormalToast

• To display a normal Toast:

GDSCToast.buildNormalToast(this@MainActivity, "This is a normal toast", Toast.LENGTH_LONG, true).show()
GDSCToast.showNormalToast(this@MainActivity, "This is a normal toast", Toast.LENGTH_LONG, true)

• To display a success Toast:

GDSCToast.buildSuccessToast(this@MainActivity, "This is a success toast", Toast.LENGTH_LONG, true).show()
GDSCToast.showSuccessToast(this@MainActivity, "This is a success toast", Toast.LENGTH_LONG, true)

• To display an error Toast:

GDSCToast.buildErrorToast(this@MainActivity, "This is an error toast", Toast.LENGTH_LONG, true).show()
GDSCToast.showErrorToast(this@MainActivity, "This is an error toast", Toast.LENGTH_LONG, true)

• To display an warning Toast:

GDSCToast.buildWarningToast(this@MainActivity, "This is a warning toast", Toast.LENGTH_LONG, true).show()
GDSCToast.showWarningToast(this@MainActivity, "This is a warning toast", Toast.LENGTH_LONG, true)

• To display an info Toast:

GDSCToast.buildInfoToast(this@MainActivity, "This is an info toast", Toast.LENGTH_LONG, true).show()
GDSCToast.showInfoToast(this@MainActivity, "This is an info toast", Toast.LENGTH_LONG, true)

• To configure any toast (1.2.0)

GDSCToast.configOn(this@MainActivity)
    .setText("Write your message here")
    .setDuration(Toast.LENGTH_LONG)
    .setShowLogo(false)
    .setToastShape(ToastShape.RECTANGLE)
    .setToastType(ToastType.WARNING)
    .showToast()

• To configure any toast using lambda expression (1.2.1)

GDSCToast.showAnyToast(this@MainActivity) {
    it.apply {
	text = "Write your message here"
	duration = Toast.LENGTH_LONG
	showLogo = false
	toastType = ToastType.WARNING
	toastShape = ToastShape.RECTANGLE
    }
}

• To use context extension into all of functions that available in GDSCToast (1.2.2)

The First Way -> simple but need to import the function that you called (automatically imported)

this@MainActivity.apply { buildNormalToast("This is normal toast", Toast.LENGTH_SHORT, true).show() }
this@MainActivity.apply { showSuccessToast("This is success toast", Toast.LENGTH_SHORT, true) }

this@MainActivity.apply { configOn().setText(...).setDuration(...).setShowLogo(...).setToastShape(...).setToastType(...).showToast() } 
this@MainActivity.apply { showAnyToast { it.apply { text, duration, etc. } } 

The Second Way -> little bit complicated but no need any import

GDSCToast.apply { this@MainActivity.buildNormalToast("This is normal toast", Toast.LENGTH_SHORT, true).show() }
GDSCToast.apply { this@MainActivity.showSuccessToast("This is success toast", Toast.LENGTH_SHORT, true) }

GDSCToast.apply { this@MainActivity.configOn().setText(...).setDuration(...).setShowLogo(...).setToastShape(...).setToastType(...).showToast() }
GDSCToast.apply { this@MainActivity.showAnyToast { it.apply { text, duration, etc. } }

Method	Parameter	Usage	Attribute Default Value
configOn	Context	Allow you to access configuration of GDSCToast	No default value because it's mandatory
setText	String	To set message that will shown from toast	""
setToastType	ToastType	To set type of toast	ToastType.NORMAL
setShowLogo	Boolean	To set visibility of GDSC logo	true
setDuration	Int	To set duration of toast	Toast.LENGTH_SHORT
setToastShape	ToastShape	To set shape of toast	ToastShape.ROUNDED
buildToast	-	To create the toast => returns toast object	-
showToast	-	To show the toast	-

Preview

Shape	Preview
ToastShape.ROUNDED
ToastShape.RECTANGLE

Contributing

Please fork this repository and contribute back using.

Any contributions, large or small, major features, bug fixes, are welcomed and appreciated but will be thoroughly reviewed .

Contact

Don't forget to ⭐this repository to motivates me to share more open source library