ChangeNotifierProvider<T extends ChangeNotifier?> class

Provides a ChangeNotifier T, as ListenableProvider provides a listenable: the notifier create makes is disposed of when this widget leaves the tree; one given to ChangeNotifierProvider.value is not.

A cart the app's widgets add to and show, made with the app and disposed of with it:

ChangeNotifierProvider(
  create: (context) => Cart(),
  child: Builder(
    builder: (context) => KeyBindings({
      'a': () => context.read<Cart>().add('tea'),
    }, child: Text('${context.watch<Cart>().items.length} items')),
  ),
)
Inheritance

Constructors

ChangeNotifierProvider({required Create<T> create, Key? key, bool? lazy, TransitionBuilder? builder, Widget? child})
Provides the notifier create makes, disposed of when this widget leaves the tree.
ChangeNotifierProvider.value({required T value, Key? key, TransitionBuilder? builder, Widget? child})
Provides value, a notifier made and disposed of elsewhere.

Properties

builder → TransitionBuilder?
Builds the child below this provider, from the one given.
finalinherited
hashCode → int
The hash code for this object.
no setterinherited
key → Key?
Tells this widget apart from its siblings; see Key.
finalinherited
lazy → bool
Whether the value is made only when it is first read; else when this widget is placed in the tree.
finalinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

build(BuildContext context) → Widget
Describes this part of the interface; called when the widget is placed in the tree, whenever its parent gives it a new widget, and when its element is marked dirty.
inherited
buildWithChild(BuildContext context, Widget? child) → Widget
What this widget shows around child.
inherited
createElement() → StatelessElement
Inflates this widget into a new element for the tree.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Adds what describes this widget in its element's description (Element.describe) to properties, those not worth showing (a default) left out; an override calls this first. A render object widget adds only what its render object does not show. Only Element.describe calls it: a frame never does.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited