Brzi API pregled za svakodnevni rad.

Ova stranica sažima najčešće korištene klase i metode iz datoteka miniriverpod_core.dart i miniriverpod_flutter.dart.

Osnovni tipovi

Osnovno stanje i provider primitivni elementi.

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

Sinkroni provider s opcionalnim autoDisposeom

AsyncProvider<T>

Asinkroni provider s .future selektorom

Savjet za čitanje

AsyncValue ne uključuje when metodu; koristite switch pattern matching ili is provjere.

Metode Ref-a i ProviderContainera

Uobičajene operativne metode za osvježavanje, poništavanje, životni ciklus i izvršavanje mutacija.

Uobičajen niz

Mapa metoda

read / watch / listen                 : čitaj i pretplati se na providere.
invalidate / refresh / refreshValue    : ponovno izračunaj stanje.
onDispose / keepAlive / emit           : životni ciklus i povezivanje streama.
mutation / mutate / invoke             : praćene operacije pisanja.
scope / overrideWithValue              : DI i testni overridei.

Pregled Flutter API-ja

Ulazne točke ProviderScope i WidgetRef koriste se u kodu aplikacije.

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

// Izvršavanje mutacije
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) zahtijeva ručno pozivanje container.dispose().
UncontrolledProviderScope nikad ne disposea umetnuti container.
Consumer, ConsumerWidget i ConsumerStatefulWidget svi su podržani.

Sljedeći koraci

Provideri

Vratite se praktičnoj upotrebi Providera, AsyncProvidera i read API-ja.

Otvori providere

Mutacije

Uvedite eksplicitne tokove pisanja s kontrolom konkurentnosti.

Otvori mutacije