Sesekali, Anda harus menunjukkan kotak peringatan (alert box) kepada pengguna Anda untuk memberi tahu mereka tentang kesalahan atau pemberitahuan. Masalah dengan kotak peringatan standar yang disediakan oleh browser adalah bahwa mereka tidaklah terlalu menarik. Saat Anda membuat sebuah website dengan kombinasi warna dan animasi yang bagus untuk meningkatkan pengalaman dalam penjelajahan dari pengguna Anda, kotak peringatan yang tidak tertata akan terlihat janggal.
Dalam tutorial ini, Anda akan belajar tentang pustaka bernama SweetAlert2 yang memungkinkan kita untuk membuat semua jenis pesan peringatan yang dapat disesuaikan agar sesuai dengan tampilan dan nuansa pada website kita sendiri.
Menampilkan Pesan Peringatan yang Sederhana
Sebelum Anda dapat menampilkan semua pesan peringatan dengan SweetAlert ini kepada pengguna, Anda harus menginstal pustaka dan memasukkannya ke dalam proyek Anda. Jika Anda menggunakan npm atau bower, Anda dapat menginstalnya dengan menjalankan perintah berikut:
1npm install sweetalert2 2bower install sweetalert2
Anda juga bisa mendapatkan tautan CDN untuk versi terbaru dari pustaka ini dan memasukkannya pada halaman web Anda menggunakan tag script:
1<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script>
Selain file JavaScript, Anda juga harus memuat file CSS yang digunakan untuk mengatur semua kotak peringatan yang dibuat oleh pustaka:
1<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'>
Setelah Anda menginstal pustaka ini, membuat SweetAlert sebenarnya sangatlah mudah. Yang harus Anda lakukan hanyalah memanggil fungsi npm install sweetalert2 37. Pastikan saja bahwa fungsi tersebut dipanggil setelah DOM dimuat.
Ada dua cara untuk membuat SweetAlert menggunakan fungsi npm install sweetalert2 37. Anda dapat meneruskan judul, teks pada bagian body, dan nilai ikon dalam tiga argumen berbeda atau Anda dapat menyampaikan argumen tunggal sebagai objek dengan nilai yang berbeda sebagai pasangan nilai-kuncinya. Melewati segala sesuatu dalam suatu objek yang berguna ketika Anda ingin menentukan nilai untuk beberapa argumen.
Ketika satu argumen dilewatkan dan itu adalah string, SweetAlert hanya akan menampilkan judul dan tombol OK. Pengguna akan dapat mengklik di mana saja di luar peringatan atau pada tombol OK untuk mengabaikannya.
Ketika dua argumen dilewatkan, yang pertama menjadi judul dan yang kedua menjadi teks di dalam peringatan. Anda juga dapat menampilkan ikon pada kotak peringatan dengan meneruskan argumen ketiga. Ini dapat memiliki salah satu dari lima nilai yang telah ditetapkan: npm install sweetalert2 39, npm install sweetalert2 40, npm install sweetalert2 41, npm install sweetalert2 42, dan npm install sweetalert2 43. Jika Anda tidak melewati argumen ketiga, tidak ada ikon yang akan ditampilkan di dalam pesan peringatan.
1document.querySelector(".first").addEventListener('click', function(){ 2npm install sweetalert2 1npm install sweetalert2 2npm install sweetalert2 3npm install sweetalert2 4npm install sweetalert2 5npm install sweetalert2 6npm install sweetalert2 7npm install sweetalert2 8npm install sweetalert2 9npm install sweetalert2 3212223242526npm install sweetalert2 3
Pilihan-pilihan Konfigurasi untuk Menyesuaikan Peringatan
Jika Anda hanya ingin menampilkan beberapa informasi dasar di dalam kotak peringatan, contoh sebelumnya akan baik-baik saja. Namun, pustaka SweetAlert sebenarnya dapat melakukan lebih dari sekadar menunjukkan kepada pengguna beberapa teks di dalam pesan peringatan. Anda dapat mengubah setiap aspek pesan peringatan ini sesuai dengan kebutuhan Anda sendiri.
Pustaka ini telah mencakup judul, teks, dan ikon di dalam pesan SweetAlert. Ada juga pilihan untuk mengubah tombol di dalamnya dan mengontrol perilaku mereka. Secara standar, peringatan hanya akan memiliki satu tombol konfirmasi dengan teks yang bertuliskan "OK". Anda dapat mengubah teks di dalam tombol konfirmasi dengan mengatur nilai properti dari npm install sweetalert2 44. Jika Anda juga ingin menunjukkan tombol batal dalam pesan peringatan Anda, yang harus Anda lakukan hanyalah mengatur nilai npm install sweetalert2 45 menjadi npm install sweetalert2 46. Teks di dalam tombol batal dapat diubah menggunakan properti npm install sweetalert2 47.
Masing-masing tombol ini dapat diberi latar belakang warna yang berbeda menggunakan properti npm install sweetalert2 48 dan npm install sweetalert2 49. Warna standar untuk tombol konfirmasi adalah npm install sweetalert2 50, sedangkan warna standar untuk tombol batal adalah npm install sweetalert2 51. Jika Anda ingin menerapkan penyesuaian lainnya pada tombol konfirmasi atau pembatalan, Anda cukup menggunakan properti npm install sweetalert2 52 dan npm install sweetalert2 53 untuk menambahkan kelas baru ke dalamnya. Setelah kelas ditambahkan, Anda akan dapat menggunakan CSS untuk mengubah tampilan tombol-tombol tersebut. Anda juga dapat menambahkan kelas pada bagian modal utama itu sendiri dengan menggunakan properti npm install sweetalert2 54.
Jika Anda berinteraksi dengan pesan peringatan dalam contoh yang pertama, Anda mungkin telah memperhatikan bahwa modal dapat ditutup dengan menekan tombol Enter atau Escape. Demikian pula, Anda juga dapat mengklik di mana saja di luar modal untuk mengabaikannya. Ini terjadi karena nilai npm install sweetalert2 55, npm install sweetalert2 56, dan npm install sweetalert2 57 secara standar diatur ke npm install sweetalert2 46.
Saat Anda menunjukkan dua tombol berbeda di dalam modal, tombol konfirmasi adalah yang berada di fokus secara standar. Anda dapat menghapus fokus dari tombol konfirmasi dengan menetapkan nilai npm install sweetalert2 59 menjadi npm install sweetalert2 60. Demikian pula, Anda juga dapat mengatur fokus pada tombol batal dengan mengatur nilai npm install sweetalert2 61 menjadi npm install sweetalert2 46.
Secara standar tombol konfirmasi selalu ditampilkan di sisi kiri. Anda memiliki opsi untuk membalik posisi konfirmasi dan tombol pembatalan dengan mengatur nilai dari npm install sweetalert2 63 menjadi npm install sweetalert2 46.
Selain mengubah posisi dan warna tombol di dalam pesan peringatan, Anda juga dapat mengubah latar belakang dan posisi dari pesan peringatan atau latar belakang di sekitarnya. Tidak hanya itu, meskipun pustaka SweetAlert juga memungkinkan Anda untuk menampilkan ikon atau gambar kustom Anda sendiri pada pesan peringatan. Ini dapat membantu dalam banyak situasi.
Anda dapat menyesuaikan latar belakang dari SweetAlert menggunakan properti npm install sweetalert2 65. Properti ini menerima Boolean atau string sebagai nilainya. Secara standar, latar belakang dari pesan peringatan terdiri dari sebagian besar warna abu-abu transparan. Anda dapat menyembunyikannya secara penuh dengan menetapkan nilai npm install sweetalert2 65 menjadi npm install sweetalert2 60. Demikian pula, Anda juga dapat menampilkan gambar Anda sendiri pada latar belakang dengan menetapkan nilai npm install sweetalert2 65 sebagai string. Dalam kasus semacam itu, seluruh nilai string npm install sweetalert2 65 ditetapkan ke properti CSS npm install sweetalert2 70. Latar belakang dari pesan SweetAlert dapat dikontrol menggunakan properti npm install sweetalert2 70. Secara standar semua pesan peringatan memiliki latar belakang putih sepenuhnya.
Secara standar semua pesan peringatan muncul di tengah windows. Namun, Anda dapat membuatnya muncul dari lokasi lain menggunakan properti npm install sweetalert2 72. Properti ini dapat memiliki sembilan nilai yang berbeda dengan nama yang cukup jelas: npm install sweetalert2 73, npm install sweetalert2 74, npm install sweetalert2 75, npm install sweetalert2 76, npm install sweetalert2 77, npm install sweetalert2 78, npm install sweetalert2 79, npm install sweetalert2 80, dan npm install sweetalert2 81.
Anda dapat menonaktifkan animasi ketika modal popup muncul dengan mengatur nilai properti npm install sweetalert2 82 menjadi npm install sweetalert2 60. Pustaka ini juga menyediakan properti npm install sweetalert2 84 sebagai pengaturan waktu yang dapat digunakan untuk menutup secara otomatis setelah beberapa milidetik berlalu.
Dalam contoh berikut, saya telah menggunakan kombinasi yang berbeda dari semua properti yang dibahas pada bagian ini untuk membuat empat pesan peringatan yang berbeda. Ini seharusnya dapat menunjukkan bagaimana Anda benar-benar dapat mengubah penampilan dan perilaku dari modal yang dibuat oleh pustaka SweetAlert2.
1292bower install sweetalert2 1npm install sweetalert2 2bower install sweetalert2 3npm install sweetalert2 4bower install sweetalert2 5npm install sweetalert2 5bower install sweetalert2 7npm install sweetalert2 7bower install sweetalert2 9npm install sweetalert2 911211322npm install sweetalert2 324261819bower install sweetalert2 1<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 1<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 2<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 3<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 4<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 5bower install sweetalert2 5<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 7<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 8<script src="//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.all.min.js"></script> 91011121314151617181913<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'> 1npm install sweetalert2 3<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'> 3<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'> 4<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'> 5<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'> 6bower install sweetalert2 1<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'> 8<link rel='stylesheet' href='//cdn.jsdelivr.net/npm/sweetalert2@7.12.15/dist/sweetalert2.min.css'> 910111213141516171819document.querySelector(".first").addEventListener('click', function(){ 0bower install sweetalert2 5document.querySelector(".first").addEventListener('click', function(){ 2document.querySelector(".first").addEventListener('click', function(){ 3document.querySelector(".first").addEventListener('click', function(){ 4document.querySelector(".first").addEventListener('click', function(){ 5document.querySelector(".first").addEventListener('click', function(){ 6document.querySelector(".first").addEventListener('click', function(){ 7document.querySelector(".first").addEventListener('click', function(){ 812npm install sweetalert2 0014npm install sweetalert2 0213npm install sweetalert2 04npm install sweetalert2 3npm install sweetalert2 06npm install sweetalert2 07npm install sweetalert2 08npm install sweetalert2 09bower install sweetalert2 1npm install sweetalert2 11npm install sweetalert2 12npm install sweetalert2 13npm install sweetalert2 14npm install sweetalert2 15npm install sweetalert2 16npm install sweetalert2 17npm install sweetalert2 18npm install sweetalert2 19npm install sweetalert2 20npm install sweetalert2 21npm install sweetalert2 22npm install sweetalert2 23npm install sweetalert2 24npm install sweetalert2 25npm install sweetalert2 26npm install sweetalert2 27npm install sweetalert2 28npm install sweetalert2 29npm install sweetalert2 30npm install sweetalert2 31npm install sweetalert2 32npm install sweetalert2 3313npm install sweetalert2 35npm install sweetalert2 3
Metode penting dari SweetAlert2
Menginisialisasi pesan SweetAlert yang berbeda untuk menunjukkannya kepada pengguna adalah salah satu hal, tetapi terkadang Anda juga perlu akses ke metode yang mengontrol perilaku pesan peringatan tersebut setelah inisialisasi. Untungnya, pustaka SweetAlert2 menyediakan banyak metode yang dapat digunakan untuk menampilkan atau menyembunyikan modal serta mendapatkan judul, teks, gambar, dll.
Anda dapat memeriksa apakah modal terlihat atau tersembunyi menggunakan metode npm install sweetalert2 85. Anda juga dapat secara terprogram menutup modal yang terbuka dengan menggunakan metode npm install sweetalert2 86 atau npm install sweetalert2 87. Jika Anda kebetulan menggunakan kumpulan properti yang sama untuk beberapa pesan peringatan selama inisialisasi mereka, Anda cukup memanggil metode npm install sweetalert2 88 di awal untuk mengatur nilai dari semua properti itu sekaligus. Pustaka SweetAlert juga menyediakan metode npm install sweetalert2 89 untuk mengatur ulang semua properti ke nilai standarnya (default).
Anda bisa mendapatkan judul, konten, dan gambar dari modal menggunakan metode npm install sweetalert2 90, npm install sweetalert2 91, dan npm install sweetalert2 92. Demikian pula, Anda juga bisa mendapatkan HTML yang membentuk tombol konfirmasi dan tombol pembatalan menggunakan metode npm install sweetalert2 93 dan npm install sweetalert2 94.
Ada banyak metode lain yang dapat digunakan untuk melakukan tugas lainnya seperti melakukan klik secara terprogram pada tombol konfirmasi atau tombol pembatalan.
Penutup
Pustaka SweetAlert2 membuatnya sangat mudah bagi pengembang untuk membuat pesan peringatan khusus agar dapat ditampilkan kepada pengguna mereka dengan hanya mengatur beberapa nilai dari properti. Tutorial ini bertujuan untuk mencakup dasar-dasar pustaka ini sehingga Anda dapat membuat pesan peringatan khusus sendiri dengan cepat.
Untuk mencegah tulisan ini menjadi terlalu besar, saya hanya membahas metode dan properti yang paling umum digunakan. Jika Anda ingin membaca tentang semua metode dan properti lain yang dapat digunakan untuk membuat pesan peringatan secara lanjutan, Anda harus mengunjungi dokumentasi yang mendetail dari pustaka ini.
Jangan lupa juga untuk memeriksa JavaScript lainnya yang kami miliki di Envato Market.
Jangan ragu untuk memberi tahu saya, jika ada sesuatu yang Anda ingin saya klarifikasi dalam tutorial ini.