Формы и валидация во Flutter
В этом разделе мы рассмотрим создание, валидацию и обработку отправки форм во Flutter.
TextFormField - поле ввода формы
TextFormField — это TextField, специально предназначенный для форм, со встроенной поддержкой валидации.
Пример: базовая форма
class LoginForm extends StatefulWidget {
const LoginForm({super.key});
@override
State<LoginForm> createState() => _LoginFormState();
}
class _LoginFormState extends State<LoginForm> {
// Ключ формы (для валидации)
final _formKey = GlobalKey<FormState>();
// Контроллеры ввода
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: [
// Ввод имени пользователя
TextFormField(
controller: _usernameController,
decoration: const InputDecoration(
labelText: Имя пользователя,
prefixIcon: Icon(Icons.person),
),
// Валидатор
validator: (value) {
if (value == null || value.isEmpty) {
return 'Введите имя пользователя';
}
if (value.length < 3) {
return 'Имя пользователя должно содержать не менее 3 символов';
}
return null;
},
),
const SizedBox(height: 16),
// Ввод пароля
TextFormField(
controller: _passwordController,
obscureText: true, // Скрыть пароль
decoration: const InputDecoration(
labelText: Пароль,
prefixIcon: Icon(Icons.lock),
),
validator: (value) {
if (value == null || value.isEmpty) {
return 'Введите пароль';
}
if (value.length < 6) {
return 'Пароль должен содержать не менее 6 символов';
}
return null;
},
),
const SizedBox(height: 24),
// Кнопка отправки
ElevatedButton(
onPressed: _submit,
child: const Text('Вход'),
),
],
),
);
}
void _submit() {
// Проверить форму
if (_formKey.currentState?.validate() ?? false) {
// Проверка пройдена
print('Имя пользователя: ${_usernameController.text}');
print('Пароль: ${_passwordController.text}');
// Отправить на сервер...
} else {
// Проверка не пройдена
print('Проверка формы не пройдена');
}
}
}
const LoginForm({super.key});
@override
State<LoginForm> createState() => _LoginFormState();
}
class _LoginFormState extends State<LoginForm> {
// Ключ формы (для валидации)
final _formKey = GlobalKey<FormState>();
// Контроллеры ввода
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: [
// Ввод имени пользователя
TextFormField(
controller: _usernameController,
decoration: const InputDecoration(
labelText: Имя пользователя,
prefixIcon: Icon(Icons.person),
),
// Валидатор
validator: (value) {
if (value == null || value.isEmpty) {
return 'Введите имя пользователя';
}
if (value.length < 3) {
return 'Имя пользователя должно содержать не менее 3 символов';
}
return null;
},
),
const SizedBox(height: 16),
// Ввод пароля
TextFormField(
controller: _passwordController,
obscureText: true, // Скрыть пароль
decoration: const InputDecoration(
labelText: Пароль,
prefixIcon: Icon(Icons.lock),
),
validator: (value) {
if (value == null || value.isEmpty) {
return 'Введите пароль';
}
if (value.length < 6) {
return 'Пароль должен содержать не менее 6 символов';
}
return null;
},
),
const SizedBox(height: 24),
// Кнопка отправки
ElevatedButton(
onPressed: _submit,
child: const Text('Вход'),
),
],
),
);
}
void _submit() {
// Проверить форму
if (_formKey.currentState?.validate() ?? false) {
// Проверка пройдена
print('Имя пользователя: ${_usernameController.text}');
print('Пароль: ${_passwordController.text}');
// Отправить на сервер...
} else {
// Проверка не пройдена
print('Проверка формы не пройдена');
}
}
}
Общие валидаторы
Пример: Общие правила валидации
// Проверить имя пользователя
String? validateUsername(String? value) {
if (value == null || value.isEmpty) {
return 'Введите имя пользователя';
}
if (!RegExp(r'^[a-zA-Z0-9_]+$').hasMatch(value)) {
return 'Может содержать только буквы, цифры и символы подчеркивания';
}
return null;
}
// Проверка электронной почты
String? validateEmail(String? value) {
if (value == null || value.isEmpty) {
return 'Пожалуйста, введите адрес электронной почты';
}
final emailRegex = RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$');
if (!emailRegex.hasMatch(value)) {
return Пожалуйста, введите корректный адрес электронной почты;
}
return null;
}
// Проверка надежности пароля
String? validatePassword(String? value) {
if (value == null || value.isEmpty) {
return 'Введите пароль';
}
if (value.length < 8) {
return 'Пароль должен содержать не менее 8 символов';
}
if (!RegExp(r'[A-Z]').hasMatch(value)) {
return 'Пароль должен содержать хотя бы одну заглавную букву';
}
if (!RegExp(r'[0-9]').hasMatch(value)) {
return 'Пароль должен содержать хотя бы одну цифру';
}
return null;
}
// Проверить номер телефона
String? validatePhone(String? value) {
if (value == null || value.isEmpty) {
return 'Пожалуйста, введите номер телефона';
}
final phoneRegex = RegExp(r'^1[3-9]\d{9}$');
if (!phoneRegex.hasMatch(value)) {
return 'Пожалуйста, введите действительный номер телефона';
}
return null;
}
// Проверить совпадение паролей
String? validateConfirmPassword(String? value, String password) {
if (value == null || value.isEmpty) {
return 'Пожалуйста, подтвердите пароль';
}
if (value != password) {
return 'Пароли не совпадают';
}
return null;
}
String? validateUsername(String? value) {
if (value == null || value.isEmpty) {
return 'Введите имя пользователя';
}
if (!RegExp(r'^[a-zA-Z0-9_]+$').hasMatch(value)) {
return 'Может содержать только буквы, цифры и символы подчеркивания';
}
return null;
}
// Проверка электронной почты
String? validateEmail(String? value) {
if (value == null || value.isEmpty) {
return 'Пожалуйста, введите адрес электронной почты';
}
final emailRegex = RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$');
if (!emailRegex.hasMatch(value)) {
return Пожалуйста, введите корректный адрес электронной почты;
}
return null;
}
// Проверка надежности пароля
String? validatePassword(String? value) {
if (value == null || value.isEmpty) {
return 'Введите пароль';
}
if (value.length < 8) {
return 'Пароль должен содержать не менее 8 символов';
}
if (!RegExp(r'[A-Z]').hasMatch(value)) {
return 'Пароль должен содержать хотя бы одну заглавную букву';
}
if (!RegExp(r'[0-9]').hasMatch(value)) {
return 'Пароль должен содержать хотя бы одну цифру';
}
return null;
}
// Проверить номер телефона
String? validatePhone(String? value) {
if (value == null || value.isEmpty) {
return 'Пожалуйста, введите номер телефона';
}
final phoneRegex = RegExp(r'^1[3-9]\d{9}$');
if (!phoneRegex.hasMatch(value)) {
return 'Пожалуйста, введите действительный номер телефона';
}
return null;
}
// Проверить совпадение паролей
String? validateConfirmPassword(String? value, String password) {
if (value == null || value.isEmpty) {
return 'Пожалуйста, подтвердите пароль';
}
if (value != password) {
return 'Пароли не совпадают';
}
return null;
}
Пример сложной формы
Пример: форма регистрации
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: [
// Имя пользователя
TextFormField(
controller: _usernameController,
decoration: const InputDecoration(labelText: Имя пользователя),
validator: validateUsername,
),
const SizedBox(height: 16),
// Электронная почта
TextFormField(
controller: _emailController,
keyboardType: TextInputType.emailAddress,
decoration: const InputDecoration(labelText: Электронная почта),
validator: validateEmail,
),
const SizedBox(height: 16),
// Номер телефона
TextFormField(
controller: _phoneController,
keyboardType: TextInputType.phone,
decoration: const InputDecoration(labelText: 'Номер телефона'),
validator: validatePhone,
),
const SizedBox(height: 16),
// Пароль
TextFormField(
controller: _passwordController,
obscureText: true,
decoration: const InputDecoration(labelText: Пароль),
validator: validatePassword,
),
const SizedBox(height: 16),
// Подтверждение пароля
TextFormField(
controller: _confirmPasswordController,
obscureText: true,
decoration: const InputDecoration(labelText: Подтверждение пароля),
validator: (value) => validateConfirmPassword(
value,
_passwordController.text,
),
),
const SizedBox(height: 16),
// Согласие с условиями
CheckboxListTile(
value: _acceptTerms,
onChanged: (value) {
setState(() {
_acceptTerms = value ?? false;
});
},
title: const Text(Я согласен с Условиями обслуживания),
controlAffinity: ListTileControlAffinity.leading,
),
const SizedBox(height: 24),
// Кнопка отправки
ElevatedButton(
onPressed: _acceptTerms ? _submit : null,
child: const Text(Зарегистрироваться),
),
],
),
);
}
void _submit() {
if (_formKey.currentState?.validate() ?? false) {
// Отправить форму
print(Регистрация прошла успешно!);
}
}
@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: [
// Имя пользователя
TextFormField(
controller: _usernameController,
decoration: const InputDecoration(labelText: Имя пользователя),
validator: validateUsername,
),
const SizedBox(height: 16),
// Электронная почта
TextFormField(
controller: _emailController,
keyboardType: TextInputType.emailAddress,
decoration: const InputDecoration(labelText: Электронная почта),
validator: validateEmail,
),
const SizedBox(height: 16),
// Номер телефона
TextFormField(
controller: _phoneController,
keyboardType: TextInputType.phone,
decoration: const InputDecoration(labelText: 'Номер телефона'),
validator: validatePhone,
),
const SizedBox(height: 16),
// Пароль
TextFormField(
controller: _passwordController,
obscureText: true,
decoration: const InputDecoration(labelText: Пароль),
validator: validatePassword,
),
const SizedBox(height: 16),
// Подтверждение пароля
TextFormField(
controller: _confirmPasswordController,
obscureText: true,
decoration: const InputDecoration(labelText: Подтверждение пароля),
validator: (value) => validateConfirmPassword(
value,
_passwordController.text,
),
),
const SizedBox(height: 16),
// Согласие с условиями
CheckboxListTile(
value: _acceptTerms,
onChanged: (value) {
setState(() {
_acceptTerms = value ?? false;
});
},
title: const Text(Я согласен с Условиями обслуживания),
controlAffinity: ListTileControlAffinity.leading,
),
const SizedBox(height: 24),
// Кнопка отправки
ElevatedButton(
onPressed: _acceptTerms ? _submit : null,
child: const Text(Зарегистрироваться),
),
],
),
);
}
void _submit() {
if (_formKey.currentState?.validate() ?? false) {
// Отправить форму
print(Регистрация прошла успешно!);
}
}
@override
void dispose() {
_usernameController.dispose();
_emailController.dispose();
_phoneController.dispose();
_passwordController.dispose();
_confirmPasswordController.dispose();
super.dispose();
}
}
Другие расширенияПроверка формы должна выполняться как на стороне клиента (для удобства пользователя), так и на стороне сервера (для безопасности); не полагайтесь только на проверку на стороне клиента.