Rýchla referencia API pre každodennú prácu.
Táto stránka zhrňuje často používané triedy a metódy z miniriverpod_core.dart a miniriverpod_flutter.dart.
Jadrové typy
Jadrové stavebné prvky stavu a providerov.
AsyncValue<T>
AsyncLoading / AsyncData / AsyncError
Provider<T>
Synchrónny provider s voliteľným autoDispose
AsyncProvider<T>
Asynchrónny provider so selektorom .future
Tip na čítanie
AsyncValue neobsahuje metódu when; použite switch pattern matching alebo kontroly is.
Metódy Ref a ProviderContainer
Bežné operačné metódy na obnovu, zneplatnenie, životný cyklus a vykonávanie mutácií.
Bežná sekvencia
Mapa metód
read / watch / listen : čítajte a odoberajte si providery.
invalidate / refresh / refreshValue : prepočítajte stav.
onDispose / keepAlive / emit : prepojenie životného cyklu a streamu.
mutation / mutate / invoke : sledované operácie zápisu.
scope / overrideWithValue : DI a testovacie overridey.
Prehľad Flutter API
Vstupné body ProviderScope a WidgetRef používané v kóde aplikácie.
// Rozsah
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');
}
}
// Vykonanie mutácie
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) vyžaduje ručné volanie container.dispose().
UncontrolledProviderScope nikdy neuvoľní injektovaný container.
Consumer, ConsumerWidget a ConsumerStatefulWidget sú podporované.
Ďalšie kroky
Providers
Vráťte sa k praktickému používaniu Provider, AsyncProvider a API na čítanie.
Otvoriť Providers