Consultare rapidă a API-ului pentru munca de zi cu zi.

Această pagină rezumă clasele și metodele utilizate frecvent din miniriverpod_core.dart și miniriverpod_flutter.dart.

Tipuri de bază

Primitivele de bază pentru stare și provideri.

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

Provider sincron cu autoDispose opțional

AsyncProvider<T>

Provider asincron cu selectorul .future

Sfat de lectură

AsyncValue nu include metoda when; folosiți switch pattern matching sau verificări is.

Metodele Ref și ProviderContainer

Metode operaționale comune pentru reîmprospătare, invalidare, ciclu de viață și executarea mutațiilor.

Secvență comună

Harta metodelor

read / watch / listen                 : citește și abonează-te la provideri.
invalidate / refresh / refreshValue    : recalculează starea.
onDispose / keepAlive / emit           : legături pentru ciclul de viață și stream.
mutation / mutate / invoke             : operații de scriere urmărite.
scope / overrideWithValue              : DI și suprascrieri pentru testare.

Rezumat API Flutter

Punctele de intrare ProviderScope și WidgetRef folosite în codul aplicației.

// Scope
ProviderScope(
  child: const App(),
);

// ConsumerWidget
class Header extends ConsumerWidget {
  const Header({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final user = ref.watch(currentUser);
    return Text('$user');
  }
}

// Mutation execution
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) necesită apelarea manuală a container.dispose().
UncontrolledProviderScope nu eliberează niciodată containerul injectat.
Consumer, ConsumerWidget și ConsumerStatefulWidget sunt toate acceptate.

Pașii următori

Providers

Reveniți la utilizarea practică a API-urilor Provider, AsyncProvider și read.

Deschide Providers

Mutations

Implementați fluxuri de scriere explicite cu controlul concurenței.

Deschide Mutations