Snelle API-referentie voor dagelijks werk.
Deze pagina vat veelgebruikte klassen en methoden uit miniriverpod_core.dart en miniriverpod_flutter.dart samen.
Kernentypen
Kernstate en provider-primitieven.
AsyncValue<T>
AsyncLoading / AsyncData / AsyncError
Provider<T>
Synchrone provider met optionele autoDispose
AsyncProvider<T>
Asynchrone provider met een .future-selector
Leestip
AsyncValue bevat geen when-methode; gebruik switch-pattern matching of is-controles.
Methoden van Ref en ProviderContainer
Veelgebruikte operationele methoden voor refresh, invalidation, lifecycle en de uitvoering van mutaties.
Veelgebruikte volgorde
Methodenoverzicht
read / watch / listen : lees en abonneer je op providers.
invalidate / refresh / refreshValue : bereken state opnieuw.
onDispose / keepAlive / emit : lifecycle- en streamkoppeling.
mutation / mutate / invoke : bijgehouden schrijfbewerkingen.
scope / overrideWithValue : DI- en testoverrides.
Flutter API-samenvatting
ProviderScope en WidgetRef als instappunten in app-code.
// 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-uitvoering
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) vereist dat je container.dispose() handmatig aanroept.
UncontrolledProviderScope roept nooit dispose aan op de geïnjecteerde container.
Consumer, ConsumerWidget en ConsumerStatefulWidget worden allemaal ondersteund.
Volgende stappen
Providers
Ga terug naar het praktische gebruik van Provider, AsyncProvider en read-API's.
Providers openen