ZenUpdater<T extends ZenController> class

A widget that rebuilds when its controller calls ZenController.update.

Resolves the controller via the widget tree (context.controller<T>() — nearest ZenProvider first, then global DI). Completely multi-instance safe: each ZenUpdater independently resolves from its own tree position.

Fail-fast

If the controller is not found and no onError handler is provided, the exception propagates through Flutter's error handling. Provide onError to show a fallback widget instead.

Selective rebuilds

Use id to register for selective updates:

// Controller side:
controller.update(['counter']); // Only notifies listeners with id='counter'

// Widget side:
ZenUpdater<CounterController>(
  id: 'counter',
  builder: (context, ctrl) => Text('${ctrl.count}'),
)

Inheritance

Constructors

ZenUpdater({Key? key, required Widget builder(BuildContext context, T controller), String? tag, String? id, Widget onError(Object error)?}): const

Properties

builder → Widget Function(BuildContext context, T controller): Builder function that receives the resolved controller.
final
hashCode → int: The hash code for this object.
no setterinherited
id → String?: Optional update ID for selective rebuilds. When set, this widget only rebuilds when ZenController.update is called with a matching ID.
final
key → Key?: Controls how one widget replaces another widget in the tree.
finalinherited
onError → Widget Function(Object error)?: Optional error handler. When provided, renders this widget if the controller cannot be found or if the builder throws. When not provided, the error propagates to Flutter's error handling system.
final
runtimeType → Type: A representation of the runtime type of the object.
no setterinherited
tag → String?: Optional tag for finding the controller (disambiguates multiple instances).
final

Methods

createElement() → StatefulElement: Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<ZenUpdater<T>>: Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() → List<DiagnosticsNode>: Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void: Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic: Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode: Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String: A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String: Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String: Returns a one-line detailed description of the object.
inherited
toStringShort() → String: A short, textual description of this widget.
inherited

Operators

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