provider 3.2.0

provider: ^3.2.0 copied to clipboard

• Deprecated "builder" of providers in favor to "create"
• Deprecated "builder"/"initialBuilder" of proxy providers in favor of respectively "create" and "update"

• Added Selector, similar to Consumer but can filter unneeded updates
• improved the overall documentation
• fixed a bug where ChangeNotifierProvider.value didn't update dependents when the ChangeNotifier instance changed.
• Consumer can now be used inside MultiProvider

  MultiProvider(
    providers: [
      Provider(builder: (_) => Foo()),
      Consumer<Foo>(
        builder: (context, foo, child) =>
          Provider.value(value: foo.bar, child: child),
      )
    ],
  );
  

breaking (see the readme for migration steps): #

• Provider now throws if used with a Listenable/Stream. This can be disabled by setting Provider.debugCheckInvalidValueType to null.
• The default constructor of StreamProvider has now builds a Stream instead of StreamController. The previous behavior has been moved to StreamProvider.controller.
• All XXProvider.value constructors now use value as parameter name.
• Added FutureProvider, which takes a future and updates dependents when the future completes.
• Providers can no longer be instantiated using const constructors.

non-breaking: #

• Added ProxyProvider, ListenableProxyProvider, and ChangeNotifierProxyProvider. These providers allows building values that depends on other providers, without loosing reactivity or manually handling the state.
• Added DelegateWidget and a few related classes to help building custom providers.
• Exposed the internal generic InheritedWidget to help building custom providers.

• fix a bug where ListenableProvider.value/ChangeNotifierProvider.value /StreamProvider.value/ValueListenableProvider.value subscribed/unsubscribed to their respective object too often
• fix a bug where ListenableProvider.value/ChangeNotifierProvider.value may rebuild too often or skip some.

• Consumer now takes an optional child argument for optimization purposes.
• merged Provider and StatefulProvider
• added a "builder" constructor to ValueListenableProvider
• normalized providers constructors such that the default constructor is a "builder", and offer a value named constructor.

• Provider.of<T> now crashes with a ProviderNotFoundException when no Provider<T> are found in the ancestors of the context used.

• new: ChangeNotifierProvider, similar to scoped_model that exposes ChangeNotifer subclass and rebuilds dependents only when notifyListeners is called.
• new: ValueListenableProvider, a provider that rebuilds whenever the value passed to a ValueNotifier change.

• new: Add Consumer with up to 6 parameters.
• new: MultiProvider, a provider that makes a tree of provider more readable
• new: StreamProvider, a stream that exposes to its descendants the current value of a Stream.

• Reintroduced StatefulProvider with a modified prototype. The second argument of valueBuilder and didChangeDependencies have been removed. And valueBuilder is now called only once for the whole life-cycle of StatefulProvider.

• Added Consumer, useful when we need to both expose and consume a value simultaneously.

• Added: HookProvider, a Provider that creates its value from a Hook.
• Deprecated StatefulProvider. Either make a StatefulWidget or use HookProvider.
• Integrated the widget inspector, so that Provider widget shows the current value.

• add didChangeDependencies callback to allow updating the value based on an InheritedWidget
• add updateShouldNotify method to both Provider and StatefulProvider

• onDispose has been added to StatefulProvider
• BuildContext is now passed to valueBuilder callback