README

<a href="http://sweetalert.js.org"> </a> A beautiful replacement for JavaScript's "alert" <a href="https://badge.fury.io/js/sweetalert"></a> <a href="https://travis-ci.org/t4t5/sweetalert"></a> <a href="https://www.npmjs.com/package/sweetalert"> </a> <a href="https://github.com/t4t5/sweetalert/blob/master/LICENSE"> </a> <a href="#backers" alt="sponsors on Open Collective"></a> <a href="#sponsors" alt="Sponsors on Open Collective"></a>

Installation

bash

$ npm install --save sweetalert

Usage

javascript

import swal from 'sweetalert';

swal("Hello world!");

Upgrading from 1.X

Many improvements and breaking changes have been introduced in the 2.0 release. Make sure you read the upgrade guide to avoid nasty surprises!

Guides

Documentation

Examples

An error message:

javascript

swal("Oops!", "Something went wrong!", "error");

A warning message, with a function attached to the confirm message:

Using promises:

javascript

swal({
  title: "Are you sure?",
  text: "Are you sure that you want to leave this page?",
  icon: "warning",
  dangerMode: true,
})
.then(willDelete => {
  if (willDelete) {
    swal("Deleted!", "Your imaginary file has been deleted!", "success");
  }
});

Using async/await:

javascript

const willDelete = await swal({
  title: "Are you sure?",
  text: "Are you sure that you want to delete this file?",
  icon: "warning",
  dangerMode: true,
});

if (willDelete) {
  swal("Deleted!", "Your imaginary file has been deleted!", "success");
}

Using promises:

javascript

swal("Type something:", {
  content: "input",
})
.then((value) => {
  swal(`You typed: ${value}`);
});

Using async/await:

javascript

const value = await swal("Type something:", {
  content: "input",
});

swal(`You typed: ${value}`);

In combination with Fetch:

Using promises:

javascript

swal({
  text: "Wanna log some information about Bulbasaur?",
  button: {
    text: "Search!",
    closeModal: false,
  },
})
.then(willSearch => {
  if (willSearch) {
    return fetch("http://pokeapi.co/api/v2/pokemon/1");
  }
})
.then(result => result.json())
.then(json => console.log(json))
.catch(err => {
  swal("Oops!", "Seems like we couldn't fetch the info", "error");
});

Using async/await:

javascript

const willSearch = await swal({
  text: "Wanna log some information about Bulbasaur?",
  button: {
    text: "Search!",
    closeModal: false,
  },
});

if (willSearch) {
  try {
    const result = await fetch("http://pokeapi.co/api/v2/pokemon/1");
    const json = await result.json();
    console.log(json);
  } catch (err) {
    swal("Oops!", "Seems like we couldn't fetch the info", "error");
  }
}

Using with React

SweetAlert has tools for integrating with your favourite rendering library..

If you're using React, you can install SweetAlert with React in addition to the main library, and easily add React components to your alerts like this:

javascript

import React from 'react'
import swal from '@sweetalert/with-react'

swal(
  <div>
    <h1>Hello world!</h1>
    <p>
      This is now rendered with JSX!
    </p>
  </div>
)

Contributing

If you're changing the core library:

Make changes in the src folder.
Preview changes by running npm run docs
Submit pull request

If you're changing the documentation:

Make changes in the docs-src folder.
Preview changes by running npm run docs
Run npm run builddocs to compile the changes to the docs folder
Submit pull request

Contributors

This project exists thanks to all the people who contribute. [Contribute]. <a href="https://github.com/t4t5/sweetalert/graphs/contributors"></a>

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

Installation

Usage

Upgrading from 1.X

Guides

Documentation

Examples

An error message:

A warning message, with a function attached to the confirm message:

A prompt modal, where the user's input is logged:

In combination with Fetch:

Using with React

Contributing

If you're changing the core library:

If you're changing the documentation:

Contributors

Backers

Sponsors