ConsumerWidget class Null safety

A StatelessWidget that can listen to providers.

Using ConsumerWidget, this allows the widget tree to listen to changes on provider, so that the UI automatically updates when needed.

Do not modify any state or start any http request inside build.

As a usage example, consider:

final helloWorldProvider = Provider((_) => 'Hello world');

We can then subclass ConsumerWidget to listen to helloWorldProvider like so:

class Example extends ConsumerWidget {
  const Example({Key? key}): super(key: key);

  Widget build(BuildContext context, ScopedReader watch) {
    final value = watch(helloWorldProvider);
    return Text(value); // Hello world

Note You can watch as many providers inside build as you want to:

Widget build(BuildContext context, ScopedReader watch) {
  final value = watch(someProvider);
  final another = watch(anotherProvider);
  return Text(value); // Hello world

For reading providers inside a StatefulWidget or for performance optimizations, see Consumer.



ConsumerWidget({Key? key})
A StatelessWidget that can listen to providers. [...]


hashCode int
The hash code for this object. [...]
@nonVirtual, read-only, inherited
key Key?
Controls how one widget replaces another widget in the tree. [...]
final, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited


build(BuildContext context, ScopedReader watch) Widget
Describes the part of the user interface represented by this widget. [...]
createElement() StatefulElement
Creates a StatefulElement to manage this widget's location in the tree. [...]
createState() → _ConsumerState
Creates the mutable state for this widget at a given location in the tree. [...]
debugDescribeChildren() List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children. [...]
@protected, inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node. [...]
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep. [...]
toString({DiagnosticLevel minLevel =}) String
A string representation of this object. [...]
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a string representation of this node and its descendants. [...]
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a one-line detailed description of the object. [...]
toStringShort() String
A short, textual description of this widget.


operator ==(Object other) bool
The equality operator. [...]
@nonVirtual, inherited