TextEditingControllerで入力フィールドを操作し、FormとTextFormFieldのおかげですべての入力を一度に検証しましょう。
このレッスンを Kodokon で開くコントローラーのない入力フィールドはブラックボックスです。TextEditingControllerはあなたに主導権を与えます。いつでもcontroller.textを読み取り、フィールドをあらかじめ埋め、送信後にクリアし、あるいはaddListenerで一打鍵ごとに耳を傾けられます。コントローラーはStateの中で作られ、決してbuildの中では作りません。さもないと再構築のたびに作り直されてしまいます。
import 'package:flutter/material.dart';
class NicknameField extends StatefulWidget {
const NicknameField({super.key});
@override
State<NicknameField> createState() =>
_NicknameFieldState();
}
class _NicknameFieldState extends State<NicknameField> {
final _controller = TextEditingController();
@override
void dispose() {
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return TextField(
controller: _controller,
decoration: const InputDecoration(
labelText: 'Nickname',
border: OutlineInputBorder(),
),
onSubmitted: (value) => debugPrint(value),
);
}
}画面に確認すべきフィールドが複数あるようになったら、Form、GlobalKey<FormState>、TextFormFieldの三点セットを採用しましょう。各フィールドはvalidatorの中で自身のルールを記述します。この関数はエラーメッセージを返すか、問題がなければnullを返します。キーに対してvalidate()を呼び出すと、すべてのバリデーターが一度に起動します。
import 'package:flutter/material.dart';
class SignUpForm extends StatefulWidget {
const SignUpForm({super.key});
@override
State<SignUpForm> createState() => _SignUpFormState();
}
class _SignUpFormState extends State<SignUpForm> {
final _formKey = GlobalKey<FormState>();
final _emailController = TextEditingController();
@override
void dispose() {
_emailController.dispose();
super.dispose();
}
void _submit() {
if (_formKey.currentState!.validate()) {
debugPrint('Email: ${_emailController.text}');
}
}
@override
Widget build(BuildContext context) {
return Form(
key: _formKey,
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
TextFormField(
controller: _emailController,
keyboardType: TextInputType.emailAddress,
decoration: const InputDecoration(
labelText: 'Email',
),
validator: (value) {
if (value == null || value.isEmpty) {
return 'Required field';
}
if (!value.contains('@')) {
return 'Invalid address';
}
return null;
},
),
const SizedBox(height: 16),
FilledButton(
onPressed: _submit,
child: const Text('Create account'),
),
],
),
);
}
}ボタンがクリックされると、validate()は各validatorを実行します。返されたメッセージは該当するフィールドの下に赤で表示され、少なくとも一つのフィールドが無効ならメソッドはfalseを返します。したがって送信ロジックはたった一つのifの後ろに置かれ、無効なデータを送信することは不可能になります。