TextFormField in Flutter

Introduction

TextFormField lets users type text in your app. It helps collect information like names or emails.

When you want to ask users to enter their name or email.

When you need a form to collect user input like passwords or comments.

When you want to validate user input before saving it.

When you want to show hints or labels inside the text box.

When you want to control the keyboard type, like numbers or email.

Syntax

Flutter

TextFormField(
  controller: TextEditingController(),
  decoration: InputDecoration(
    labelText: 'Label',
    hintText: 'Hint',
  ),
  keyboardType: TextInputType.text,
  validator: (value) {
    if (value == null || value.isEmpty) {
      return 'Please enter some text';
    }
    return null;
  },
  onSaved: (value) {
    // Save the value
  },
)

controller manages the text inside the field.

decoration adds labels and hints to guide users.

Examples

A simple text field with a label 'Name'.

Flutter

TextFormField(
  decoration: InputDecoration(labelText: 'Name'),
)

Text field optimized for email input with a label.

Flutter

TextFormField(
  keyboardType: TextInputType.emailAddress,
  decoration: InputDecoration(labelText: 'Email'),
)

Text field that hides input, used for passwords.

Flutter

TextFormField(
  obscureText: true,
  decoration: InputDecoration(labelText: 'Password'),
)

Sample App

This app shows a form with a text field for the user to enter their name. When the user taps Submit, it checks if the field is empty. If not, it shows a greeting message with the entered name.

Flutter

import 'package:flutter/material.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('TextFormField Example')),
        body: Padding(
          padding: EdgeInsets.all(16),
          child: MyCustomForm(),
        ),
      ),
    );
  }
}

class MyCustomForm extends StatefulWidget {
  @override
  _MyCustomFormState createState() => _MyCustomFormState();
}

class _MyCustomFormState extends State<MyCustomForm> {
  final _formKey = GlobalKey<FormState>();
  final _controller = TextEditingController();

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          TextFormField(
            controller: _controller,
            decoration: InputDecoration(
              labelText: 'Enter your name',
              hintText: 'John Doe',
            ),
            validator: (value) {
              if (value == null || value.isEmpty) {
                return 'Please enter your name';
              }
              return null;
            },
          ),
          SizedBox(height: 20),
          ElevatedButton(
            onPressed: () {
              if (_formKey.currentState!.validate()) {
                ScaffoldMessenger.of(context).showSnackBar(
                  SnackBar(content: Text('Hello, ${_controller.text}!')),
                );
              }
            },
            child: Text('Submit'),
          ),
        ],
      ),
    );
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }
}

Important Notes

Always use a Form widget to group TextFormField widgets for validation.

Use TextEditingController to read or change the text programmatically.

Remember to dispose the controller in dispose() to avoid memory leaks.

Summary

TextFormField lets users type and edit text in your app.

Use decoration to add labels and hints for better user guidance.

Use validator inside a Form to check user input before saving.

Practice

1. What is the main purpose of a TextFormField widget in Flutter?

easy

A. To let users type and edit text input

B. To display images in the app

C. To create buttons for user interaction

D. To navigate between screens

Solution

1. Step 1: Understand the widget's role

   TextFormField is designed to accept text input from users.

2. Step 2: Compare with other widget functions

   Other widgets like Image or ElevatedButton serve different purposes, not text input.

3. Final Answer:

   To let users type and edit text input -> Option A

4. Quick Check:

   Text input = TextFormField [OK]

Hint: TextFormField is for typing text only [OK]

Common Mistakes:

• Confusing TextFormField with buttons or images
• Thinking it handles navigation
• Assuming it only displays static text

2. Which of the following is the correct way to add a label inside a TextFormField?

easy

A. TextFormField(labelText: 'Name')

B. TextFormField(hint: 'Name')

C. TextFormField(decoration: InputDecoration(labelText: 'Name'))

D. TextFormField(text: 'Name')

Solution

1. Step 1: Recall how decoration works

   Labels and hints are added inside the decoration property using InputDecoration.

2. Step 2: Check each option's syntax

   Only TextFormField(decoration: InputDecoration(labelText: 'Name')) correctly uses decoration: InputDecoration(labelText: 'Name').

3. Final Answer:

   TextFormField(decoration: InputDecoration(labelText: 'Name')) -> Option C

4. Quick Check:

   Label goes inside decoration [OK]

Hint: Use decoration with InputDecoration for labels [OK]

Common Mistakes:

• Putting labelText directly on TextFormField
• Using hint instead of labelText for labels
• Confusing text property with label

3. What will happen when the following Flutter code runs and the user submits an empty form?

final _formKey = GlobalKey<FormState>();

Form(
  key: _formKey,
  child: TextFormField(
    validator: (value) {
      if (value == null || value.isEmpty) {
        return 'Please enter text';
      }
      return null;
    },
  ),
)

medium

A. The form submits successfully without errors

B. The app crashes due to missing onSaved callback

C. The TextFormField clears automatically

D. The validator returns 'Please enter text' and shows an error

Solution

1. Step 1: Understand validator behavior

   The validator checks if the input is empty and returns an error message if true.

2. Step 2: Analyze empty input case

   If the user submits empty text, the validator returns 'Please enter text', showing an error below the field.

3. Final Answer:

   The validator returns 'Please enter text' and shows an error -> Option D

4. Quick Check:

   Empty input triggers validator error [OK]

Hint: Empty input triggers validator error message [OK]

Common Mistakes:

• Assuming form submits without validation
• Thinking missing onSaved causes crash
• Believing TextFormField clears on submit

4. Identify the error in this Flutter code snippet using TextFormField:

TextFormField(
  validator: (value) {
    if (value.isEmpty) {
      return 'Required';
    }
    return null;
  },
)

medium

A. Validator should return a boolean, not a string

B. Missing null check for value before calling isEmpty

C. TextFormField requires an onChanged callback

D. Validator cannot be used without a Form widget

Solution

1. Step 1: Check validator parameter type

   The validator receives a nullable String? value, so it can be null.

2. Step 2: Identify missing null check

   The code calls value.isEmpty without checking if value is null, causing a runtime error.

3. Final Answer:

   Missing null check for value before calling isEmpty -> Option B

4. Quick Check:

   Always check for null before isEmpty [OK]

Hint: Check for null before using isEmpty on value [OK]

Common Mistakes:

• Ignoring nullable value in validator
• Expecting validator to return boolean
• Thinking onChanged is mandatory

5. You want to create a form with a TextFormField that only accepts numbers and shows a hint 'Enter age'. Which code snippet correctly implements this?

hard

A. TextFormField(
keyboardType: TextInputType.number,
decoration: InputDecoration(hintText: 'Enter age'),
validator: (value) {
if (value == null || value.isEmpty) return 'Age required';
if (int.tryParse(value) == null) return 'Enter a valid number';
return null;
},
)

B. TextFormField(
keyboardType: TextInputType.text,
decoration: InputDecoration(labelText: 'Enter age'),
validator: (value) => null,
)

C. TextFormField(
decoration: InputDecoration(hintText: 'Enter age'),
validator: (value) {
if (value!.isEmpty) return 'Age required';
return null;
},
)

D. TextFormField(
keyboardType: TextInputType.number,
decoration: InputDecoration(hintText: 'Age'),
validator: (value) {
if (value == null) return 'Age required';
return null;
},
)

Solution

1. Step 1: Identify required properties for numeric input with hint

   The correct implementation requires keyboardType: TextInputType.number, decoration: InputDecoration(hintText: 'Enter age'), and a validator checking for null/empty and valid integer parse.

2. Step 2: Verify validator handles all cases

   Validator must return error for null, empty, or non-numeric input using if (value == null || value.isEmpty) and int.tryParse(value) == null.

3. Final Answer:

   TextFormField( keyboardType: TextInputType.number, decoration: InputDecoration(hintText: 'Enter age'), validator: (value) { if (value == null || value.isEmpty) return 'Age required'; if (int.tryParse(value) == null) return 'Enter a valid number'; return null; }, ) -> Option A

4. Quick Check:

   number keyboard + exact hint + null/empty/parse validator [OK]

Hint: Use keyboardType.number and validate parsing for numbers [OK]

Common Mistakes:

• Using text keyboard for numeric input
• Not validating numeric format
• Confusing hintText and labelText