Flutter Formularios y Validación

Esta sección presentará la creación, validación y manejo de envío de formularios en Flutter.


TextFormField - Entrada de formulario

TextFormField es un TextField diseñado específicamente para formularios, con soporte de validación integrado.

Ejemplo: Formulario básico

class LoginForm extends StatefulWidget {
  const LoginForm({super.key});

  @override
  State<LoginForm> createState() => _LoginFormState();
}

class _LoginFormState extends State<LoginForm> {
  // Clave del formulario (para validación)
  final _formKey = GlobalKey<FormState>();

  // Controladores de entrada
  final _usernameController = TextEditingController();
  final _passwordController = TextEditingController();

  @override
  void dispose() {
    _usernameController.dispose();
    _passwordController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        children: [
          // Entrada de nombre de usuario
          TextFormField(
            controller: _usernameController,
            decoration: const InputDecoration(
              labelText: 'Nombre de usuario',
              prefixIcon: Icon(Icons.person),
            ),
            // Validador
            validator: (value) {
              if (value == null || value.isEmpty) {
                return 'Por favor ingrese el nombre de usuario';
              }
              if (value.length < 3) {
                return 'El nombre de usuario debe tener al menos 3 caracteres';
              }
              return null;
            },
          ),
          const SizedBox(height: 16),
          // Entrada de contraseña
          TextFormField(
            controller: _passwordController,
            obscureText: true,  // Ocultar contraseña
            decoration: const InputDecoration(
              labelText: 'Contraseña',
              prefixIcon: Icon(Icons.lock),
            ),
            validator: (value) {
              if (value == null || value.isEmpty) {
                return 'Por favor ingrese la contraseña';
              }
              if (value.length < 6) {
                return 'La contraseña debe tener al menos 6 caracteres';
              }
              return null;
            },
          ),
          const SizedBox(height: 24),
          // Botón de envío
          ElevatedButton(
            onPressed: _submit,
            child: const Text('Iniciar sesión'),
          ),
        ],
      ),
    );
  }

  void _submit() {
    // Validar formulario
    if (_formKey.currentState?.validate() ?? false) {
      // Validación exitosa
      print('Nombre de usuario: ${_usernameController.text}');
      print('Contraseña: ${_passwordController.text}');
      // Enviar al servidor...
    } else {
      // Fallo de validación
      print('Falló la validación del formulario');
    }
  }
}

Validadores comunes

Ejemplo: Reglas de validación comunes

// Validar nombre de usuario
String? validateUsername(String? value) {
  if (value == null || value.isEmpty) {
    return 'Por favor ingrese el nombre de usuario';
  }
  if (!RegExp(r'^[a-zA-Z0-9_]+$').hasMatch(value)) {
    return 'Solo puede contener letras, números y guiones bajos';
  }
  return null;
}

// Validar correo electrónico
String? validateEmail(String? value) {
  if (value == null || value.isEmpty) {
    return 'Por favor ingrese el correo electrónico';
  }
  final emailRegex = RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$');
  if (!emailRegex.hasMatch(value)) {
    return 'Por favor ingrese una dirección de correo electrónico válida';
  }
  return null;
}

// Validar fortaleza de la contraseña
String? validatePassword(String? value) {
  if (value == null || value.isEmpty) {
    return 'Por favor ingrese la contraseña';
  }
  if (value.length < 8) {
    return 'La contraseña debe tener al menos 8 caracteres';
  }
  if (!RegExp(r'[A-Z]').hasMatch(value)) {
    return 'La contraseña debe contener al menos una letra mayúscula';
  }
  if (!RegExp(r'[0-9]').hasMatch(value)) {
    return 'La contraseña debe contener al menos un número';
  }
  return null;
}

// Validar número de teléfono móvil
String? validatePhone(String? value) {
  if (value == null || value.isEmpty) {
    return 'Por favor ingrese el número de teléfono móvil';
  }
  final phoneRegex = RegExp(r'^1[3-9]\d{9}$');
  if (!phoneRegex.hasMatch(value)) {
    return 'Por favor ingrese un número de teléfono móvil válido';
  }
  return null;
}

// Validar que las contraseñas coincidan
String? validateConfirmPassword(String? value, String password) {
  if (value == null || value.isEmpty) {
    return 'Por favor confirme la contraseña';
  }
  if (value != password) {
    return 'Las contraseñas no coinciden';
  }
  return null;
}

Ejemplo de formulario complejo

Ejemplo: Formulario de registro

class RegisterForm extends StatefulWidget {
  const RegisterForm({super.key});

  @override
  State<RegisterForm> createState() => _RegisterFormState();
}

class _RegisterFormState extends State<RegisterForm> {
  final _formKey = GlobalKey<FormState>();
  final _usernameController = TextEditingController();
  final _emailController = TextEditingController();
  final _phoneController = TextEditingController();
  final _passwordController = TextEditingController();
  final _confirmPasswordController = TextEditingController();

  bool _acceptTerms = false;

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: ListView(
        padding: const EdgeInsets.all(16),
        children: [
          // Nombre de usuario
          TextFormField(
            controller: _usernameController,
            decoration: const InputDecoration(labelText: 'Nombre de usuario'),
            validator: validateUsername,
          ),
          const SizedBox(height: 16),
          // Correo electrónico
          TextFormField(
            controller: _emailController,
            keyboardType: TextInputType.emailAddress,
            decoration: const InputDecoration(labelText: 'Correo electrónico'),
            validator: validateEmail,
          ),
          const SizedBox(height: 16),
          // Número de teléfono móvil
          TextFormField(
            controller: _phoneController,
            keyboardType: TextInputType.phone,
            decoration: const InputDecoration(labelText: 'Número de teléfono móvil'),
            validator: validatePhone,
          ),
          const SizedBox(height: 16),
          // Contraseña
          TextFormField(
            controller: _passwordController,
            obscureText: true,
            decoration: const InputDecoration(labelText: 'Contraseña'),
            validator: validatePassword,
          ),
          const SizedBox(height: 16),
          // Confirmar contraseña
          TextFormField(
            controller: _confirmPasswordController,
            obscureText: true,
            decoration: const InputDecoration(labelText: 'Confirmar contraseña'),
            validator: (value) => validateConfirmPassword(
              value,
              _passwordController.text,
            ),
          ),
          const SizedBox(height: 16),
          // Aceptar términos
          CheckboxListTile(
            value: _acceptTerms,
            onChanged: (value) {
              setState(() {
                _acceptTerms = value ?? false;
              });
            },
            title: const Text('Acepto los términos de servicio'),
            controlAffinity: ListTileControlAffinity.leading,
          ),
          const SizedBox(height: 24),
          // Botón de envío
          ElevatedButton(
            onPressed: _acceptTerms ? _submit : null,
            child: const Text('Registrarse'),
          ),
        ],
      ),
    );
  }

  void _submit() {
    if (_formKey.currentState?.validate() ?? false) {
      // Enviar formulario
      print('¡Registro exitoso!');
    }
  }

  @override
  void dispose() {
    _usernameController.dispose();
    _emailController.dispose();
    _phoneController.dispose();
    _passwordController.dispose();
    _confirmPasswordController.dispose();
    super.dispose();
  }
}

La validación de formularios debe realizarse tanto en el cliente (experiencia de usuario) como en el servidor (seguridad); no confíe únicamente en la validación del cliente.

Otras extensiones