Flutter Mobile Development · Lesson

setState & InheritedWidget

Grasp the basics of local state management with `setState` and understand the concept of `InheritedWidget` for passing data down the widget tree.

setState & InheritedWidget is a free Flutter Mobile Development lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Flutter Mobile Development learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

What is State Management?

In Flutter, 'state' refers to any data that can change during the lifetime of a widget. This could be a counter value, user input, or data fetched from the internet.

Managing this changing data, or 'state,' is crucial for building dynamic and interactive mobile applications. We need ways to update the UI when data changes.

Local State with setState

For changes that only affect a single widget, or a small, self-contained part of it, setState is your primary tool. It's used within a StatefulWidget.

Calling setState(() { ... }); tells Flutter that the internal state of this widget has changed and that it needs to rebuild its UI to reflect the new data.

setState in Action: Counter App

Let's build a simple counter. Notice how calling _incrementCounter() updates the _counter variable inside setState, which then triggers the UI to rebuild and show the new count.

import 'package:flutter/material.dart';

class MyCounterApp extends StatefulWidget {
  @override
  _MyCounterAppState createState() => _MyCounterAppState();
}

class _MyCounterAppState extends State<MyCounterApp> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('setState Counter')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('You have pushed the button this many times:'),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: Icon(Icons.add),
      ),
    );
  }
}

void main() {
  runApp(MaterialApp(home: MyCounterApp()));
}

How setState Triggers Rebuilds

When setState is called, Flutter marks the StatefulWidget as 'dirty' and schedules a rebuild for that widget and its descendants.

Crucially, setState only rebuilds the part of the widget tree rooted at the StatefulWidget where it was called, not the entire application. This helps keep your UI updates efficient.

Limitations: The Problem of Prop Drilling

While setState is great for local state, it becomes cumbersome when you need to share state with widgets deep down the tree.

Passing data through many intermediate widgets that don't actually need it is called 'prop drilling'. It makes code harder to read, maintain, and refactor.

Introducing InheritedWidget

InheritedWidget is a special type of widget designed to efficiently pass data down the widget tree. Any child widget, no matter how deep, can access the data provided by an InheritedWidget.

This solves the 'prop drilling' problem by allowing widgets to 'inherit' data from their ancestors without explicit passing.

Building an InheritedWidget

To create an InheritedWidget, you extend the base class and define the data you want to share. It always requires a child widget, which is the subtree that can access its data.

child: The widget subtree wrapped by this InheritedWidget.
updateShouldNotify: A crucial method that tells Flutter if dependent widgets need to rebuild when the InheritedWidget's data changes.

import 'package:flutter/material.dart';

class MyThemeData extends InheritedWidget {
  final Color primaryColor;

  const MyThemeData({
    Key? key,
    required this.primaryColor,
    required Widget child,
  }) : super(key: key, child: child);

  @override
  bool updateShouldNotify(MyThemeData oldWidget) {
    // Return true if the data has changed, 
    // so dependents rebuild.
    return oldWidget.primaryColor != primaryColor;
  }
}

Accessing InheritedWidget Data

Child widgets retrieve data from an InheritedWidget using a static of(BuildContext context) method. This method efficiently searches up the widget tree for the nearest instance of the specified InheritedWidget.

The context.dependOnInheritedWidgetOfExactType() method is commonly used within the of() method to establish a dependency.

import 'package:flutter/material.dart';

// Assume MyThemeData InheritedWidget is defined elsewhere.
// It needs a static 'of' method:
// static MyThemeData? of(BuildContext context) {
//   return context.dependOnInheritedWidgetOfExactType<MyThemeData>();
// }

class MyColorDisplay extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // Accessing the InheritedWidget's data using its 'of' method
    final theme = MyThemeData.of(context); 

    return Text(
      'Current color: ${theme?.primaryColor ?? 'Default'}' ,
      style: TextStyle(color: theme?.primaryColor ?? Colors.black),
    );
  }
}

Full InheritedWidget Example

Here's a complete example showing how MyThemeData provides a primary color to a deeply nested MyColorDisplay widget. Notice how MyColorDisplay accesses the data directly via MyThemeData.of(context).

import 'package:flutter/material.dart';

// 1. Our custom InheritedWidget
class MyThemeData extends InheritedWidget {
  final Color primaryColor;

  const MyThemeData({
    Key? key,
    required this.primaryColor,
    required Widget child,
  }) : super(key: key, child: child);

  static MyThemeData? of(BuildContext context) {
    return context.dependOnInheritedWidgetOfExactType<MyThemeData>();
  }

  @override
  bool updateShouldNotify(MyThemeData oldWidget) {
    return oldWidget.primaryColor != primaryColor;
  }
}

// 2. A widget that consumes the data
class MyColorDisplay extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final theme = MyThemeData.of(context);
    return Container(
      padding: EdgeInsets.all(16.0),
      decoration: BoxDecoration(
        color: theme?.primaryColor ?? Colors.grey,
        borderRadius: BorderRadius.circular(8.0),
      ),
      child: Text(
        'Color Box',
        style: TextStyle(color: Colors.white, fontSize: 18),
      ),
    );
  }
}

// 3. The main app structure
class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('InheritedWidget App')),
        body: MyThemeData( // Providing the theme data
          primaryColor: Colors.deepPurple,
          child: Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Text('Data provided by InheritedWidget:'),
                SizedBox(height: 20),
                MyColorDisplay(), // This widget consumes the data
                SizedBox(height: 20),
                Text('This text is also a child.'),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

void main() {
  runApp(MyApp());
}

setState vs. InheritedWidget

When to use which?

setState: Ideal for local, internal state changes within a single StatefulWidget. Simple and direct.
InheritedWidget: Best for sharing data efficiently with multiple widgets deep in the tree, avoiding 'prop drilling'. It's a foundational pattern for more advanced state management solutions.

They solve different problems but are both fundamental to Flutter's state management.

Quick Check: State Management

Consider the following scenarios for managing state in a Flutter application. Which statement accurately describes the primary use case for setState versus InheritedWidget?

Recap: setState & InheritedWidget

Congratulations! You've grasped two core concepts of state management in Flutter:

setState: For managing local, internal state changes within a StatefulWidget.
InheritedWidget: For efficiently sharing data with widgets deep in the tree, avoiding 'prop drilling'.

These foundational patterns are key to building responsive and maintainable Flutter applications. You're now ready to explore more advanced state management solutions!

Frequently asked questions

Is the “setState & InheritedWidget” lesson free?

Yes — the full text of “setState & InheritedWidget” is free to read here on the web, and the Flutter Mobile Development course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Flutter Mobile Development course, upgrade to CoddyKit PRO.

What will I learn in “setState & InheritedWidget”?

Grasp the basics of local state management with `setState` and understand the concept of `InheritedWidget` for passing data down the widget tree. You practise Flutter Mobile Development with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Flutter Mobile Development?

No prior experience is required. Flutter Mobile Development on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “setState & InheritedWidget” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Flutter Mobile Development lesson?

Yes. Every Flutter Mobile Development lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to Flutter Mobile Development