Kërkim i shpejtë i API-së për përdorimin e përditshëm.

Kjo faqe përmbledh klasat dhe metodat më të përdorura nga miniriverpod_core.dart dhe miniriverpod_flutter.dart.

Llojet Bazë

Blloqet bazë të gjendjes dhe të provider-it.

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

Provider sinkron me autoDispose opsional

AsyncProvider<T>

Provider asinkron me selektorin .future

Këshillë

AsyncValue nuk përfshin metodën when; përdorni përputhjen e modeleve me switch ose kontrolle `is`.

Metodat e Ref dhe ProviderContainer

Metoda të zakonshme operative për rifreskim, zhvlerësim, ciklin e jetës dhe ekzekutimin e mutacioneve.

Renditje e zakonshme

Harta e metodave

read / watch / listen                 : lexoni dhe abonohuni te providerët.
invalidate / refresh / refreshValue    : rillogaritni gjendjen.
onDispose / keepAlive / emit           : cikli i jetës dhe lidhja e stream-it.
mutation / mutate / invoke             : operacione të gjurmuara shkrimi.
scope / overrideWithValue              : DI dhe mbivendosje për testime.

Pamje e Flutter API-së

Pikat hyrëse ProviderScope + WidgetRef që përdoren në kodin e aplikacionit.

// Scope
ProviderScope(
  child: const App(),
);

// ConsumerWidget example
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) kërkon thirrjen manuale të container.dispose().
UncontrolledProviderScope nuk e asgjëson kurrë container-in e injektuar.
Consumer, ConsumerWidget dhe ConsumerStatefulWidget mbështeten të gjitha.

Hapat e ardhshëm

Providerët

Kthehuni te përdorimi praktik i Provider, AsyncProvider dhe API-ve të leximit.

Hap Providers

Mutations

Zbatoni rrjedha të qarta të shkrimit me kontroll të njëkohshmërisë.

Hap Mutations