Fljótleg API uppfletting fyrir daglega vinnu.
Þessi síða dregur saman algenga klasa og aðferðir úr miniriverpod_core.dart og miniriverpod_flutter.dart.
Kjarnategundir
Kjarnafrumstæði fyrir stöðu og provider-a.
AsyncValue<T>
AsyncLoading / AsyncData / AsyncError
Provider<T>
Samstilltur provider með valfrjálsu autoDispose
AsyncProvider<T>
Ósamstilltur provider með .future vali
Lestrarábending
AsyncValue inniheldur ekki when-aðferð; notaðu switch mynsturgreiningu eða is-athuganir.
Ref- og ProviderContainer-aðferðir
Algengar rekstraraðferðir fyrir refresh, invalidation, lífsferil og keyrslu mutation-aðgerða.
Algeng röð
Aðferðakort
read / watch / listen : lesa og gerast áskrifandi að provider-um.
invalidate / refresh / refreshValue : endurreikna stöðu.
onDispose / keepAlive / emit : lífsferill og stream-tenging.
mutation / mutate / invoke : rekjanlegar skrifaðgerðir.
scope / overrideWithValue : DI og overrides í prófum.
Stutt yfirlit yfir Flutter API
ProviderScope + WidgetRef inngangar sem eru notaðir í forritskóða.
// 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');
}
}
// Keyrsla mutation-aðgerðar
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) krefst handvirks container.dispose().
UncontrolledProviderScope losar aldrei innspýtt container.
Consumer, ConsumerWidget og ConsumerStatefulWidget eru öll studd.