Pencarian API cepat untuk pekerjaan sehari-hari.

Halaman ini merangkum kelas dan method yang paling umum digunakan dari miniriverpod_core.dart dan miniriverpod_flutter.dart.

Tipe inti

State inti dan primitif provider.

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

Provider sinkron dengan autoDispose opsional

AsyncProvider<T>

Provider asinkron dengan selector .future

Tips membaca

AsyncValue tidak menyertakan method when; gunakan pattern matching switch atau pemeriksaan is.

Metode Ref dan ProviderContainer

Method operasional umum untuk refresh, invalidasi, lifecycle, dan eksekusi mutasi.

Urutan umum

Peta metode

read / watch / listen                 : baca dan berlangganan ke provider.
invalidate / refresh / refreshValue    : hitung ulang state.
onDispose / keepAlive / emit           : lifecycle dan wiring stream.
mutation / mutate / invoke             : operasi tulis yang terlacak.
scope / overrideWithValue              : override DI dan pengujian.

Ringkasan API Flutter

Titik masuk ProviderScope dan WidgetRef digunakan di kode aplikasi.

// Cakupan
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');
  }
}

// Eksekusi mutasi
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) memerlukan container.dispose() secara manual.
UncontrolledProviderScope tidak pernah melakukan dispose pada container yang diinjeksi.
Consumer, ConsumerWidget, dan ConsumerStatefulWidget semuanya didukung.

Langkah berikutnya

Provider

Kembali ke penggunaan praktis Provider, AsyncProvider, dan API read.

Buka provider

Mutasi

Terapkan alur tulis eksplisit dengan kontrol konkurensi.

Buka mutasi