दैनंदिन कामासाठी जलद API संदर्भ.

हे पृष्ठ miniriverpod_core.dart आणि miniriverpod_flutter.dart मधील वारंवार वापरल्या जाणाऱ्या classes आणि methods यांचा सारांश देते.

मुख्य प्रकार

मूलभूत state आणि provider primitives.

AsyncValue<T>

AsyncLoading / AsyncData / AsyncError

Provider<T>

ऐच्छिक autoDispose असलेला सिंक्रोनस provider

AsyncProvider<T>

असिंक्रोनस provider ज्यात .future selector आहे.

वाचनाची टीप

AsyncValue मध्ये when method समाविष्ट नाही; switch pattern matching किंवा is checks वापरा.

Ref आणि ProviderContainer पद्धती

refresh, invalidation, lifecycle, आणि mutation execution साठीच्या सामान्य पद्धती.

सामान्य क्रम

पद्धतींचा तक्ता

read / watch / listen                 : providers वाचा आणि subscribe करा.
invalidate / refresh / refreshValue    : state पुन्हा मोजा.
onDispose / keepAlive / emit           : lifecycle आणि stream wiring.
mutation / mutate / invoke             : tracked write operations.
scope / overrideWithValue              : DI आणि testing overrides.

Flutter API झलक

अॅप कोडमध्ये वापरले जाणारे ProviderScope आणि WidgetRef प्रवेशबिंदू.

// स्कोप
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 अंमलबजावणी
await ref.invoke(userProvider.rename('Alice'));
ProviderScope(container: external) साठी container.dispose() हाताने कॉल करणे आवश्यक आहे.
UncontrolledProviderScope injected container कधीही dispose करत नाही.
Consumer, ConsumerWidget, आणि ConsumerStatefulWidget सर्व समर्थित आहेत.

पुढील पावले

Providers

Provider, AsyncProvider, आणि read APIs च्या प्रत्यक्ष वापराकडे परत जा.

Providers उघडा

Mutations

स्पष्ट write flows concurrency control सह अंमलात आणा.

Mutations उघडा