Sweet Alert

A beautiful replacement for Javascript's "Alert"

So... What does it do?

Here’s a comparison of a standard error message. The first one uses the built-in alert-function, while the second is using sweetAlert.

Normal alert

Code:

alert("Oops... Something went wrong!");

Sweet Alert

Code:

sweetAlert("Oops...", "Something went wrong!", "error");

Pretty cool huh? SweetAlert automatically centers itself on the page and looks great no matter if you're using a desktop computer, mobile or tablet. It's even highly customizeable, as you can see below!

More examples

In these examples, we're using the shorthand function swal to call sweetAlert.

A basic message
```
swal("Here's a message!")
```

A title with a text under

swal("Here's a message!", "It's pretty, isn't it?")

A success message!

swal("Good job!", "You clicked the button!", "success")

A warning message, with a function attached to the "Confirm"-button

swal({
  title: "Are you sure?",
  text: "Your will not be able to recover this imaginary file!",
  type: "warning",
  showCancelButton: true,
  confirmButtonColor: "#DD6B55"
  confirmButtonText: "Yes, delete it!"
},
function(){
  alert("Deleted!");
});

A message with a custom icon

swal({
  title: "Sweet!",
  text: "Here's a custom image.",
  imageUrl: "images/thumbs-up.jpg"
});

Download & install

Method 1: Install through bower:

$ bower install sweetalert

Method 2: Download the sweetAlert CSS and JavaScript files.

Download files

Initialize the plugin by referencing the necessary files:

<script src="lib/sweet-alert.min.js"></script>
<link rel="stylesheet" type="text/css" href="lib/sweet-alert.css">

Call the sweetAlert-function after the page has loaded

swal({
  title: "Error!",
  text: "Here's my error message!",
  type: "error",
  confirmButtonText: "Cool"
});

Configuration

Here are the keys that you can use if you pass an associative array into the sweetAlert:

Argument	Default value	Description
title	null (required)	The title of the modal. It can either be put in the array under the key "title" or passed as the first parameter of the function.
text	null	A description for the modal. It can either be put in the array under the key "text" or passed as the second parameter of the function.
type	null	The type of the modal. SweetAlert comes with 4 built-in types which will show a corresponding icon animation: "warning", "error", "success" and "info". It can either be put in the array under the key "type" or passed as the third parameter of the function.
allowOutsideClick	false	If set to true, the user can dismiss the modal by clicking outside it.
showCancelButton	false	If set to true, a "Cancel"-button will be shown, which the user can click on to dismiss the modal.
confirmButtonText	"OK"	Use this to change the text on the "Confirm"-button. If showCancelButton is set as true, the confirm button will automatically show "Confirm" instead of "OK".
confirmButtonColor	"#AEDEF4"	Use this to change the background color of the "Confirm"-button (must be a HEX value).
cancelButtonText	"Cancel"	Use this to change the text on the "Cancel"-button.
imageUrl	null	Add a customized icon for the modal. Should contain a string with the path to the image.
imageSize	"80x80"	If imageUrl is set, you can specify imageSize to describes how big you want the icon to be in px. Pass in a string with two values separated by an "x". The first value is the width, the second is the height.

Contribute

SweetAlert was created by Tristan Edwards, you can follow him on Twitter or Dribbble for updates and other cool projects!

Feel free to fork sweetAlert on GitHub if you have any features that you want to add!