Error display patterns in Flutter

Introduction

Showing errors clearly helps users understand what went wrong and how to fix it. It makes apps friendlier and easier to use.

When a user enters wrong information in a form field.

When the app fails to load data from the internet.

When a required permission is denied by the user.

When a button action cannot complete due to missing input.

When a background process encounters a problem.

Syntax

Flutter

Text('Error message', style: TextStyle(color: Colors.red))

// Or use Flutter's built-in widgets like SnackBar or AlertDialog to show errors.

Use red color or icons to highlight errors visually.

Keep error messages short and clear.

Examples

Shows a simple red error message below a form field.

Flutter

Text('Please enter a valid email', style: TextStyle(color: Colors.red))

Displays a temporary message at the bottom of the screen.

Flutter

ScaffoldMessenger.of(context).showSnackBar(
  SnackBar(content: Text('Failed to load data'))
);

Shows a popup dialog to alert the user about an error.

Flutter

showDialog(
  context: context,
  builder: (context) => AlertDialog(
    title: Text('Error'),
    content: Text('Network connection lost'),
    actions: [
      TextButton(onPressed: () => Navigator.pop(context), child: Text('OK'))
    ],
  ),
);

Sample App

This app shows a text field for email input. When you press Submit, it checks if the field is empty or missing '@'. If there is an error, it shows a red error message below the field. If input is valid, it shows a SnackBar message.

Flutter

import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Error Display Example')),
        body: const ErrorExample(),
      ),
    );
  }
}

class ErrorExample extends StatefulWidget {
  const ErrorExample({super.key});

  @override
  State<ErrorExample> createState() => _ErrorExampleState();
}

class _ErrorExampleState extends State<ErrorExample> {
  final TextEditingController _controller = TextEditingController();
  String? _errorText;

  void _validate() {
    setState(() {
      if (_controller.text.isEmpty) {
        _errorText = 'This field cannot be empty';
      } else if (!_controller.text.contains('@')) {
        _errorText = 'Please enter a valid email';
      } else {
        _errorText = null;
        ScaffoldMessenger.of(context).showSnackBar(
          const SnackBar(content: Text('Input is valid!'))
        );
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.all(16),
      child: Column(
        children: [
          TextField(
            controller: _controller,
            decoration: InputDecoration(
              labelText: 'Email',
              errorText: _errorText,
            ),
            keyboardType: TextInputType.emailAddress,
          ),
          const SizedBox(height: 20),
          ElevatedButton(
            onPressed: _validate,
            child: const Text('Submit'),
          ),
        ],
      ),
    );
  }
}

Important Notes

Use errorText property in InputDecoration to show inline errors in text fields.

SnackBars are good for short, temporary messages that do not block user actions.

Dialogs should be used sparingly for important errors that need user acknowledgment.

Summary

Show errors clearly using red text or icons.

Use inline error messages for form fields with errorText.

Use SnackBar for brief messages and AlertDialog for important alerts.

Practice

1. What is the best way to show an error message for a text input field in Flutter?

easy

A. Show a SnackBar without any text input changes

B. Use the errorText property in InputDecoration of TextField

C. Use a Container with red background below the field

D. Change the TextField font size to smaller

Solution

1. Step 1: Understand Flutter form error display

   Flutter provides errorText in InputDecoration to show inline error messages below text fields.

2. Step 2: Compare options for error display

   Using errorText is the standard and clear way. SnackBar is for brief messages, Container with red background is not standard, and font size change does not convey error.

3. Final Answer:

   Use the errorText property in InputDecoration of TextField -> Option B

4. Quick Check:

   Inline error message = errorText [OK]

Hint: Use errorText for inline field errors [OK]

Common Mistakes:

• Using SnackBar for field errors
• Changing font size to indicate error
• Adding unrelated colored containers

2. Which Flutter widget is used to show a brief message at the bottom of the screen for errors?

easy

A. SnackBar

B. AlertDialog

C. Tooltip

D. Dialog

Solution

1. Step 1: Identify widget for brief messages

   SnackBar is designed to show short messages at the bottom of the screen temporarily.

2. Step 2: Differentiate from other widgets

   AlertDialog and Dialog are modal dialogs requiring user action. Tooltip shows hints on hover or long press, not error messages.

3. Final Answer:

   SnackBar -> Option A

4. Quick Check:

   Brief bottom message = SnackBar [OK]

Hint: SnackBar shows quick messages at screen bottom [OK]

Common Mistakes:

• Confusing AlertDialog with SnackBar
• Using Tooltip for error messages
• Using Dialog without user action

3. What will happen if you run this Flutter code snippet?

ScaffoldMessenger.of(context).showSnackBar(
  SnackBar(content: Text('Error occurred!'))
);

medium

A. A red error dialog appears in the center

B. App crashes due to missing AlertDialog

C. A brief message 'Error occurred!' appears at the bottom

D. Nothing happens because SnackBar needs a Scaffold

Solution

1. Step 1: Understand SnackBar usage with ScaffoldMessenger

   Using ScaffoldMessenger.of(context).showSnackBar() correctly shows a SnackBar message at the bottom of the screen.

2. Step 2: Analyze the code behavior

   The SnackBar with text 'Error occurred!' will appear briefly at the bottom. It does not show a dialog or crash.

3. Final Answer:

   A brief message 'Error occurred!' appears at the bottom -> Option C

4. Quick Check:

   ScaffoldMessenger.showSnackBar = brief message at bottom [OK]

Hint: SnackBar shows text at bottom, not dialog [OK]

Common Mistakes:

• Thinking SnackBar is a dialog
• Assuming SnackBar needs AlertDialog
• Believing SnackBar causes crash

4. You want to show an error alert dialog in Flutter but your code throws an exception. Which is the likely cause?

showDialog(
  context: context,
  builder: (context) => AlertDialog(
    title: Text('Error'),
    content: Text('Something went wrong'),
  ),
);

medium

A. Using showDialog without a valid context

B. Not wrapping AlertDialog in a MaterialApp

C. Missing Navigator.pop(context) to close dialog

D. AlertDialog requires a SnackBar inside

Solution

1. Step 1: Check context usage in showDialog

   showDialog requires a valid BuildContext from a widget tree that includes a MaterialApp or WidgetsApp.

2. Step 2: Identify common error cause

   Passing an invalid or null context causes exceptions. Missing Navigator.pop only affects closing, not showing. AlertDialog does not require SnackBar.

3. Final Answer:

   Using showDialog without a valid context -> Option A

4. Quick Check:

   Valid context needed for showDialog [OK]

Hint: Always pass valid context to showDialog [OK]

Common Mistakes:

• Forgetting to provide valid context
• Confusing SnackBar with AlertDialog requirements
• Not handling dialog dismissal

5. You want to display multiple form field errors and a general error alert in Flutter. Which approach correctly combines inline errors and an alert dialog?

hard

A. Change field colors to red and show no dialogs

B. Show all errors only in a SnackBar at the bottom

C. Use AlertDialog for each field error and ignore inline errors

D. Use errorText for each field and show an AlertDialog for general errors

Solution

1. Step 1: Understand error display roles

   Inline errors for fields use errorText to show specific issues. General errors affecting the whole form use AlertDialog to grab attention.

2. Step 2: Evaluate options for combined error display

   Use errorText for each field and show an AlertDialog for general errors correctly uses inline errors for fields and an alert dialog for general errors. SnackBar is brief and not suitable for multiple detailed errors. Using AlertDialog for each field is disruptive. Changing colors alone is unclear.

3. Final Answer:

   Use errorText for each field and show an AlertDialog for general errors -> Option D

4. Quick Check:

   Inline errors + alert dialog [OK]

Hint: Combine errorText for fields and AlertDialog for general errors [OK]

Common Mistakes:

• Showing all errors only in SnackBar
• Using AlertDialog for each field error
• Ignoring inline error messages