Mabilis na paghahanap ng API para sa pang-araw-araw na trabaho.

Binubuod ng pahinang ito ang mga karaniwang ginagamit na klase at method mula sa miniriverpod_core.dart at miniriverpod_flutter.dart.

Mga Pangunahing Uri

Mga pangunahing state at provider primitive.

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

Synchronous provider na may opsyonal na autoDispose

AsyncProvider<T>

Asynchronous provider na may .future selector

Tip

Walang when method ang AsyncValue; gamitin ang switch pattern matching o mga `is` check.

Mga Method ng Ref at ProviderContainer

Karaniwang mga method ng operasyon para sa refresh, invalidation, lifecycle, at pagpapatakbo ng mutation.

Karaniwang pagkakasunod-sunod

Mapa ng method

read / watch / listen                 : magbasa at mag-subscribe sa mga provider.
invalidate / refresh / refreshValue    : muling kalkulahin ang state.
onDispose / keepAlive / emit           : lifecycle at stream wiring.
mutation / mutate / invoke             : sinusubaybayang write operation.
scope / overrideWithValue              : DI at mga override para sa testing.

Snapshot ng Flutter API

Mga entry point ng ProviderScope + WidgetRef na ginagamit sa code ng app.

// 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'));
Nangangailangan ng manu-manong container.dispose() ang ProviderScope(container: external).
Hindi kailanman dini-dispose ng UncontrolledProviderScope ang container na ipinasok.
Sinusuportahan ang Consumer, ConsumerWidget, at ConsumerStatefulWidget.

Mga Susunod na Hakbang

Mga Provider

Bumalik sa praktikal na paggamit ng Provider, AsyncProvider, at mga read API.

Buksan ang Providers

Mga Mutation

Ipatupad ang malinaw na write flow na may kontrol sa concurrency.

Buksan ang Mutations