Rask API-oversikt for daglig arbeid.
Denne siden oppsummerer ofte brukte klasser og metoder fra miniriverpod_core.dart og miniriverpod_flutter.dart.
Kjernetyper
Kjerne-state og provider-primitiver.
AsyncValue<T>
AsyncLoading / AsyncData / AsyncError
Provider<T>
Synkron provider med valgfri autoDispose
AsyncProvider<T>
Asynkron provider med .future-selector
Lesetips
AsyncValue har ikke en when-metode; bruk switch-pattern matching eller is-sjekker.
Ref- og ProviderContainer-metoder
Vanlige operasjonsmetoder for refresh, invalidation, lifecycle og utføring av mutations.
Vanlig rekkefølge
Metodekart
read / watch / listen : les og abonner på providers.
invalidate / refresh / refreshValue : beregn state på nytt.
onDispose / keepAlive / emit : lifecycle- og streamkobling.
mutation / mutate / invoke : sporede skriveoperasjoner.
scope / overrideWithValue : DI- og testoverstyringer.
Flutter API-oversikt
Inngangspunktene ProviderScope og WidgetRef som brukes i appkoden.
// Skop
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');
}
}
// Utføring av mutation
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) krever at du kaller container.dispose() manuelt.
UncontrolledProviderScope kaller aldri dispose på den injiserte containeren.
Consumer, ConsumerWidget og ConsumerStatefulWidget støttes alle.