README.md

PrettyDialog

PrettyDialog is an Android Dialog library which is the customizable equivalent of SCLAlertView in iOS.

Example is available in app module.

Download

Gradle:

Add the following to your project level build.gradle:

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

Add this to your app build.gradle:

dependencies {
   compile 'com.github.mjn1369:prettydialog:1.0.4'
}

Usage

PrettyDialog extends Dialog class, so feel free to use its inherited functions.

Note: Default dialog has no title, message or any buttons. Just a close icon on top which you can dismiss the dialog by clicking on it.

Simple Dialog, No Customization:

new PrettyDialog(this)
	.setTitle("PrettyDialog Title")
	.setMessage("PrettyDialog Message")
	.show();

Output:

Change Icon:

• You can set the dialog icon resource:

.setIcon(R.drawable.pdlg_icon_info)

• And set a color tint for it:

.setIconTint(R.color.pdlg_color_green)

• Ultimately, define an OnClick callback:

.setIconCallback(new PrettyDialogCallback() {
	    @Override
	    public void onClick() {
		// Do what you gotta do
	    }
	})

• Put them all together:

.setIcon(
	R.drawable.pdlg_icon_info,     // icon resource
	R.color.pdlg_color_green,      // icon tint
	new PrettyDialogCallback() {   // icon OnClick listener
	    @Override
	    public void onClick() {
		// Do what you gotta do
	    }
	})

Output:

Add Buttons:

• You can add unlimited customized buttons to dialog:

// OK button
.addButton(
		"OK",					// button text
		R.color.pdlg_color_white,		// button text color
		R.color.pdlg_color_green,		// button background color
		new PrettyDialogCallback() {		// button OnClick listener
		    @Override
		    public void onClick() {
			// Do what you gotta do
		    }
		}
	)
	
// Cancel button
.addButton(
		"Cancel",
		R.color.pdlg_color_white,
		R.color.pdlg_color_red,
		new PrettyDialogCallback() {
		    @Override
		    public void onClick() {
			// Dismiss
		    }
		}
	)
	
// 3rd button
.addButton(
		"Option 3",
		R.color.pdlg_color_black,
		R.color.pdlg_color_gray,
		null
	);

Output:

Note: To Dismiss PrettyDialog on a button click, you have to instantiate PrettyDialog and keep the variable, then call dismiss() on the variable inside button's onClickListener method:

PrettyDialog pDialog = new PrettyDialog(this);
	pDialog
	.setTitle("PrettyDialog Title")
	.setMessage("PrettyDialog Message")
	.addButton(
		"Cancel",
		R.color.pdlg_color_white,
		R.color.pdlg_color_red,
		new PrettyDialogCallback() {
		    @Override
		    public void onClick() {
			pDialog.dismiss();
		    }
		}
	)
	.show();

Custom Title, Message and Typeface:

Note: Typeface applies to all texts inside the dialog.

.setTitle("Do you agree?")
.setTitleColor(R.color.pdlg_color_blue)
.setMessage("By agreeing to our terms and conditions, you agree to our terms and conditions.")
.setMessageColor(R.color.pdlg_color_gray)
.setTypeface(Typeface.createFromAsset(getResources().getAssets(),"myfont.otf"))

Output:

• Enable/Disable dialog animation:

.setAnimationEnabled(true)

• Set dialog gravity:

.setGravity(Gravity.BOTTOM)

Functions

Functions	Description	Default
setTitle(String)	sets a title for dialog	""
setTitleColor(int)	sets title's color	#212121 (kinda black)
setMessage(String)	sets a message for dialog	""
setMessageColor(int)	sets message's color	#212121 (kinda black)
setIcon(int)	sets the dialog's icon	"close (X)" icon
setIconTint(int)	sets tint for dialog's icon	null
setIconCallback(PrettyDialogCallback)	sets dialog's icon callback	dismiss dialog
setIcon(int,int,PrettyDialogCallback)	sets icon,icon tint,icon callback
addButton(String,int,int,PrettyDialogCallback)	adds button with text,text color,background color and callback
setTypeface(Typeface)	sets typeface for all texts
setAnimationEnabled(boolean)	enables or disables dialog animation	Enabled
setGravity(int)	sets the dialog's gravity (TOP, BOTTOM, CENTER,...)	Gravity.CENTER

Changelog

v1.0.4:

• Removed default icon tint color

v1.0.3:

• Added higher level scrollable content to include long messages

v1.0.2:

• More Compatible setTint() method

v1.0.1:

• Added "setGravity(int gravity)" method

cheers 🍻

License

Copyright 2017 mjn1369

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.