New version released 20.5.8 on 08-09-2023
Changelogs
- Added option to set default text in input field.
Read the changes in README
Alert Dialog
AlertDialog for Android, a beautiful and material alert dialog to use in your android app.
Older verion of this library has been removed please use new version of this library.
Will you buy a coffee for me
And Don't Forget To Follow Me On Instagram / Twitter
Follow me on instagram to stay up-to-date https://instagram.com/a.masram444
Follow me on twitter to stay up-to-date https://twitter.com/a_masram444
Contributors
paulocoutinhox (Paulo Coutinho)
Latest version of this library is migrated to androidx
Features
- Materialistic alert dialog
- Auto dark mode
- Change font style
- Change text color
- Change button color and background
- Change button text color
- Show vector drawable image with tint option in dark mode
- Show Custom Image from URL in dialog (type: circleCrop, full-size)
- Change the content text-alignment as you want
- Change the title text alignment
- Progress type dialog
- Input field dialog
- More features are coming soon
ScreenShot
Setup
The simplest way to use AlertDialog is to add the library as dependency to your build.
Gradle
Add it in your root build.gradle at the end of repositories:
allprojects {
repositories {
...
mavenCentral()
maven { url 'https://jitpack.io' }
}
}
Step 2. On your root build.gradle, add mavenCentral() to the allprojects section. On your module build.gradle, add
dependencies {
implementation 'io.github.tutorialsandroid:kalertdialog:20.4.8'
implementation 'com.github.TutorialsAndroid:progressx:v6.0.19' //required for kalertdialog lib
}
Usage
Show material progress
KAlertDialog pDialog = new KAlertDialog(this, KAlertDialog.PROGRESS_TYPE);
pDialog.getProgressHelper().setBarColor(Color.parseColor("#A5DC86"));
pDialog.setTitleText("Loading");
pDialog.setCancelable(false);
pDialog.show();
You can customize progress bar dynamically with materialish-progress methods via KAlertDialog.getProgressHelper():
- resetCount()
- isSpinning()
- spin()
- stopSpinning()
- getProgress()
- setProgress(float progress)
- setInstantProgress(float progress)
- getCircleRadius()
- setCircleRadius(int circleRadius)
- getBarWidth()
- setBarWidth(int barWidth)
- getBarColor()
- setBarColor(int barColor)
- getRimWidth()
- setRimWidth(int rimWidth)
- getRimColor()
- setRimColor(int rimColor)
- getSpinSpeed()
- setSpinSpeed(float spinSpeed)
A basic message:
new KAlertDialog(this)
.setTitleText("Here's a message!")
.show();
A title with a text under:
new KAlertDialog(this)
.setTitleText("Here's a message!")
.setContentText("It's pretty, isn't it?")
.show();
A title with gravity changed:
new KAlertDialog(this, KAlertDialog.NORMAL_TYPE)
.setTitleText("Lorem Ipsum")
.setTitleTextGravity(Gravity.START) //you can specify your own gravity
.setContentText("Lorem Ipsum is simply dummy text of the printing and typesetting industry.")
.setConfirmClickListener("OK", null)
.show();
A error message:
new KAlertDialog(this, KAlertDialog.ERROR_TYPE)
.setTitleText("Oops...")
.setContentText("Something went wrong!")
.show();
A warning message:
new KAlertDialog(this, KAlertDialog.WARNING_TYPE)
.setTitleText("Are you sure?")
.setContentText("Won't be able to recover this file!")
.setConfirmClickListener("Yes,delete it!", null)
.show();
A success message:
new KAlertDialog(this, KAlertDialog.SUCCESS_TYPE)
.setTitleText("Good job!")
.setContentText("You clicked the button!")
.show();
A message with a custom icon:
new KAlertDialog(this, KAlertDialog.CUSTOM_IMAGE_TYPE)
.setTitleText("Sweet!")
.setContentText("Here's a custom image.")
.setCustomImage(R.drawable.custom_img)
.show();
A message with a custom vector drawable with tint option in dark mode:
new KAlertDialog(this, KAlertDialog.CUSTOM_IMAGE_TYPE)
.setTitleText("Sweet!")
.setContentText("Here's a custom image.")
.setCustomImage(R.drawable.vector_drawable)
.setDrawableTintOnNightMode(true, R.color.red) //it will work only if your app is running in night mode
.show();
A message with a custom image URL
displayType - KAlertDialog.IMAGE_BIG - For full size image
displayType - KAlertDialog.IMAGE_CIRCLE - For Circle Crop image
Note: This feature is still in development
new KAlertDialog(this, KAlertDialog.URL_IMAGE_TYPE)
.setTitleText("KAlertDialog")
.setContentText("Here's a custom image.")
.setURLImage("put your image url", displayType)
.setConfirmClickListener("OK", null)
.show();
A dialog with input-field
KAlertDialog dialog = new KAlertDialog(this, KAlertDialog.INPUT_TYPE);
dialog.setInputFieldHint("Write message");
dialog.setInputFieldText("Hello World!"); //If you want to set default text in input field
dialog.setTitleText("Edit Text");
dialog.setConfirmClickListener("OK", kAlertDialog -> {
kAlertDialog.dismissWithAnimation();
kAlertDialog.getInputText(); //you get the input text by calling this
Toast.makeText(this, kAlertDialog.getInputText(), Toast.LENGTH_SHORT).show();
});
dialog.show();
//below this line is necessary to show keyboard when using input-field
dialog.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
|WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM); //this will allow to show keyboard
To Hide Cancel And Confirm Button:
new KAlertDialog(this, KAlertDialog.CUSTOM_IMAGE_TYPE)
.setTitleText("Sweet!")
.setContentText("Here's a custom image.")
.setCustomImage(R.drawable.custom_img)
.showConfirmButton(false) //to hide the confirm button set it to false
.showCancelButton(false) //to hide the cancel button set it to false
.show();
To Change the font of only title:
To apply custom downloaded fonts you have place your font file in "assest/fonts" folder or under "res/font" folder. Below
is the screen-shot for reference about how to place your font file in assest folder
new KAlertDialog(this, KAlertDialog.NORMAL_TYPE)
.setTitleText("Lorem Ipsum")
.setTitleFontAssets("fonts/os.ttf")
.setContentText("Lorem Ipsum is simply dummy text of the printing and typesetting industry.")
.setConfirmClickListener("OK", null)
.show();
To Change the font of only content:
To apply custom downloaded fonts you have place your font file in "assest/fonts" folder or under "res/font" folder. Below
is the screen-shot for reference about how to place your font file in assest folder
new KAlertDialog(this, KAlertDialog.NORMAL_TYPE)
.setTitleText("Lorem Ipsum")
.setContentText("Lorem Ipsum is simply dummy text of the printing and typesetting industry.")
.setContentFont(R.font.sf)
.setConfirmClickListener("OK", null)
.show();
To Change the color of title and content
.setTitleColor(R.color.yourColorName)
.setContentColor(R.color.yourColorName)
To Change the content textAlignment
//Text alignment start
.setContentTextAlignment(View.TEXT_ALIGNMENT_VIEW_START, Gravity.START)
or
//Text alignment center
.setContentTextAlignment(View.TEXT_ALIGNMENT_CENTER, Gravity.CENTER)
Bind the listener to confirm button:
new KAlertDialog(this, KAlertDialog.WARNING_TYPE, 0)
.setTitleText("Are you sure?")
.setContentText("Won't be able to recover this file!")
.setConfirmClickListener("Yes,delete it!",new KAlertDialog.KAlertClickListener() {
@Override
public void onClick(KAlertDialog sDialog) {
sDialog.dismissWithAnimation();
}
})
.show();
Show the cancel button and bind listener to it:
new KAlertDialog(this, KAlertDialog.WARNING_TYPE, 0)
.setTitleText("Are you sure?")
.setContentText("Won't be able to recover this file!")
.setConfirmClickListener("Yes,delete it!", null)
.showCancelButton(true)
.setCancelClickListener("No,cancel plx!", new KAlertDialog.KAlertClickListener() {
@Override
public void onClick(KAlertDialog sDialog) {
sDialog.cancel();
}
})
.show();
Customizing the alert dialog
//if your app is night mode then you can tint your vector drawable to specific color you want
.setDrawableTintOnNightMode(true, R.color.white)
// you can change the color of confirm button
.confirmButtonColor(R.color.colorPrimary)
// you can change the color of cancel button
.cancelButtonColor(R.color.colorAccent)
//you can change the color of button text
.setConfirmClickListener("OK", R.color.black, clickListener)
//you can change the color of button text
.setCancelClickListener("CANCEL", R.color.black, clickListener)
// you can change the content text size
.setContentTextSize(50)
//you can use html in title text and same in content text
.setTitleText("<h2>Title</h2><br><p>Description here</p>")
And if you want to change the button corners with color create a drawable file
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<item android:state_pressed="true">
<shape android:shape="rectangle">
<solid android:color="#FF5474" />
<corners android:radius="6dp"/>
</shape>
</item>
<item>
<shape android:shape="rectangle">
<solid android:color="#FF1744" />
<corners android:radius="6dp"/>
</shape>
</item>
</selector>
And then call this method when you create drawable
.confirmButtonColor(R.drawable.button_background) // you can change border and color of button
And if you want to hide Title Text and Content Text of alert dialog
.setTitleText("Are you sure?") //just don't write this line if you want to hide title text
.setContentText("Won't be able to recover this file!") // don't write this line if you want to hide content text
And if you want to hide Title Text and Content Text on alert type change
new KAlertDialog(this, KAlertDialog.WARNING_TYPE)
.setTitleText("Are you sure?")
.setContentText("Won't be able to recover this file!")
.showCancelButton(true)
.setCancelClickListener("No,cancel plx!", sDialog ->
sDialog.setTitleText(null)
.setContentText("Your imaginary file is safe :)")
.showCancelButton(false)
.setConfirmClickListener("OK", null)
.changeAlertType(KAlertDialog.ERROR_TYPE))
.setConfirmClickListener("Yes,delete it!",sDialog ->
sDialog.setTitleText("Deleted!")
.showCancelButton(false)
.setContentText(null)
.setConfirmClickListener("OK",null)
.changeAlertType(KAlertDialog.SUCCESS_TYPE))
.show();
Change the dialog style upon confirming:
new KAlertDialog(this, KAlertDialog.WARNING_TYPE, 0)
.setTitleText("Are you sure?")
.setContentText("Won't be able to recover this file!")
.setConfirmText("Yes,delete it!")
.setConfirmClickListener(new KAlertDialog.KAlertClickListener() {
@Override
public void onClick(KAlertDialog sDialog) {
sDialog
.setTitleText("Deleted!")
.setContentText("Your imaginary file has been deleted!")
.setConfirmClickListener("OK", null)
.changeAlertType(KAlertDialog.SUCCESS_TYPE);
}
})
.show();
License
Copyright 2019 KAlertDialog
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.