TextField and TextEditingController in Flutter

Introduction

We use TextField to let users type text in apps. TextEditingController helps us read or change that text easily.

When you want to get user input like name or email.

When you want to show typed text somewhere else in real time.

When you want to clear or set text programmatically.

When you want to listen to changes in the text field.

Syntax

Flutter

final controller = TextEditingController();

TextField(
  controller: controller,
  decoration: InputDecoration(
    labelText: 'Enter text',
  ),
)

The controller connects the TextField to your code.

Always dispose the controller when no longer needed to free resources.

Examples

A simple text field for entering a name.

Flutter

final nameController = TextEditingController();

TextField(
  controller: nameController,
  decoration: InputDecoration(labelText: 'Name'),
)

Text field with initial text set.

Flutter

final emailController = TextEditingController(text: '[e-mail]');

TextField(
  controller: emailController,
  decoration: InputDecoration(labelText: 'Email'),
)

Set text programmatically before showing the field.

Flutter

final messageController = TextEditingController();

messageController.text = 'Hello!';

TextField(
  controller: messageController,
  decoration: InputDecoration(labelText: 'Message'),
)

Sample App

This app shows a text field where you can type your name. Below it, the typed text appears live. Pressing the Clear button empties the field and the displayed text.

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('TextField Example')),
        body: Padding(
          padding: EdgeInsets.all(16),
          child: NameInputWidget(),
        ),
      ),
    );
  }
}

class NameInputWidget extends StatefulWidget {
  @override
  _NameInputWidgetState createState() => _NameInputWidgetState();
}

class _NameInputWidgetState extends State<NameInputWidget> {
  final TextEditingController _controller = TextEditingController();
  String _displayText = '';

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

  @override
  Widget build(BuildContext context) {
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        TextField(
          controller: _controller,
          decoration: InputDecoration(labelText: 'Enter your name'),
          onChanged: (text) {
            setState(() {
              _displayText = text;
            });
          },
        ),
        SizedBox(height: 20),
        Text('You typed: $_displayText'),
        SizedBox(height: 20),
        ElevatedButton(
          onPressed: () {
            _controller.clear();
            setState(() {
              _displayText = '';
            });
          },
          child: Text('Clear'),
        ),
      ],
    );
  }
}

Important Notes

Always call dispose() on your TextEditingController in dispose() method of your widget to avoid memory leaks.

You can listen to text changes with onChanged or by adding a listener to the controller.

Use controller.text to get or set the current text.

Summary

TextField lets users type text.

TextEditingController connects your code to the text field.

You can read, set, clear, and listen to text changes easily.

Practice

1. What is the main purpose of a TextEditingController in Flutter when used with a TextField?

easy

A. To read, set, and listen to the text input in the TextField

B. To style the TextField with colors and fonts

C. To handle button clicks inside the TextField

D. To navigate between different screens

Solution

1. Step 1: Understand TextEditingController role

   TextEditingController connects your code to the TextField's text, allowing you to read or change it.

2. Step 2: Compare with other options

   Styling, button clicks, and navigation are unrelated to TextEditingController's main function.

3. Final Answer:

   To read, set, and listen to the text input in the TextField -> Option A

4. Quick Check:

   TextEditingController manages text content [OK]

Hint: Remember: Controller manages text, not style or navigation [OK]

Common Mistakes:

• Confusing controller with styling properties
• Thinking controller handles button clicks
• Assuming controller manages navigation

2. Which of the following is the correct way to create a TextEditingController and assign it to a TextField in Flutter?

easy

A. final controller = TextFieldController();
TextField(controller: controller);

B. final controller = TextEditingController();
TextField(controller: controller);

C. final controller = TextEditingController();
TextField(textController: controller);

D. final controller = TextEditingController();
TextField(control: controller);

Solution

1. Step 1: Check correct class name and usage

   The correct class is TextEditingController and the TextField property is controller.

2. Step 2: Verify options

   final controller = TextEditingController(); TextField(controller: controller); uses correct class and property names. Options A, C, and D have wrong class or property names.

3. Final Answer:

   final controller = TextEditingController();\nTextField(controller: controller); -> Option B

4. Quick Check:

   Use TextEditingController and controller property [OK]

Hint: Remember exact names: TextEditingController and controller [OK]

Common Mistakes:

• Using wrong class name like TextFieldController
• Using wrong property names like textController or control
• Forgetting to assign controller to TextField

3. Consider this Flutter code snippet:

final controller = TextEditingController(text: 'Hello');

TextField(controller: controller);

print(controller.text);

What will be printed in the console?

medium

A. Hello

B. null

C. Empty string

D. Error: controller.text not set

Solution

1. Step 1: Check initial text in controller

   The controller is created with initial text 'Hello'.

2. Step 2: Understand controller.text value

   controller.text returns the current text, which is 'Hello' initially.

3. Final Answer:

   Hello -> Option A

4. Quick Check:

   Initial text in controller.text is 'Hello' [OK]

Hint: Initial text in controller.text is what prints [OK]

Common Mistakes:

• Assuming controller.text is null if not typed
• Thinking print shows empty string by default
• Expecting error without user input

4. What is wrong with this Flutter code snippet?

final controller = TextEditingController();

TextField(controller: controller);

controller.dispose();

Choose the best explanation.

medium

A. TextField requires controller to be final, so this code is invalid

B. TextEditingController cannot be assigned to TextField controller property

C. Calling dispose() immediately after creating controller causes errors when TextField uses it

D. dispose() should be called before creating the controller

Solution

1. Step 1: Understand dispose() usage

   dispose() frees resources and should be called when controller is no longer needed, not immediately after creation.

2. Step 2: Analyze code behavior

   Calling dispose() right after creation means TextField tries to use a disposed controller, causing errors.

3. Final Answer:

   Calling dispose() immediately after creating controller causes errors when TextField uses it -> Option C

4. Quick Check:

   Dispose only after widget lifecycle ends [OK]

Hint: Dispose controllers only when widget is disposed [OK]

Common Mistakes:

• Calling dispose() too early
• Confusing dispose() timing
• Thinking dispose() is needed before creation

5. You want to clear the text inside a TextField when a button is pressed. Which code snippet correctly achieves this using TextEditingController?

hard

A. final controller = TextEditingController();

ElevatedButton(onPressed: () {
controller.dispose();
}, child: Text('Clear'));

TextField(controller: controller);

B. final controller = TextEditingController();

ElevatedButton(onPressed: () {
controller.text = null;
}, child: Text('Clear'));

TextField(controller: controller);

C. final controller = TextEditingController();

ElevatedButton(onPressed: () {
controller.reset();
}, child: Text('Clear'));

TextField(controller: controller);

D. final controller = TextEditingController();

ElevatedButton(onPressed: () {
controller.clear();
}, child: Text('Clear'));

TextField(controller: controller);

Solution

1. Step 1: Identify method to clear text

   TextEditingController has a clear() method to empty the text.

2. Step 2: Check other options for correctness

   Setting text to null causes error, dispose() frees resources (not clearing), reset() does not exist.

3. Final Answer:

   Use controller.clear() inside button onPressed to clear text -> Option D

4. Quick Check:

   Use clear() to empty TextField text [OK]

Hint: Use controller.clear() to empty text field quickly [OK]

Common Mistakes:

• Setting controller.text to null (causes error)
• Calling dispose() instead of clear()
• Using non-existent reset() method