ngForm directive and form state in Angular

Introduction

The ngForm directive helps Angular track and manage the state of a form easily. It tells Angular to watch the form's inputs and know if the form is valid, dirty, or touched.

When you want to check if a user has filled out a form correctly before submitting.

When you want to disable the submit button until the form is valid.

When you want to show error messages only after the user interacts with form fields.

When you want to reset the form state after submission.

When you want to track if the user has changed any input in the form.

Syntax

Angular

<form #formName="ngForm">
  <!-- form controls here -->
</form>

The #formName="ngForm" creates a local variable to access the form's state.

You can use this variable to check properties like formName.valid, formName.dirty, and formName.touched.

Examples

This form disables the submit button until the email input is valid and filled.

Angular

<form #myForm="ngForm">
  <input name="email" ngModel required email />
  <button [disabled]="!myForm.valid">Submit</button>
</form>

Shows an error message only after the user has interacted with the form (dirty) and it's invalid.

Angular

<form #loginForm="ngForm">
  <input name="username" ngModel required />
  <input name="password" ngModel required type="password" />
  <p *ngIf="loginForm.dirty && loginForm.invalid">Please fill all fields correctly.</p>
  <button type="submit">Login</button>
</form>

Sample Program

This component uses ngForm to track the form state. The submit button is disabled until the form is valid. When submitted, it shows the entered data and resets the form.

Angular

import { Component } from '@angular/core';

@Component({
  selector: 'app-simple-form',
  template: `
    <form #userForm="ngForm" (ngSubmit)="onSubmit(userForm)">
      <label for="name">Name:</label>
      <input id="name" name="name" ngModel required />

      <label for="age">Age:</label>
      <input id="age" name="age" ngModel type="number" required min="1" />

      <button type="submit" [disabled]="!userForm.valid">Submit</button>
    </form>

    <p *ngIf="submitted">
      Form Submitted! Name: {{ submittedData.name }}, Age: {{ submittedData.age }}
    </p>
  `
})
export class SimpleFormComponent {
  submitted = false;
  submittedData = { name: '', age: '' };

  onSubmit(form: any) {
    if (form.valid) {
      this.submittedData = form.value;
      this.submitted = true;
      form.resetForm();
    }
  }
}

Important Notes

The ngForm directive automatically creates a FormGroup behind the scenes.

Use formName.resetForm() to clear the form and reset its state.

Form controls must have a name attribute for ngForm to track them.

Summary

ngForm helps Angular track form inputs and their states.

Use the local form variable to check if the form is valid, dirty, or touched.

It makes managing form validation and submission easier and cleaner.

Practice

1. What does the ngForm directive do in Angular?

easy

A. It tracks the state and validity of a form and its inputs.

B. It styles the form elements automatically.

C. It replaces the need for HTML form tags.

D. It sends form data directly to the server.

Solution

1. Step 1: Understand the role of ngForm

   The ngForm directive is used to track the state of a form and its inputs in Angular.

2. Step 2: Identify what ngForm does not do

   It does not style elements, replace HTML tags, or send data directly; it manages form state and validation.

3. Final Answer:

   It tracks the state and validity of a form and its inputs. -> Option A

4. Quick Check:

   ngForm tracks form state = D [OK]

Hint: Remember: ngForm manages form state, not styling or data sending [OK]

Common Mistakes:

• Thinking ngForm styles the form
• Assuming ngForm replaces HTML form tags
• Believing ngForm sends data automatically

2. Which of the following is the correct way to create a local reference to a form using ngForm in Angular?

easy

A. ...

B. ...

C. ...

D. ...

Solution

1. Step 1: Recall the syntax for local form reference

   To access the form's state, Angular uses a template reference variable with ngForm as its value, like #myForm="ngForm".

2. Step 2: Check each option's correctness

   ... correctly uses #myForm="ngForm". ... misses the directive name, C misplaces the directive, and D uses incorrect binding syntax.

3. Final Answer:

   <form #myForm="ngForm"> ... </form> -> Option B

4. Quick Check:

   Local form reference = #myForm="ngForm" [OK]

Hint: Use #var="ngForm" to access form state locally [OK]

Common Mistakes:

• Omitting the "ngForm" in the reference
• Using square brackets incorrectly
• Placing ngForm attribute wrongly

3. Given this Angular template snippet:

<form #f="ngForm">
  <input name="email" ngModel required>
  <button [disabled]="!f.form.valid">Submit</button>
</form>

What happens to the Submit button when the input is empty?

medium

A. The Submit button is enabled regardless of input.

B. The Submit button is disabled only if the input is touched.

C. The Submit button is disabled because the form is invalid.

D. The Submit button is enabled only if the input is dirty.

Solution

1. Step 1: Understand form validity with required input

   The input has the required attribute, so if empty, the form is invalid.

2. Step 2: Analyze the button's disabled binding

   The button is disabled when !f.form.valid is true, meaning when the form is invalid.

3. Final Answer:

   The Submit button is disabled because the form is invalid. -> Option C

4. Quick Check:

   Required empty input disables button = B [OK]

Hint: Button disabled if form invalid (required empty input) [OK]

Common Mistakes:

• Thinking button enables on untouched input
• Confusing dirty and valid states
• Ignoring required validation effect

4. Identify the error in this Angular form snippet:

<form #myForm="ngForm">
  <input name="username" ngModel>
  <button [disabled]="myForm.invalid">Submit</button>
</form>

Why does the Submit button remain enabled even when the input is empty?

medium

A. The button binding should use myForm.form.invalid instead of myForm.invalid.

B. The local reference #myForm is incorrectly declared.

C. The ngModel directive is missing on the input.

D. The input lacks a validation rule like required, so form is valid.

Solution

1. Step 1: Check input validation rules

   The input has no validation like required, so it does not make the form invalid when empty.

2. Step 2: Confirm form validity property usage

   myForm.invalid is valid shorthand for myForm.form.invalid, so no error there.

3. Final Answer:

   The input lacks a validation rule like required, so form is valid. -> Option D

4. Quick Check:

   Missing required means form valid = C [OK]

Hint: Add required to input to make form invalid when empty [OK]

Common Mistakes:

• Assuming myForm.invalid is incorrect syntax
• Forgetting to add validation rules
• Thinking ngModel is missing when it is present

5. You want to disable the Submit button only after the user has changed any input in the form and the form is invalid. Which condition correctly uses ngForm states to achieve this?

hard

A. [disabled]="myForm.form.invalid && myForm.form.dirty"

B. [disabled]="myForm.invalid || myForm.pristine"

C. [disabled]="!myForm.form.valid && myForm.touched"

D. [disabled]="myForm.form.valid && myForm.dirty"

Solution

1. Step 1: Understand form state properties

   myForm.form.invalid is true if form is invalid; myForm.form.dirty is true if user changed any input.

2. Step 2: Match condition to requirement

   We want to disable the button only if form is invalid AND user has changed input, so both must be true.

3. Final Answer:

   [disabled]="myForm.form.invalid && myForm.form.dirty" -> Option A

4. Quick Check:

   Disable if invalid and dirty = A [OK]

Hint: Use invalid AND dirty to disable after user changes invalid form [OK]

Common Mistakes:

• Using OR instead of AND for disabling
• Confusing touched with dirty
• Checking valid instead of invalid