```html Angular - Clase 5: Formularios reactivos

Angular — Clase 5

Formularios reactivos, validaciones y gestión de estudiantes

1. Objetivos de la clase

En esta clase aprenderás a:

Importante: este HTML es el documento del tutorial. Para ejecutar la aplicación Angular real, copia los fragmentos de TypeScript, HTML y CSS en los archivos del proyecto indicados.

2. Crear el proyecto Angular

Abre Visual Studio Code y su terminal. Ejecuta:

npx @angular/cli new gestion-academica-nivel-5 --routing --style=css
cd gestion-academica-nivel-5
npm start

Angular mostrará una dirección local, normalmente http://localhost:4200. Ábrela en el navegador.

3. ¿Qué son los formularios reactivos?

Los formularios reactivos permiten definir los campos y sus reglas de validación desde TypeScript.

Ejemplos de validadores

Validators.required
Validators.minLength(3)
Validators.email
Validators.min(0)
Validators.max(10)

4. Código TypeScript del componente

Abre el archivo TypeScript principal de tu componente, normalmente app.ts o app.component.ts.

Para seguir este ejemplo, sustituye el contenido del componente principal por el siguiente código y conserva los nombres de archivos que use tu proyecto.

import { Component } from '@angular/core';
import { CommonModule } from '@angular/common';
import {
  FormBuilder,
  ReactiveFormsModule,
  Validators
} from '@angular/forms';

@Component({
  selector: 'app-root',
  standalone: true,
  imports: [CommonModule, ReactiveFormsModule],
  templateUrl: './app.html',
  styleUrl: './app.css'
})
export class App {
  estudiantes: {
    id: number;
    nombre: string;
    email: string;
    nota: number;
  }[] = [];

  formulario;

  constructor(private fb: FormBuilder) {
    this.formulario = this.fb.nonNullable.group({
      nombre: ['', [
        Validators.required,
        Validators.minLength(3)
      ]],
      email: ['', [
        Validators.required,
        Validators.email
      ]],
      nota: [5, [
        Validators.required,
        Validators.min(0),
        Validators.max(10)
      ]]
    });
  }

  guardar(): void {
    if (this.formulario.invalid) {
      this.formulario.markAllAsTouched();
      return;
    }

    const datos = this.formulario.getRawValue();

    this.estudiantes.push({
      id: Date.now(),
      nombre: datos.nombre.trim(),
      email: datos.email.trim(),
      nota: datos.nota
    });

    this.formulario.reset({
      nombre: '',
      email: '',
      nota: 5
    });
  }

  eliminar(id: number): void {
    this.estudiantes =
      this.estudiantes.filter(
        estudiante => estudiante.id !== id
      );
  }
}
Atención a las versiones: algunas versiones de Angular generan app.component.ts, app.component.html y app.component.css. Si es tu caso, adapta los nombres de templateUrl y styleUrl a esos archivos.

5. Código HTML de la aplicación Angular

Pega este código en la plantilla del componente, normalmente app.html o app.component.html.

<main class="contenedor">
  <h1>Gestión de estudiantes</h1>
  <p>Clase 5: formularios reactivos</p>

  <form [formGroup]="formulario"
        (ngSubmit)="guardar()">

    <label for="nombre">Nombre completo</label>
    <input
      id="nombre"
      type="text"
      formControlName="nombre"
      placeholder="Ej. Ana García"
    />

    <div class="error"
      *ngIf="formulario.controls.nombre.touched
        && formulario.controls.nombre.hasError('required')">
      El nombre es obligatorio.
    </div>

    <div class="error"
      *ngIf="formulario.controls.nombre.touched
        && formulario.controls.nombre.hasError('minlength')">
      Escribe al menos 3 caracteres.
    </div>

    <label for="email">Correo electrónico</label>
    <input
      id="email"
      type="email"
      formControlName="email"
      placeholder="ana@ejemplo.com"
    />

    <div class="error"
      *ngIf="formulario.controls.email.touched
        && formulario.controls.email.hasError('required')">
      El correo es obligatorio.
    </div>

    <div class="error"
      *ngIf="formulario.controls.email.touched
        && formulario.controls.email.hasError('email')">
      Introduce un correo electrónico válido.
    </div>

    <label for="nota">Nota (de 0 a 10)</label>
    <input
      id="nota"
      type="number"
      formControlName="nota"
      min="0"
      max="10"
      step="0.1"
    />

    <div class="error"
      *ngIf="formulario.controls.nota.touched
        && formulario.controls.nota.invalid">
      La nota debe estar entre 0 y 10.
    </div>

    <button type="submit">Guardar estudiante</button>
  </form>

  <h2>Estudiantes registrados</h2>

  <p *ngIf="estudiantes.length === 0">
    Todavía no hay estudiantes registrados.
  </p>

  <article class="estudiante"
    *ngFor="let estudiante of estudiantes">

    <div>
      <strong>{{ estudiante.nombre }}</strong>
      <p>{{ estudiante.email }}</p>
      <p>Nota: {{ estudiante.nota }}</p>
    </div>

    <button
      type="button"
      class="eliminar"
      (click)="eliminar(estudiante.id)">
      Eliminar
    </button>
  </article>
</main>

6. Código CSS de la aplicación

Pega estos estilos en app.css o app.component.css.

* {
  box-sizing: border-box;
}

body {
  margin: 0;
  font-family: Arial, sans-serif;
  background: #f1f5f9;
  color: #1e293b;
}

.contenedor {
  width: min(700px, 92%);
  margin: 35px auto;
  padding: 28px;
  background: white;
  border-radius: 14px;
  box-shadow: 0 6px 25px rgba(0, 0, 0, 0.08);
}

h1 {
  color: #1d4ed8;
}

form {
  display: grid;
  gap: 10px;
  margin: 25px 0;
}

label {
  font-weight: bold;
  margin-top: 8px;
}

input {
  width: 100%;
  padding: 12px;
  border: 1px solid #cbd5e1;
  border-radius: 7px;
  font-size: 16px;
}

input:focus {
  outline: 2px solid #93c5fd;
  border-color: #2563eb;
}

.error {
  color: #b91c1c;
  font-size: 14px;
}

button {
  padding: 12px 16px;
  border: 0;
  border-radius: 7px;
  background: #2563eb;
  color: white;
  font-weight: bold;
  cursor: pointer;
}

button:hover {
  background: #1d4ed8;
}

.estudiante {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 16px;
  margin-top: 12px;
  padding: 15px;
  border: 1px solid #e2e8f0;
  border-radius: 8px;
}

.estudiante p {
  margin: 5px 0;
  overflow-wrap: anywhere;
}

.eliminar {
  background: #dc2626;
}

.eliminar:hover {
  background: #b91c1c;
}

@media (max-width: 480px) {
  .contenedor {
    padding: 18px;
  }

  .estudiante {
    align-items: flex-start;
    flex-direction: column;
  }
}

7. Pruebas que debes realizar

  1. Intenta guardar el formulario vacío.
  2. Escribe un nombre de dos letras.
  3. Introduce un correo como hola.
  4. Prueba una nota de -1.
  5. Prueba una nota de 11.
  6. Introduce datos válidos y guarda.
  7. Elimina el estudiante de la lista.
Los estudiantes se guardan en un array en memoria. Al recargar la aplicación, los registros desaparecerán. Todavía no estamos usando una base de datos.

8. Errores frecuentes

No reconoce formGroup

Comprueba que ReactiveFormsModule esté incluido en los imports del componente.

No reconoce ngIf o ngFor

Comprueba que CommonModule esté importado. En proyectos con versiones recientes también puedes utilizar la sintaxis de control de flujo de Angular.

No encuentra el archivo HTML

Comprueba que templateUrl coincide con el nombre real de tu plantilla.

El servidor no arranca

npm install
npm start

9. Examen autocorregible

Selecciona una respuesta para cada pregunta y pulsa Corregir examen. Cada respuesta correcta vale un punto.

1. ¿Qué módulo se utiliza para los formularios reactivos?

2. ¿Qué validador comprueba que un campo no esté vacío?

3. ¿Para qué sirve FormGroup?

4. ¿Qué hace Validators.email?

5. ¿Qué directiva conecta un campo con un control reactivo?

6. ¿Qué significa que el formulario tenga invalid?

7. ¿Qué hace markAllAsTouched()?

8. ¿Qué validador establece una nota mínima de cero?

9. ¿Qué evento ejecuta el guardado del formulario?

10. ¿Dónde se guardan los estudiantes en este ejemplo?

10. Soluciones del examen

Mostrar las respuestas correctas
  1. ReactiveFormsModule.
  2. Validators.required.
  3. Agrupar controles del formulario.
  4. Comprobar el formato del correo.
  5. formControlName.
  6. Hay controles que no cumplen las validaciones.
  7. Marca los controles como visitados.
  8. Validators.min(0).
  9. ngSubmit.
  10. En un array en memoria.

Fin de la clase 5

Has aprendido a crear formularios reactivos, validar datos y gestionar una lista de estudiantes.

Próxima clase: comunicación entre componentes con @Input, @Output y EventEmitter.

```