Kiire API-viide igapäevatööks.

See leht võtab kokku miniriverpod_core.dart ja miniriverpod_flutter.dart sagedamini kasutatavad klassid ja meetodid.

Põhitüübid

Põhilised oleku- ja provideri primitiivid.

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

Sünkroonne provider valikulise autoDispose'iga

AsyncProvider<T>

Asünkroonne provider .future-valijaga

Lugemisnipp

AsyncValue ei sisalda when-meetodit; kasuta switch-mustris sobitamist või is-kontrolle.

Refi ja ProviderContaineri meetodid

Levinud toimingud värskendamiseks, kehtetuks tunnistamiseks, elutsükliks ja mutatsioonide käitamiseks.

Levinud järjestus

Meetodite kaart

read / watch / listen                 : providerite lugemine ja tellimine.
invalidate / refresh / refreshValue    : oleku ümberarvutamine.
onDispose / keepAlive / emit           : elutsükkel ja streami sidumine.
mutation / mutate / invoke             : jälgitavad kirjutustoimingud.
scope / overrideWithValue              : DI ja testimise override'id.

Flutteri API ülevaade

ProviderScope ja WidgetRef on rakenduse koodi kasutatavad sisenemispunktid.

// 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');
  }
}

// Mutatsiooni käitamine
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) nõuab container.dispose() käsitsi väljakutsumist.
UncontrolledProviderScope ei tee sisestatud konteinerile kunagi dispose'i.
Consumer, ConsumerWidget ja ConsumerStatefulWidget on kõik toetatud.

Järgmised sammud

Providerid

Naase Provideri, AsyncProvideri ja read-APIde praktilise kasutuse juurde.

Ava providerid

Mutatsioonid

Rakenda selged kirjutusvood koos samaaegsuse juhtimisega.

Ava mutatsioonid