Validasi Formulir AngularJS saat Pengiriman: $dirty, $valid & $invalid
⚡ Ringkasan Cerdas
Validasi formulir di AngularJS memeriksa apakah data yang dimasukkan ke dalam formulir sudah benar dan lengkap sebelum sampai ke server. Empat pendekatan dibahas di sini, mulai dari atribut HTML5 biasa, properti scope, hingga modul validasi otomatis.

Validasi Formulir di AngularJS
Validasi Formulir Dalam AngularJS, validasi adalah proses untuk memastikan apakah data yang dimasukkan dalam formulir sudah benar dan lengkap. Saat pengguna mengirimkan formulir, validasi terjadi terlebih dahulu, sebelum detail dikirim ke server. Proses validasi memastikan, sebisa mungkin, bahwa kolom input telah diisi dengan benar.
Sebagai contoh di dunia nyata, anggaplah sebuah situs yang mengharuskan pengisian formulir pendaftaran sebelum memberikan akses penuh. Halaman pendaftaran akan memiliki kolom input untuk nama pengguna, kata sandi, alamat email, dan sebagainya.
Sebagai contoh, alamat email harus selalu dalam format berikut: nama pengguna@situs.domainJika seseorang hanya memasukkan nama pengguna, validasi akan gagal. Validasi melakukan pemeriksaan dasar ini sebelum detail dikirim ke server untuk diproses lebih lanjut.
⚠️ Catatan versi: AngularJS (cabang 1.x) telah mencapai akhir masa pakainya pada 31 Desember 2021 dan tidak menerima patch keamanan lebih lanjut. Teknik-teknik di bawah ini tetap berlaku untuk aplikasi lama; Angular modern menangani pekerjaan yang sama dengan formulir berbasis template atau reaktif.
Validasi formulir menggunakan HTML5
Validasi formulir adalah proses pra-validasi informasi yang dimasukkan pada formulir web sebelum dikirim ke server. Validasi di sisi klien lebih disukai, karena menambah beban kerja yang jauh lebih sedikit daripada menampilkan formulir lagi setelah perjalanan bolak-balik.
Contoh di bawah ini menunjukkan formulir pendaftaran sederhana di mana pengguna memasukkan nama pengguna, kata sandi, alamat email, dan usia. Formulir ini memiliki kontrol validasi yang memastikan informasi dimasukkan dengan benar.
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Event Registration</title> <link rel="stylesheet" href="lib/bootstrap.css"> <script src="https://code.angularjs.org/1.8.3/angular.min.js"></script> </head> <body ng-app="sampleApp"> <h1>Guru99 Global Event</h1> <form> Enter your user name: <input type="text" name="name" required><br><br> Enter your password: <input type="password" name="password"><br><br> Enter your email: <input type="email" name="email"><br><br> Enter your age: <input type="number" name="age"><br><br> <input type="submit" value="Submit"> </form> </body> </html>
⚠️ Koreksi diterapkan pada setiap daftar di halaman ini. Aslinya dinyatakan chrset="UTF 8", yang bukan merupakan atribut yang valid maupun pengkodean yang valid, dan memuat AngularJS tiga kali — angular-route.js pertama, yang menimbulkan kesalahan karena modul rute mendaftar pada kerangka kerja yang belum dimuat, kemudian angular.min.js ke angular.js, perpustakaan yang sama dua kali. Mereka juga mengambil bootstrap.css melalui <script> tag, sehingga tidak ada gaya yang diterapkan. Setiap daftar sekarang memuat satu pustaka, versi 1.8.3, dan menautkan stylesheet dengan benar. Padding tata letak dibangun dari pengulangan Entitas telah dihapus.
Code Penjelasan
- Untuk tipe input teks,
requiredAtribut ini berarti kotak teks tidak boleh kosong saat formulir dikirimkan. - Tipe input berikutnya adalah kata sandi. Karena tipe ini ditandai sebagai kata sandi, teks yang dimasukkan di kolom tersebut akan disembunyikan.
- Karena tipe input ditentukan sebagai email, teks di dalam kotak harus sesuai dengan pola tersebut. nama@situs.domain.
- Ketika tipe input ditandai sebagai angka, karakter yang diketik dari keyboard tidak akan diterima oleh kolom tersebut.
Keluaran
Untuk melihat validasi secara langsung, klik Kirim tanpa memasukkan apa pun.
Sebuah jendela pop-up muncul yang memberitahukan bahwa kolom tersebut perlu diisi, sehingga kontrol yang ditandai sebagai wajib diisi akan memblokir pengiriman data jika dibiarkan kosong.
Memasukkan nilai pada kontrol kata sandi akan menampilkan simbol '*' yang menutupi karakter.
Memasukkan alamat email yang salah format dan mengklik Kirim akan memunculkan jendela pop-up yang meminta simbol @. Terakhir, karakter yang diketikkan ke dalam kolom kontrol usia tidak pernah muncul, karena kolom tersebut hanya menerima angka.
Popup browser mudah diatur, tetapi teks dan gayanya tidak dapat diubah. Di sinilah properti validasi AngularJS berperan.
Validasi formulir menggunakan $dirty, $valid, $invalid, $pristine
AngularJS menyediakan propertinya sendiri untuk validasi. Properti berikut diekspos pada setiap kontrol bernama:
- $kotor – Pengguna telah berinteraksi dengan kontrol
- $sah – Isi kolom valid
- $tidak valid – Isi kolom tidak valid
- $murni – Pengguna belum berinteraksi dengan kontrol
Berikut adalah langkah-langkah untuk melakukan validasi AngularJS.
Langkah 1) Gunakan novalidate properti saat mendeklarasikan formulir. Ini memberi tahu browser bahwa validasi akan ditangani oleh AngularJS.
Langkah 2) Pastikan formulir tersebut memiliki nama yang telah ditentukan, karena nama tersebut digunakan untuk mencapai tahap validasi.
Langkah 3) Pastikan setiap kontrol juga memiliki name atribut, karena alasan yang sama. Kontrol tanpa nama tidak akan pernah terdaftar pada formulir.
Langkah 4) Gunakan ng-pertunjukan arahan untuk memeriksa properti $dirty, $invalid, dan $valid.
Contoh di bawah ini memiliki satu kolom teks tempat pengguna memasukkan nama Topik. Jika dibiarkan kosong, kesalahan validasi akan muncul dan pesan akan ditampilkan.
<form ng-app="DemoApp" ng-controller="DemoController" name="myForm" novalidate> <p>Topic Name:<br> <input type="text" name="user" ng-model="user" required> <span style="color:red" ng-show="myForm.user.$dirty && myForm.user.$invalid"> <span ng-show="myForm.user.$error.required">Username is required</span> </span> </p> <p> <input type="submit" ng-disabled="myForm.$invalid"> </p> </form> <script> var app = angular.module("DemoApp", []); app.controller("DemoController", function($scope) { // Seed the textbox so the form starts in a valid state $scope.user = "AngularJS"; }); </script>
⚠️ Dua kesalahan logika telah diperbaiki. Versi aslinya menonaktifkan tombol tersebut dengan ng-disabled="myForm.user.$dirty && myForm.user.$invalid". Karena $dirty bernilai salah sampai pengguna menyentuh kolom tersebut, tombol tetap aktif. diaktifkan pada formulir kosong yang belum tersentuh, persis seperti kasus yang seharusnya diblokir; myForm.$invalid mencakup keduanya. Versi aslinya juga membungkus nilai default di dalamnya. $scope.Display = function () { $scope.user = 'Angular'; }, sebuah fungsi yang tidak pernah dipanggil, sehingga kotak teks terbuka kosong meskipun teks tersebut menyatakan menampilkan "AngularJS". Penugasan sekarang dilakukan secara langsung, dengan nilai berupa tanda kutip teks di sekitarnya.
Code Penjelasan
- Formulir tersebut diberi nama “myForm”. Ini diperlukan agar dapat mengakses kontrol validasinya.
- The
novalidateProperti tersebut menghentikan validasi browser, sehingga AngularJS dapat melakukannya sebagai gantinya. - Direktif ng-show memeriksa properti "$dirty" dan "$invalid". Jika kotak teks telah dimodifikasi, $dirty bernilai true; jika nilainya kosong, $invalid bernilai true. Ketika keduanya bernilai true, span dengan teks merah akan ditampilkan.
- Pemeriksaan bersarang membaca properti "$error.required", yang bernilai benar setiap kali kontrol yang diperlukan tidak memiliki nilai, dan menampilkan "Nama pengguna wajib diisi".
- Tombol kirim dinonaktifkan melalui
ng-disabledsetiap kali formulir secara keseluruhan tidak valid. - Pengontrol mengatur nilai awal kotak teks menjadi "AngularJS", sehingga formulir terbuka dalam keadaan valid dan validasi lebih mudah diamati saat teks dihapus.
Keluaran
Saat formulir pertama kali ditampilkan, kotak teks akan menampilkan "AngularJS" dan tombol kirim akan aktif. Segera setelah teks dihapus, pesan kesalahan akan muncul dan tombol akan dinonaktifkan.
Tangkapan layar di atas menunjukkan dua hal:
- Tombol kirim dinonaktifkan
- Tidak ada nama topik di kotak teks Topik, sehingga pesan kesalahan “Nama pengguna wajib diisi” ditampilkan.
Cara Menampilkan Kesalahan Validasi dengan ngMessages
Pola di atas berhasil, tetapi tidak dapat diskalakan. Sebuah field dengan empat batasan membutuhkan empat batasan bersarang. ng-show rentang, dan ketika beberapa di antaranya gagal sekaligus, setiap pesan muncul bersamaan. ngMessages Modul ini, yang dikirimkan secara terpisah oleh tim AngularJS, menyelesaikan kedua masalah tersebut: modul ini menampilkan satu pesan dalam satu waktu, sesuai urutan pesan yang ditulis.
Muat modul dan tambahkan sebagai dependensi.
<script src="https://code.angularjs.org/1.8.3/angular-messages.js"></script> <script> angular.module("DemoApp", ["ngMessages"]); </script>
Dengan demikian, markup tersebut terbaca sebagai daftar aturan, bukan sebagai tumpukan kondisi.
<input type="text" name="user" ng-model="user" required ng-minlength="4" ng-maxlength="20"> <div style="color:red" ng-messages="myForm.user.$error" ng-if="myForm.user.$dirty"> <div ng-message="required">A topic name is required</div> <div ng-message="minlength">Use at least 4 characters</div> <div ng-message="maxlength">Use no more than 20 characters</div> </div>
Tiga detail inilah yang membuat perangkat ini berfungsi dengan baik dalam praktiknya. Detail-detail tersebut adalah: ng-messages atribut menunjuk ke kontrol $error objek, bukan boolean, sehingga tidak ada kondisi yang perlu diulang. Hanya yang pertama cocok. ng-message menampilkan, yang berarti kolom kosong melaporkan bahwa kolom tersebut wajib diisi alih-alih juga mengeluhkan panjangnya. Menambahkan ng-messages-multiple membalikkan perilaku tersebut ketika setiap kegagalan benar-benar perlu dicantumkan.
Bungkusping blok di ng-if="myForm.user.$dirty" Menjaga formulir tetap diam sampai pengguna benar-benar mengetik sesuatu. Mengganti $touched untuk $dirty Menunda pesan lebih lanjut, hingga fokus beralih dari kolom tersebut, yang biasanya merupakan pilihan yang lebih ramah pada formulir pendaftaran yang panjang.
Satu peringatan: ngMessages dikirim sebagai file terpisah, jadi melupakan tag skrip atau ketergantungan modul akan menyebabkan blok tersebut tidak menampilkan apa pun sama sekali, tanpa kesalahan konsol untuk menjelaskannya.
Menulis pesan dengan tangan memang akurat tetapi membosankan. Bagian selanjutnya membahas modul yang menghasilkan pesan secara otomatis.
Validasi formulir menggunakan AngularJS Auto Validate
AngularJS dapat memvalidasi semua kontrol pada formulir secara otomatis, tanpa kode khusus untuk validasi atau pesan kesalahan. Hal ini dilakukan dengan menyertakan modul komunitas yang disebut "jcs-autoValidate".
Dengan modul ini, tidak diperlukan kode khusus untuk menjalankan validasi atau menampilkan pesan; semuanya ditangani di dalam jcs-autoValidate.
Contoh di bawah ini memiliki formulir sederhana dengan satu kotak teks yang wajib diisi. Pesan kesalahan akan ditampilkan jika kontrol tersebut tidak diisi.
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Event Registration</title> <link rel="stylesheet" href="lib/bootstrap.css"> <script src="https://code.angularjs.org/1.8.3/angular.min.js"></script> <script src="lib/jcs-auto-validate.min.js"></script> </head> <body> <h1>Guru99 Event</h1> <div ng-app="DemoApp"> <form name="myForm" novalidate> <div class="form-group"> <label for="user">Topic Name:</label> <input class="form-control" type="text" id="user" name="user" ng-model="user" required> </div> <div class="form-group"> <input type="submit"> </div> </form> </div> <script> var app = angular.module('DemoApp', ['jcs-autoValidate']); </script> </body> </html>
⚠️ Koreksi: Aslinya mengidentifikasi kontrol dengan id="user" Hanya itu. jcs-autoValidate mengakses kontrol melalui formulir, jadi name Atribut tersebut wajib dan pesan tidak pernah muncul tanpa atribut tersebut. Versi aslinya juga memuat dua versi AngularJS yang berbeda, 1.6.4 dari Google CDN bersamaan dengan 1.6.9, dan tidak pernah terhubung. Bootstrap meskipun contoh tersebut bergantung pada form-group ke form-control kelas untuk memposisikan teks kesalahan.
💡 Catatan: jcs-autoValidate adalah proyek komunitas dan tidak lagi dipelihara secara aktif. Meskipun masih dapat digunakan pada aplikasi AngularJS yang sudah ada, fitur bawaan (built-in) akan menggantikan fitur validasi otomatis AngularJS yang ada. ngMessages Pendekatan yang ditunjukkan sebelumnya adalah pilihan yang lebih aman untuk hal baru apa pun.
Code Penjelasan
- Skrip “jcs-auto-validate.js”, yang berisi semua fungsi validasi otomatis, disertakan.
- Setiap kontrol dan div di sekitarnya ditempatkan di dalam kelas “form-group”, di situlah modul menyuntikkan pesannya.
- Kontrol tersebut membawa id dan juga
name, dan Bootstrap memasokform-controlpenataan gaya. - Modul “jcs-autoValidate” terdaftar sebagai dependensi dari modul AngularJS.
Keluaran
Secara default, formulir akan ditampilkan persis seperti yang tertulis.
Saat formulir kosong dikirimkan, akan muncul pesan “Kolom ini wajib diisi”, yang sepenuhnya dihasilkan oleh jcs-autoValidate. Setelah formulir tervalidasi, pertanyaan yang tersisa adalah apa yang dilihat pengguna saat formulir sedang dikirim.
Masukan pengguna dengan tombol Ladda
Tombol “Ladda” adalah kerangka kerja yang dibangun di atas JavaNaskah yang memberikan efek visual pada tombol saat ditekan.
Jika sebuah tombol diberi atribut “ladda” dan ditekan, efek putaran akan ditampilkan. Berbagai gaya data tersedia untuk efek visual tambahan.
Contoh di bawah ini menunjukkan formulir sederhana dengan tombol kirim. Saat tombol ditekan, efek putaran akan muncul di atasnya.
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Event Registration</title> <link rel="stylesheet" href="lib/bootstrap.css"> <script src="https://code.angularjs.org/1.8.3/angular.min.js"></script> <script src="lib/angular-ladda.min.js"></script> </head> <body> <h1>Guru99 Event</h1> <div ng-app="DemoApp" ng-controller="DemoController"> <form name="myForm" novalidate ng-submit="submit()"> <button class="btn btn-primary" type="submit" ladda="submitting" name="sbutton" data-style="expand-right">Submit</button> </form> </div> <script> var app = angular.module('DemoApp', ['angular-ladda']); app.controller('DemoController', function($scope) { $scope.submitting = false; $scope.submit = function() { $scope.submitting = true; }; }); </script> </body> </html>
⚠️ Koreksi: yang asli dimuat angular-ladda.js ke angular-ladda.min.js bersama-sama, yang mendaftarkan modul yang sama dua kali, dan sekali lagi menarik dua versi AngularJS. Itu juga mencantumkan jcs-autoValidate sebagai dependensi yang tidak pernah digunakan dalam contoh ini. Satu salinan dari setiap pustaka dimuat di sini.
Code Penjelasan
- The "ng-kirimDirektif ” memanggil fungsi bernama “submit”, yang mengubah atribut ladda dari tombol.
- Atribut ladda termasuk dalam kerangka kerja Ladda dan merupakan atribut yang menambahkan efek putaran. Nilainya terikat pada
submittingvariabel. - Properti data-style adalah atribut Ladda lain yang memilih efek visual yang berbeda.
- Modul 'angular-ladda' harus ditambahkan ke aplikasi AngularJS agar framework dapat berfungsi.
- The
submittingVariabel diinisialisasi ke false, sehingga tombol dimulai tanpa efek putar. - Fungsi submit mengatur
submittingmenjadi true, yang akan menerapkan efek tersebut. Dalam aplikasi nyata, nilai tersebut akan diatur ulang menjadi false setelah server merespons, jika tidak, tombol akan terus berputar tanpa henti.
Keluaran
Saat formulir pertama kali ditampilkan, tombol kirim akan terlihat dalam bentuk aslinya.
Saat tombol ditekan, maka submitting Variabel diatur menjadi true. Nilai tersebut mencapai atribut "ladda" pada tombol, menghasilkan efek putaran.














