provider 1.3.0

  • README.md
  • CHANGELOG.md
  • Example
  • Installing
  • Versions
  • 97

Build Status pub package codecov

A generic implementation of InheritedWidget. It allows to expose any kind of object, without having to manually write an InheritedWidget ourselves.

Usage #

To expose a value, simply wrap any given part of your widget tree into any of the available Provider as such:

Provider<int>(
  value: 42,
  child: // ...
)

Descendants of Provider and now obtain this value using the static Provider.of<T> method:

var value = Provider.of<int>(context);

You can also use Consumer widget to insert a descendant, useful when both creating a Provider and using it:

Provider<int>(
  value: 42,
  child: Consumer<int>(
    builder: (context, value) => Text(value.toString()),
  )
)

Note that you can freely use multiple providers with different type together:

Provider<int>(
  value: 42,
  child: Provider<String>(
    value: 'Hello World',
    child: // ...
  )
)

And obtain their value independently:

var value = Provider.of<int>(context);
var value2 = Provider.of<String>(context);

Existing Providers: #

Provider #

A simple provider which takes the exposed value directly:

Provider<int>(
  value: 42,
  child: // ...
)

HookProvider #

A provider which can use hooks from flutter_hooks

This is especially useful to create complex providers, without having to make a StatefulWidget.

The following example uses BLoC pattern to create a BLoC, provide its value, and dispose it when the provider is removed from the tree.

HookProvider<MyBloc>(
  hook: () {
    final bloc = useMemoized(() => MyBloc());
    useEffect(() => bloc.dispose, [bloc]);
    return bloc;
  },
  child: // ...
)

1.3.0 #

  • Added Consumer, useful when we need to both expose and consume a value simultaneously.

1.2.0 #

  • Added: HookProvider, a Provider that creates its value from a Hook.
  • Deprecated StatefulProvider. Either make a StatefulWidget or use HookProvider.
  • Integrated the widget inspector, so that Provider widget shows the current value.

1.1.1 #

  • add didChangeDependencies callback to allow updating the value based on an InheritedWidget
  • add updateShouldNotify method to both Provider and StatefulProvider

1.1.0 #

  • onDispose has been added to StatefulProvider
  • BuildContext is now passed to valueBuilder callback

example/provider.dart

import 'package:flutter/widgets.dart';
import 'package:provider/provider.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Provider(
      value: 42,
      child: Example(),
    );
  }
}

class Example extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Text(Provider.of<int>(context).toString());
  }
}

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  provider: ^1.3.0

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter packages get

Alternatively, your editor might support flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:provider/provider.dart';
  
Version Uploaded Documentation Archive
2.0.1 May 12, 2019 Go to the documentation of provider 2.0.1 Download provider 2.0.1 archive
2.0.0+1 May 3, 2019 Go to the documentation of provider 2.0.0+1 Download provider 2.0.0+1 archive
2.0.0 May 3, 2019 Go to the documentation of provider 2.0.0 Download provider 2.0.0 archive
1.6.1 Feb 21, 2019 Go to the documentation of provider 1.6.1 Download provider 1.6.1 archive
1.6.0 Feb 20, 2019 Go to the documentation of provider 1.6.0 Download provider 1.6.0 archive
1.5.0 Feb 11, 2019 Go to the documentation of provider 1.5.0 Download provider 1.5.0 archive
1.4.0 Feb 4, 2019 Go to the documentation of provider 1.4.0 Download provider 1.4.0 archive
1.3.0 Jan 29, 2019 Go to the documentation of provider 1.3.0 Download provider 1.3.0 archive
1.2.0 Jan 25, 2019 Go to the documentation of provider 1.2.0 Download provider 1.2.0 archive
1.1.1 Oct 22, 2018 Go to the documentation of provider 1.1.1 Download provider 1.1.1 archive

All 14 versions...

Popularity:
Describes how popular the package is relative to other packages. [more]
95
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
100
Overall:
Weighted score of the above. [more]
97
Learn more about scoring.

We analyzed this package on May 8, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.3.0
  • pana: 0.12.15
  • Flutter: 1.5.8

Platforms

Detected platforms: Flutter

References Flutter, and has no conflicting libraries.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0 <3.0.0
flutter 0.0.0
flutter_hooks >=0.2.1 <1.0.0 0.4.0
functional_widget_annotation >=0.3.0 <1.0.0 0.5.1
Transitive dependencies
collection 1.14.11
meta 1.1.6 1.1.7
sky_engine 0.0.99
typed_data 1.1.6
vector_math 2.0.8
Dev dependencies
build_runner ^1.1.2
flutter_test
functional_widget ^0.4.0
pedantic ^1.4.0