Hurtigoppslag for API i det daglige arbeidet.

Denne siden oppsummerer ofte brukte klasser og metoder fra miniriverpod_core.dart og miniriverpod_flutter.dart.

Kjernetyper

Kjernetyper for tilstand og tilbydere (providers).

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

Synkron tilbyder med valgfri autoDispose

AsyncProvider<T>

Asynkron tilbyder med .future-velger

Lesetips

AsyncValue inneholder ikke en when-metode; bruk switch-mønstermatching eller is-sjekker.

Ref- og ProviderContainer-metoder

Vanlige operasjonelle metoder for oppdatering, ugyldiggjøring, livssyklus og mutasjonskjøring.

Vanlig sekvens

Metodeoversikt

read / watch / listen                 : read and subscribe to providers.
invalidate / refresh / refreshValue    : recompute state.
onDispose / keepAlive / emit           : lifecycle and stream wiring.
mutation / mutate / invoke             : tracked write operations.
scope / overrideWithValue              : DI and testing overrides.

Flutter API-oversikt

ProviderScope + WidgetRef inngangspunkter som brukes i appkoden.

// 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 execution
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) krever manuell container.dispose().
UncontrolledProviderScope sletter aldri injisert beholder (container).
Consumer, ConsumerWidget og ConsumerStatefulWidget støttes.

Neste steg

Providers

Gå tilbake til praktisk bruk av Provider, AsyncProvider og read-API-er.

Åpne Providers

Mutations

Implementer eksplisitte skriveflyter med samtidighetskontroll.

Åpne Mutations