Перевірка форми AngularJS під час надсилання: $dirty, $valid та $invalid

⚡ Розумний підсумок

Валідація форми в AngularJS перевіряє правильність та повноту даних, введених у форму, перш ніж вони потраплять на сервер. Тут розглядаються чотири підходи: від простих атрибутів HTML5 через властивості області видимості до модулів автоматичної валідації.

  • 🧩 Атрибути HTML5: Обов'язковий атрибут та типи введення електронної пошти, пароля та номера забезпечують нативні перевірки для браузера без використання скриптів.
  • 🔍 Державна власність: AngularJS надає доступ до переменних $dirty, $pristine, $valid та $invalid для кожного іменованого елемента керування всередині іменованої форми.
  • 🏷️ Вимога до найменування: І формі, і кожному елементу керування потрібен атрибут name, оскільки стан перевірки адресується як formName.controlName.
  • 🚫 Придушити власні спливаючі вікна: Додавання novalidate до форми запобігає перехопленню браузером відправлення, щоб AngularJS міг його обробити.
  • ???? Відображення повідомлень: Модуль ngMessages замінює складені директиви ng-show та відображає по одній помилці за раз у порядку пріоритетності.
  • ️ Автоматична перевірка: Модуль jcs-autoValidate генерує повідомлення про помилки для кожного елемента керування без будь-якої власної розмітки.
  • 🔘 Відгук про подання: Кнопка Ladda застосовує спіннер під час надсилання, сигналізуючи користувачеві про прогрес.

Перевірка форми в AngularJS

Перевірка форми В AngularJS це процес перевірки правильності та повноти даних, введених у форму. Коли користувач надсилає форму, спочатку відбувається перевірка, перш ніж дані надсилаються на сервер. Процес перевірки максимально гарантує, що поля введення були заповнені правильно.

У реальному прикладі, припустимо, що сайт вимагає заповнення реєстраційної форми перед наданням повного доступу. Сторінка реєстрації міститиме поля введення імені користувача, пароля, електронної пошти тощо.

Наприклад, ідентифікатор електронної пошти завжди має бути у форматі username@site.domainЯкщо хтось введе лише ім'я користувача, перевірка має завершитися невдачею. Перевірка виконує ці основні перевірки, перш ніж дані буде надіслано на сервер для подальшої обробки.

⚠️ Примітка до версії: AngularJS (гілка 1.x) досягла кінця життєвого циклу 31 грудня 2021 року та не отримує подальших виправлень безпеки. Наведені нижче методи залишаються правильними для застарілих програм; сучасний Angular виконує ту саму роботу з шаблонними або реактивними формами.

Перевірка форми за допомогою HTML5

Перевірка форми – це процес попередньої перевірки інформації, введеної у веб-форму, перед її надсиланням на сервер. Перевірка на стороні клієнта є кращою, оскільки вона додає набагато менше накладних витрат, ніж повторне представлення форми після циклічного відправлення.

У наведеному нижче прикладі показано просту форму реєстрації, в якій користувач вводить ім'я користувача, пароль, адресу електронної пошти та вік. Форма містить елементи керування валідацією, які гарантують правильність введення інформації.

<!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>

⚠️ Виправлення застосовано до кожного оголошення на цій сторінці. Заявлені оригінали chrset="UTF 8", який не є ні дійсним атрибутом, ні дійсним кодуванням, і завантажив AngularJS тричі — angular-route.js спочатку, що викликає помилку, оскільки модуль маршруту реєструється у фреймворку, який ще не завантажився, потім angular.min.js та angular.js, ту саму бібліотеку двічі. Вони також витягли bootstrap.css через <script> тег, тому жодного стилю ніколи не застосовувалося. Кожен список тепер завантажує одну бібліотеку версії 1.8.3 та правильно посилається на таблицю стилів. Відступи макета побудовані з повторюваних &nbsp; сутності було видалено.

Code Пояснення

  1. Для типу введення тексту, required Атрибут означає, що текстове поле не може бути порожнім під час надсилання форми.
  2. Наступний тип вводу – пароль. Оскільки тип позначено як пароль, текст, введений у поле, маскується.
  3. Оскільки тип вхідних даних визначено як електронна пошта, текст у полі має відповідати шаблону name@site.domain.
  4. Коли тип вводу позначено як число, символи, введені з клавіатури, просто не приймаються полем.

Вихід

Щоб побачити перевірку в дії, натисніть «Надіслати», нічого не вводячи.

З’являється спливаюче вікно з повідомленням про необхідність заповнення поля, тому елемент керування, позначений як обов’язковий, блокує надсилання, якщо його залишити порожнім.

Введення значення в поле керування паролем відображає символ '*', який маскує символи.

Введення неправильно сформованої електронної адреси та натискання кнопки «Надіслати» викликає спливаюче вікно із запитом на символ @. Зрештою, символи, введені в поле контролю віку, ніколи не відображаються, оскільки поле приймає лише цифри.

Спливаючі вікна браузера швидко налаштовуються, але їх текст та стиль не можна змінити. Саме тут на допомогу приходять властивості валідації AngularJS.

Перевірка форми за допомогою $dirty, $valid, $invalid, $pristine

AngularJS надає власні властивості для перевірки. Наступні властивості надаються кожному іменованому елементу керування:

  • $ брудний – Користувач взаємодіяв із елементом керування
  • $дійсний – Вміст поля дійсний
  • $invalid – Вміст поля недійсний
  • $незайманий – Користувач ще не взаємодіяв із елементом керування

Нижче наведено кроки для виконання валідації AngularJS.

Крок 1) Ввімкніть кнопку novalidate властивість під час оголошення форми. Це повідомляє браузеру, що перевірка буде виконана AngularJS.

Крок 2) Переконайтеся, що для форми визначено назву, оскільки ця назва використовується для досягнення стану перевірки.

Крок 3) Переконайтеся, що кожен елемент керування також має name атрибут з тієї ж причини. Елемент керування без імені ніколи не реєструється у формі.

Крок 4) Ввімкніть кнопку нг-шоу директива для перевірки властивостей $dirty, $invalid та $valid.

У наведеному нижче прикладі є одне текстове поле, в яке користувач вводить назву теми. Якщо його залишити порожнім, спрацює помилка перевірки та відобразиться відповідне повідомлення.

<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>

⚠️ Виправлено дві логічні помилки. Оригінал відключив кнопку за допомогою ng-disabled="myForm.user.$dirty && myForm.user.$invalid". Оскільки $dirty є хибним, доки користувач не торкнеться поля, кнопка залишається включений на недоторканій порожній формі, саме той випадок, який вона мала заблокувати; myForm.$invalid охоплює обидва. Оригінал також обгорнув значення за замовчуванням у $scope.Display = function () { $scope.user = 'Angular'; }, функція, яку ніхто ніколи не викликав, тому текстове поле відкрилося порожнім, незважаючи на те, що текст стверджував, що відображає «AngularJS». Присвоєння тепер виконується безпосередньо, зі значенням, яке цитує навколишній текст.

Code Пояснення

  1. Формі надається ім'я «myForm». Це потрібно для доступу до її елементів керування для перевірки.
  2. Команда novalidate Властивість зупиняє перевірку браузером, тому AngularJS може зробити це замість нього.
  3. Директива ng-show перевіряє властивості “$dirty” та “$invalid”. Якщо текстове поле було змінено, $dirty має значення true; якщо його значення порожнє, $invalid має значення true. Коли обидва значення true, відображається діапазон із червоним текстом.
  4. Вкладена перевірка зчитує властивість «$error.required», яка є істинною, коли обов’язковий елемент керування не має значення, та відображає «Ім’я користувача обов’язкове».
  5. Кнопка "Надіслати" вимкнена через ng-disabled щоразу, коли форма в цілому є недійсною.
  6. Контролер встановлює початкове значення текстового поля на «AngularJS», тому форма відкривається у дійсному стані, і перевірку легше спостерігати під час видалення тексту.

Вихід

Під час першого відображення форми текстове поле показує «AngularJS», а кнопка надіслати активна. Щойно текст видалено, з’являється повідомлення про помилку, а кнопка деактивується.

На скріншоті вище показано дві речі:

  • Кнопка "Надіслати" неактивна
  • У текстовому полі «Тема» немає назви теми, тому відображається повідомлення про помилку «Потрібне ім’я користувача».

Як відображати помилки перевірки за допомогою ngMessages

Наведений вище шаблон працює, але він не масштабується. Полю з чотирма обмеженнями потрібно чотири вкладених ng-show прольоти, і коли кілька з них виходять з ладу одночасно, усі повідомлення з'являються разом. ngMessages Модуль, що постачається окремо командою AngularJS, вирішує обидві проблеми: він відображає по одному повідомленню за раз, у порядку їх запису.

Завантажте модуль та додайте його як залежність.

<script src="https://code.angularjs.org/1.8.3/angular-messages.js"></script>
<script>
    angular.module("DemoApp", ["ngMessages"]);
</script>

Тоді розмітка читається як список правил, а не як набір умов.

<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>

Три деталі роблять це добре функціонуючим на практиці. ng-messages атрибутні точки на елементі керування $error об'єкт, а не на логічне значення, тому жодної умови не потрібно повторювати. Тільки перший збіг ng-message рендерить, що означає, що порожнє поле повідомляє про те, що воно обов'язкове, а не скаржиться на його довжину. Додавання ng-messages-multiple змінює таку поведінку, коли справді потрібно перерахувати кожну невдачу.

Обернітьping блок у ng-if="myForm.user.$dirty" Зберігає форму без відображення, доки користувач фактично щось не введе. Підстановка $touched та цінності $dirty ще більше затримує повідомлення, доки фокус не зникне з поля, що зазвичай є більш зручним вибором для довгої реєстраційної форми.

Одне застереження: ngMessages постачається як окремий файл, тому якщо забути тег скрипта або залежність модуля, блок взагалі не відтворюється, без жодної консольної помилки, яка б це пояснювала.

Написання повідомлень від руки є точним, але повторюваним. У наступному розділі розглядається модуль, який генерує їх автоматично.

Перевірка форми за допомогою AngularJS Auto Validate

AngularJS може автоматично перевіряти всі елементи керування на формі, без спеціального коду для перевірки або повідомлень про помилки. Це робиться шляхом включення модуля спільноти під назвою «jcs-autoValidate».

З цим модулем не потрібен спеціальний код для запуску перевірки або відображення повідомлень; все обробляється всередині jcs-autoValidate.

У наведеному нижче прикладі наведено просту форму з одним обов'язковим текстовим полем. Якщо елемент керування не заповнено, відображається повідомлення про помилку.

<!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>

⚠️ Виправлення: оригінал ототожнював контроль з id="user" тільки. jcs-autoValidate досягає елемента керування через форму, тому a name Атрибут обов'язковий, і повідомлення ніколи не з'являлося без нього. Оригінал також завантажував дві різні версії AngularJS, 1.6.4 з Google CDN разом з версією 1.6.9, і ніколи не було пов'язано Bootstrap навіть якщо приклад залежить від його form-group та form-control класи для позиціонування тексту помилки.

💡 Примітка: jcs-autoValidate – це спільнотний проект, який більше не підтримується активно. Він залишається придатним для використання в існуючих застосунках AngularJS, але вбудована ngMessages Підхід, показаний раніше, є безпечнішим вибором для чогось нового.

Code Пояснення

  1. Включено скрипт «jcs-auto-validate.js», який містить усі функції автоматичної перевірки.
  2. Кожен елемент керування та навколишній його div розміщуються всередині класу «form-group», куди модуль вставляє своє повідомлення.
  3. Елемент керування містить як ідентифікатор, так і name та Bootstrap постачає form-control стайлінг.
  4. Модуль «jcs-autoValidate» вказаний як залежність модуля AngularJS.

Вихід

За замовчуванням форма відображається точно так, як написана.

Після надсилання порожньої форми відображається повідомлення «Це поле обов’язкове для заповнення», повністю згенероване jcs-autoValidate. Після перевірки форми залишається питання, що бачить користувач під час її надсилання.

Відгуки користувачів за допомогою кнопок Ladda

Кнопки «Ladda» – це фреймворк, побудований на основі JavaScript що надає кнопкам візуального ефекту під час їх натискання.

Якщо кнопці надано атрибут «ladda» та натиснуто, відображається ефект обертання. Для додаткових візуальних ефектів доступні різні стилі даних.

У наведеному нижче прикладі показано просту форму з кнопкою відправлення. Після натискання кнопки на ній з’являється ефект обертання.

<!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>

⚠️ Виправлення: оригінал завантажено angular-ladda.js та angular-ladda.min.js разом, що двічі реєструє той самий модуль, і знову завантажує дві версії AngularJS. Також у списку перелічено jcs-autoValidate як залежність, яку цей приклад ніколи не використовує. Тут завантажується одна копія кожної бібліотеки.

Code Пояснення

  1. Подіяng-податиДиректива ” викликає функцію з назвою “submit”, яка змінює атрибут ladda кнопки.
  2. Атрибут ladda належить до фреймворку Ladda і саме він додає ефект обертання. Його значення пов'язане з submitting змінна.
  3. Властивість data-style – це ще один атрибут Ladda, який вибирає інший візуальний ефект.
  4. Для роботи фреймворку до застосунку AngularJS необхідно додати модуль 'angular-ladda'.
  5. Команда submitting Змінна ініціалізується значенням false, тому кнопка запускається без ефекту обертання.
  6. Функція submit набирає submitting на true, що застосовує ефект. У реальному застосунку воно б скинулося на false після відповіді сервера, інакше кнопка обертатиметься вічно.

Вихід

Під час першого відображення форми кнопка відправлення відображається у звичайному вигляді.

Коли натиснуто кнопку, submitting Змінна встановлена ​​на значення true. Це значення досягає атрибута кнопки «ladda», створюючи ефект обертання.

Поширені запитання

$dirty стає true, коли значення змінюється. $touched стає true, коли поле втрачає фокус. Використовуйте $touched, щоб затримати помилку, доки користувач не перейде далі, що виглядає менш агресивно, поки typing.

Додайте директиву ng-pattern з регулярним виразом, наприклад, ng-pattern=”/^[0-9]{6}$/”. Помилка потім відображається як $error.pattern, про що ngMessages може повідомляти, як про будь-яке вбудоване обмеження.

Так. Інструменти штучного інтелекту зчитують розмітку та створюють відповідні блоки required, ng-pattern та ngMessages. Завжди перевіряйте регулярні вирази, оскільки згенеровані шаблони електронної пошти та телефону часто відхиляють коректний вхід.

Помічники ШІ швидко перевіряють три звичайні причини: відсутній атрибут name у формі або елементі керування, відсутня ng-модель та новалідате, пропущений, щоб браузер перехоплював відправлення першим.

Ні. Це покращує взаємодію з клієнтом та зменшує кількість циклів обробки, але будь-хто може обійти це за допомогою інструментів розробника. Кожне правило, що застосовується в браузері, має бути застосовано ще раз на сервері.

Підсумуйте цей пост за допомогою: