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');
}
}
}
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;
}
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();
}
}
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();
}
}
Otras extensionesLa 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.