flutter_solidart 0.4.2

flutter_solidart: ^0.4.2 copied to clipboard

Add update extension on BuildContext. It's a convenience method to update a Signal value.

You can use it to update a signal value, e.g:

context.update<int>('counter', (value) => value * 2);

This is equal to:

// retrieve the signal
final signal = context.get<Signal<int>>('counter');
// update the signal
signal.update((value) => value * 2);

but shorter when you don't need the signal for anything else.

Now Solid can deal also with SolidProviders. You no longer need an external dependency injector library. I decided to put some boundaries and stop suggesting any external dependency injector library. This choice is due to the fact that external libraries in turn provide state management and the user is more likely to mistakenly use solidart. I simplified the usage of InheritedWidgets with a very nice API:

Declare providers #

Solid(
      providers: [
        SolidProvider<NameProvider>(
          create: () => const NameProvider('Ale'),
          // the dispose method is fired when the [Solid] widget above is removed from the widget tree.
          dispose: (provider) => provider.dispose(),
        ),
        SolidProvider<NumberProvider>(
          create: () => const NumberProvider(1),
          // Do not create the provider lazily, but immediately
          lazy: false,
        ),
      ],
      child: const SomeChildThatNeedsProviders(),
  )

Retrieve providers #

final nameProvider = context.get<NameProvider>();
final numberProvider = context.get<NumberProvider>();

Provide providers to modals (dialogs, bottomsheets) #

  return showDialog(
    context: context,
    builder: (dialogContext) => Solid.value(
      // pass a context that has access to providers
      context: context,
      // pass the list of provider [Type]s
      providerTypes: const [NameProvider],
      child: Dialog(
        child: Builder(builder: (innerContext) {
          // retrieve the provider with the innerContext
          final nameProvider = innerContext.get<NameProvider>();
          return SizedBox.square(
            dimension: 100,
            child: Center(
              child: Text('name: ${nameProvider.name}'),
            ),
          );
        }),
      ),
    ),
  );

You cannot provide multiple providers of the same type in the same Solid widget.

// before
final resource = createResource<SourceValueType, FetcherValueType>(fetcher: fetcher, source: source);
// now
final resource = createResource<FetcherValueType>(fetcher: fetcher, source: source); // the FetcherValueType can be inferred by Dart >=2.18.0, so you can omit it