peek_and_pop 1.0.2

  • Readme
  • Changelog
  • Example
  • Installing
  • 79

peek_and_pop #

Cosmos Software Cosmos Software

Awesome Flutter

Pub License



Peek & Pop implementation for Flutter based on the iOS functionality of the same name.

Finally, the v1.0.0 release! More fluent, more optimised and more beautiful than ever. Very customisable and very easy to use.

It is highly recommended to read the documentation and run the example project on a real device to fully understand and inspect the full range of capabilities.

Media | Description | Installation | How-to-Use

Notice #

  • v0.1.9 and higher no longer requires any modifications to Flutter's normal "binding.dart"! You can leave your Flutter source code alone and happy.

  • If you are updating from an earlier version, you can revert your "binding.dart" to its original format.


Recent #

  • The "Quick Actions" feature is now added. It is highly customisable and you can show a dynamic menu with quick action buttons as the view is dragged and snapped very easily. The drag and snap limits will be automatically set according to the menu and the view. snap is now implemented directly to the package. See Media for examples.

  • The "Overlap" and "Alignment" features are now added. These two features create a much more fluent Peek & Pop process that is much more similar to the actual iOS version. See Media for examples.

  • The "Scale Up" and "Scale Down" features are now added. You can use these features to scale a widget down or up as the Peek & Pop process proceeds. "Scale Up" is also supported for the "Indicator" feature out of the box.See Media for examples.

  • Improved enumeration for the stage of the Peek & Pop process.

  • The "Indicator" feature is now added. See Media for examples.

  • Animations are now up to 4x faster with the new optimised blur effect algorithm during the Peek & Pop process.


Warning #

  • "isHero" is now removed. It wasn't playing well with the package algorithm and it is considered to be unnecessary for the Peek & Pop process. However, this shouldn't be a problem due to the addition of the new "Overlap" and "Alignment" features. If you must use a Hero widget, only use it while "willBeDone" or "isDone" is true.

  • Old installation instructions are removed. If you wish (for some reason) to use a version older than v0.1.9, see the README of that version for the relevant installation instructions.


Media #

Watch on Youtube:

v1.0.0 Showcase Demo | v1.0.0 Technical Preview

v0.1.7

v0.1.0 Mixed

v0.0.1 Normal | v0.0.1 Moveable | v0.0.1 Platform View | v0.0.1 Hero



Description #

As a fan of the iOS Peek & Pop functionality, I decided to implement it for Flutter as well.

The package has been tested on iOS but not yet on Android as I don't have access to an Android device with Force Press capabilities. Help about this would be appreciated.

For devices that don't support Force Press, the package comes with an adaptation to Long Press however the Long Press version of this package is still under development and is not yet fully tested so consider it as a developers preview.

(The Long Press version is temporarily removed. It will be added back soon.)

## The power move of this package is what I like to call "Gesture Recognition Rerouting". Normally, when a new widget with GestureDetector or similar is pushed over an initial widget used for detecting Force Press or when Navigator is used to pop a new page, the user has to restart the gesture for Flutter to resume updating it. This package fixes that problem as explained in the documentation:

//This function is called by the instantiated [PeekAndPopChild] once it is ready to be included in the Peek & Pop process. Perhaps the most
//essential functionality of this package also takes places in this function: The gesture recognition is rerouted from the [PeekAndPopDetector]
//to the instantiated [PeekAndPopChild]. This is important for avoiding the necessity of having the user stop and restart their Force Press.
//Instead, the [PeekAndPopController] does this automatically so that the existing Force Press can continue to update even when if
//[PeekAndPopDetector] is blocked by the view which is often the case especially when using PlatformViews.

Installation #

It is easy. Don't worry.

If you do not wish to use PlatformViews you can skip the installation instructions.

Old installation instructions are removed. If you wish (for some reason) to use a version older than v0.1.9, see the README of that version for the relevant installation instructions.

For properly displaying PlatformViews, this package requires the latest Flutter master branch. Maybe it will work with some other version too but tests made with the webview_flutter seem to only properly display with the latest Flutter master branch which has improved the PlatformViews that allow better functionalities such as proper scaling and proper clipping.

If you do not wish to use PlatformViews, you can skip this step.

To use latest Flutter master branch, run the following command.

Note: Don't forget to add to your Info.plist. See webview_flutter for more info.

$ git clone -b master https://github.com/flutter/flutter.git
$ flutter channel master
$ flutter upgrade
$ flutter doctor
$ ./flutter/bin/flutter --version

How-to-Use #

Also easy.

First of all, as explained in the documentation:

//I noticed that a fullscreen blur effect via the [BackdropFilter] widget is not good to use while running the animations required for the Peek &
//Pop process as it causes a noticeable drop in the framerate- especially for devices with high resolutions. During a mostly static view, the
//drop is acceptable. However, once the animations start running, this drop causes a visual disturbance. To prevent this, a new optimised blur
//effect algorithm is implemented. Now, the [BackdropFilter] widget is only used until the animations are about to start. At that moment, it is
//replaced by a static image. Therefore, to capture this image, your root CupertinoApp/MaterialApp MUST be wrapped in a [RepaintBoundary] widget
//which uses the [background] key. As a result, the Peek & Pop process is now up to 4x more fluent.

TL;DR: Wrap your root CupertinoApp/MaterialApp in a RepaintBoundary widget and use the background GlobalKey from "misc.dart".

This is required for the new optimised blur effect algorithm:

import 'package:peek_and_pop/misc.dart' as PeekAndPopMisc;

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return RepaintBoundary(
      key: PeekAndPopMisc.background,
      child: MaterialApp(
        title: 'Peek & Pop Demo',
        home: MyHomePage(title: 'Peek & Pop Demo')
      )
    );
  }
}

If you wish to use the "ScaleUp" or the "Scale Down" features, wrap the widgets you wish to scale down or scale up during the Peek & Pop process with the scaleUpWrapper and scaleDownWrapper functions from "misc.dart":

@override
Widget build(BuildContext context) {
return Scaffold(
  appBar: AppBar(title: Text(widget.title)),
  body: PeekAndPopMisc.scaleDownWrapper(
        ...,
        0.04,
        ),
    );    
}

Then, create a PeekAndPopController such as:

PeekAndPopController(
  uiChild(),            //Widget uiChild
  false,                //bool uiChildUseCache
 {Key key,
  peekAndPopBuilder,
  peekAndPopBuilderUseCache,
  peekAndPopBuilderAtPeek       : peekAndPopBuilderAtPeek,
  peekAndPopBuilderAtPop        : peekAndPopBuilderAtPop,
  quickActionsBuilder           : quickActionsBuilder,
  sigma                         : 10,
  backdropColor                 : Colors.black,
  alpha                         : 126,
  overlayBuilder                : overlayBuilder,
  useOverlap                    : true,
  customOverlapRect,
  useAlignment,                 : false,
  useIndicator                  : true,
  indicatorScaleUpCoefficient   : 0.01,
  willPeekAndPopComplete        : _willPeekAndPopComplete,
  willPushPeekAndPop            : _willPushPeekAndPop,
  willUpdatePeekAndPop          : _willUpdatePeekAndPop,
  willCancelPeekAndPop          : _willCancelPeekAndPop,
  willFinishPeekAndPop          : _willFinishPeekAndPop,
  willClosePeekAndPop           : _willClosePeekAndPop,
  onPeekAndPopComplete          : _onPeekAndPopComplete,
  onPushPeekAndPop              : _onPushPeekAndPop,
  onUpdatePeekAndPop            : _onUpdatePeekAndPop,
  onCancelPeekAndPop            : _onCancelPeekAndPop,
  onFinishPeekAndPop            : _onFinishPeekAndPop,
  onClosePeekAndPop             : _onFinishPeekAndPop,
  onPressStart                  : _onPressStart,
  onPressUpdate                 : _onPressUpdate,
  onPressEnd                    : _onPressEnd,
  treshold                      : 0.5,
  startPressure                 : 0.125,
  peakPressure                  : 1.0,
  peekScale                     : 0.5,
  peekCoefficient               : 0.05,
  popTransition,
  useHaptics                    : true})
  
Widget uiChild() {}

Widget peekAndPopBuilderAtPeek(BuildContext context, PeekAndPopControllerState _peekAndPopController);
Widget peekAndPopBuilderAtPop(BuildContext context, PeekAndPopControllerState _peekAndPopController);

QuickActionsData quickActionsBuilder(PeekAndPopControllerState _peekAndPopController);

WidgetBuilder overlayBuiler(BuildContext context);

bool _willPeekAndPopComplete(PeekAndPopControllerState _peekAndPopController);
bool _willPushPeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willUpdatePeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willCancelPeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willFinishPeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willClosePeekAndPop(PeekAndPopControllerState _peekAndPopController);

void _onPeekAndPopComplete(PeekAndPopControllerState _peekAndPopController);
void _onPushPeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onUpdatePeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onCancelPeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onFinishPeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onClosePeekAndPop(PeekAndPopControllerState _peekAndPopController);

void _onPressStart(dynamic dragDetails);
void _onPressUpdate(dynamic dragDetails);
void _onPressEnd(dynamic dragDetails);
 

Further Explanations:

For a complete set of descriptions for all parameters and methods, see the documentation.

  • Set [uiChildUseCache] to true if your [uiChild] doesn't change during the Peek & Pop process.
  • Set [peekAndPopBuilderUseCache] to true if your [peekAndPopBuilder] doesn't change during the Peek & Pop process.
  • If [peekAndPopBuilderAtPop] and [peekAndPopBuilderAtPeek] are set, [peekAndPopBuilder] and [peekAndPopBuilderUseCache] are ignored.
  • If one of [peekAndPopBuilderAtPop] and [peekAndPopBuilderAtPeek] is set, the other one must be set too.
  • If [quickActionsBuilder] is set, it is recommended that [peekAndPopBuilderAtPop] and [peekAndPopBuilderAtPop] are set too.
  • [overlayBuilder] is an optional second view to be displayed during the Peek & Pop process. This entire widget is built after everything else.
  • For all [PeekAndPopProcessNotifier] callbacks such as [willPeekAndPopComplete], you can return false to prevent the default action.
  • All [PeekAndPopProcessNotifier] and [PeekAndPopProcessCallback] callbacks will return a reference to the created [PeekAndPopController] state. You can save this instance for further actions.
  • [pageTransition] is the transition to be used when the view is opened directly or when the view is closed. A default [SlideTransition] is provided.
  • Use [PeekAndPopControllerState]'s [void closePeekAndPop()] method to close the Peek & Pop process. Do not call [Navigator.of(context).pop()] directly.
  • Use [PeekAndPopControllerState]'s [stage] variable to get enumeration for the stage of the Peek & Pop process. If you want to only know when the Peek & Pop process will be or is completed, you can also use [willBeDone] or [isDone] variables.

Notes #

I started using and learning Flutter only some weeks ago so this package might have some parts that don't make sense, that should be completely different, that could be much better, etc. Please let me know! Nicely!

Any help, suggestion or criticism is appreciated!

Cheers.





[1.0.2] - 07.09.2019

  • Two new PeekAndPopBuilders are added to [PeekAndPopController]. Use [PeekAndPopController.peekAndPopBuilderAtPeek] and [PeekAndPopController.peekAndPopBuilderAtPop] for both convenience and improved performance.

  • Improved performance.

[1.0.1] - 03.09.2019

  • Minor changes.

[1.0.0] - 30.08.2019

  • The "Quick Actions" feature is now added. It is highly customisable and you can show a dynamic menu with quick action buttons as the view is dragged and snapped very easily. The drag and snap limits will be automatically set according to the menu and the view. snap is now implemented directly to the package. See this video for examples.

  • The "Overlap" and "Alignment" features are now added. These two features create a much more fluent Peek & Pop process that is much more similar to the actual iOS version. See this video for examples.

  • The "Scale Up" and "Scale Down" features are now added. You can use these features to scale a widget down or up as the Peek & Pop process proceeds. "Scale Up" is also supported for the "Indicator" feature out of the box. See this video for examples.

  • "isHero" is now removed. It wasn't playing well with the package algorithm and it is considered to be unnecessary for the Peek & Pop process. However, this shouldn't be a problem due to the addition of the new "Overlap" and "Alignment" features. If you must use a Hero widget, only use it while "willBeDone" or "isDone" is true.

  • A workaround is implemented to avoid a Flutter Engine bug that was causing trouble with the optimised blur effect algorithm.

  • Improved enumeration for the stage of the Peek & Pop process.

  • Improved performance.

  • Fine tuning.

  • Improved code style.

  • Improved example project.

  • Updated README.

  • Old installation instructions are removed. If you wish (for some reason) to use a version older than v0.1.9, see the README of that version for the relevant installation instructions.

[0.2.0] - 23.08.2019

  • Improved performance.

  • Minor changes.

  • Improved code style with trailing commas.

  • [0.2.0+1] Minor changes.

[0.1.9] - 20.08.2019

  • Modifications to Flutter's normal "binding.dart" are no longer required!

  • The Long Press version is temporarily removed. It will be added back soon.

  • Code excerpt added to the README.

  • Updated README.

  • [0.1.9+1] Updated README.

[0.1.8] - 18.08.2019

  • Example project adapted to the updated snap.

  • Minor changes.

  • [0.1.8+1] Updated README.

[0.1.7] - 14.08.2019

  • The "Indicator" feature added. See this video for examples.

  • Improved performance.

  • Fine tuning.

[0.1.6] - 12.08.2019

  • Improved Long Press version (still under development).

  • Fine tuning.

  • Improved documentation.

  • Updated README.

[0.1.5] - 11.08.2019

  • Improved performance.

  • Improved code style.

[0.1.4] - 11.08.2019

  • A minor bug is fixed.

[0.1.3] - 07.08.2019

  • A minor bug in the example project is fixed.

  • Updated README:

    Note: Don't forget to add to your Info.plist. See webview_flutter for more info.

[0.1.2] - 07.08.2019

  • snap is now implemented directly to the example.

  • More callbacks added for better control.

  • Simple enumeration for the stage of the Peek & Pop process added.

  • Improved animations.

  • Improved documentation.

[0.1.1] - 06.08.2019

  • Improved code style.

[0.1.0] - 06.08.2019

  • Improved Long Press version (still under development).

  • Improved documentation.

[0.0.1] - 05.08.2019

  • Initial release.

example/README.md

example #

Example Project for peek_and_pop.

Note: Don't forget to add to your Info.plist. See webview_flutter for more info.

peek_and_pop #

Cosmos Software Cosmos Software

Awesome Flutter

Pub License



Peek & Pop implementation for Flutter based on the iOS functionality of the same name.

Finally, the v1.0.0 release! More fluent, more optimised and more beautiful than ever. Very customisable and very easy to use.

It is highly recommended to read the documentation and run the example project on a real device to fully understand and inspect the full range of capabilities.

Media | Description | Installation | How-to-Use

Notice #

  • v0.1.9 and higher no longer requires any modifications to Flutter's normal "binding.dart"! You can leave your Flutter source code alone and happy.

  • If you are updating from an earlier version, you can revert your "binding.dart" to its original format.


Recent #

  • The "Quick Actions" feature is now added. It is highly customisable and you can show a dynamic menu with quick action buttons as the view is dragged and snapped very easily. The drag and snap limits will be automatically set according to the menu and the view. snap is now implemented directly to the package. See Media for examples.

  • The "Overlap" and "Alignment" features are now added. These two features create a much more fluent Peek & Pop process that is much more similar to the actual iOS version. See Media for examples.

  • The "Scale Up" and "Scale Down" features are now added. You can use these features to scale a widget down or up as the Peek & Pop process proceeds. "Scale Up" is also supported for the "Indicator" feature out of the box.See Media for examples.

  • Improved enumeration for the stage of the Peek & Pop process.

  • The "Indicator" feature is now added. See Media for examples.

  • Animations are now up to 4x faster with the new optimised blur effect algorithm during the Peek & Pop process.


Warning #

  • "isHero" is now removed. It wasn't playing well with the package algorithm and it is considered to be unnecessary for the Peek & Pop process. However, this shouldn't be a problem due to the addition of the new "Overlap" and "Alignment" features. If you must use a Hero widget, only use it while "willBeDone" or "isDone" is true.

  • Old installation instructions are removed. If you wish (for some reason) to use a version older than v0.1.9, see the README of that version for the relevant installation instructions.


Media #

Watch on Youtube:

v1.0.0 Showcase Demo | v1.0.0 Technical Preview

v0.1.7

v0.1.0 Mixed

v0.0.1 Normal | v0.0.1 Moveable | v0.0.1 Platform View | v0.0.1 Hero



Description #

As a fan of the iOS Peek & Pop functionality, I decided to implement it for Flutter as well.

The package has been tested on iOS but not yet on Android as I don't have access to an Android device with Force Press capabilities. Help about this would be appreciated.

For devices that don't support Force Press, the package comes with an adaptation to Long Press however the Long Press version of this package is still under development and is not yet fully tested so consider it as a developers preview.

(The Long Press version is temporarily removed. It will be added back soon.)

## The power move of this package is what I like to call "Gesture Recognition Rerouting". Normally, when a new widget with GestureDetector or similar is pushed over an initial widget used for detecting Force Press or when Navigator is used to pop a new page, the user has to restart the gesture for Flutter to resume updating it. This package fixes that problem as explained in the documentation:

//This function is called by the instantiated [PeekAndPopChild] once it is ready to be included in the Peek & Pop process. Perhaps the most
//essential functionality of this package also takes places in this function: The gesture recognition is rerouted from the [PeekAndPopDetector]
//to the instantiated [PeekAndPopChild]. This is important for avoiding the necessity of having the user stop and restart their Force Press.
//Instead, the [PeekAndPopController] does this automatically so that the existing Force Press can continue to update even when if
//[PeekAndPopDetector] is blocked by the view which is often the case especially when using PlatformViews.

Installation #

It is easy. Don't worry.

If you do not wish to use PlatformViews you can skip the installation instructions.

Old installation instructions are removed. If you wish (for some reason) to use a version older than v0.1.9, see the README of that version for the relevant installation instructions.

For properly displaying PlatformViews, this package requires the latest Flutter master branch. Maybe it will work with some other version too but tests made with the webview_flutter seem to only properly display with the latest Flutter master branch which has improved the PlatformViews that allow better functionalities such as proper scaling and proper clipping.

If you do not wish to use PlatformViews, you can skip this step.

To use latest Flutter master branch, run the following command.

Note: Don't forget to add to your Info.plist. See webview_flutter for more info.

$ git clone -b master https://github.com/flutter/flutter.git
$ flutter channel master
$ flutter upgrade
$ flutter doctor
$ ./flutter/bin/flutter --version

How-to-Use #

Also easy.

First of all, as explained in the documentation:

//I noticed that a fullscreen blur effect via the [BackdropFilter] widget is not good to use while running the animations required for the Peek &
//Pop process as it causes a noticeable drop in the framerate- especially for devices with high resolutions. During a mostly static view, the
//drop is acceptable. However, once the animations start running, this drop causes a visual disturbance. To prevent this, a new optimised blur
//effect algorithm is implemented. Now, the [BackdropFilter] widget is only used until the animations are about to start. At that moment, it is
//replaced by a static image. Therefore, to capture this image, your root CupertinoApp/MaterialApp MUST be wrapped in a [RepaintBoundary] widget
//which uses the [background] key. As a result, the Peek & Pop process is now up to 4x more fluent.

TL;DR: Wrap your root CupertinoApp/MaterialApp in a RepaintBoundary widget and use the background GlobalKey from "misc.dart".

This is required for the new optimised blur effect algorithm:

import 'package:peek_and_pop/misc.dart' as PeekAndPopMisc;

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return RepaintBoundary(
      key: PeekAndPopMisc.background,
      child: MaterialApp(
        title: 'Peek & Pop Demo',
        home: MyHomePage(title: 'Peek & Pop Demo')
      )
    );
  }
}

If you wish to use the "ScaleUp" or the "Scale Down" features, wrap the widgets you wish to scale down or scale up during the Peek & Pop process with the scaleUpWrapper and scaleDownWrapper functions from "misc.dart":

@override
Widget build(BuildContext context) {
return Scaffold(
  appBar: AppBar(title: Text(widget.title)),
  body: PeekAndPopMisc.scaleDownWrapper(
        ...,
        0.04,
        ),
    );    
}

Then, create a PeekAndPopController such as:

PeekAndPopController(
  uiChild(),            //Widget uiChild
  false,                //bool uiChildUseCache
 {Key key,
  peekAndPopBuilder,
  peekAndPopBuilderUseCache,
  peekAndPopBuilderAtPeek       : peekAndPopBuilderAtPeek,
  peekAndPopBuilderAtPop        : peekAndPopBuilderAtPop,
  quickActionsBuilder           : quickActionsBuilder,
  sigma                         : 10,
  backdropColor                 : Colors.black,
  alpha                         : 126,
  overlayBuilder                : overlayBuilder,
  useOverlap                    : true,
  customOverlapRect,
  useAlignment,                 : false,
  useIndicator                  : true,
  indicatorScaleUpCoefficient   : 0.01,
  willPeekAndPopComplete        : _willPeekAndPopComplete,
  willPushPeekAndPop            : _willPushPeekAndPop,
  willUpdatePeekAndPop          : _willUpdatePeekAndPop,
  willCancelPeekAndPop          : _willCancelPeekAndPop,
  willFinishPeekAndPop          : _willFinishPeekAndPop,
  willClosePeekAndPop           : _willClosePeekAndPop,
  onPeekAndPopComplete          : _onPeekAndPopComplete,
  onPushPeekAndPop              : _onPushPeekAndPop,
  onUpdatePeekAndPop            : _onUpdatePeekAndPop,
  onCancelPeekAndPop            : _onCancelPeekAndPop,
  onFinishPeekAndPop            : _onFinishPeekAndPop,
  onClosePeekAndPop             : _onFinishPeekAndPop,
  onPressStart                  : _onPressStart,
  onPressUpdate                 : _onPressUpdate,
  onPressEnd                    : _onPressEnd,
  treshold                      : 0.5,
  startPressure                 : 0.125,
  peakPressure                  : 1.0,
  peekScale                     : 0.5,
  peekCoefficient               : 0.05,
  popTransition,
  useHaptics                    : true})
  
Widget uiChild() {}

Widget peekAndPopBuilderAtPeek(BuildContext context, PeekAndPopControllerState _peekAndPopController);
Widget peekAndPopBuilderAtPop(BuildContext context, PeekAndPopControllerState _peekAndPopController);

QuickActionsData quickActionsBuilder(PeekAndPopControllerState _peekAndPopController);

WidgetBuilder overlayBuiler(BuildContext context);

bool _willPeekAndPopComplete(PeekAndPopControllerState _peekAndPopController);
bool _willPushPeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willUpdatePeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willCancelPeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willFinishPeekAndPop(PeekAndPopControllerState _peekAndPopController);
bool _willClosePeekAndPop(PeekAndPopControllerState _peekAndPopController);

void _onPeekAndPopComplete(PeekAndPopControllerState _peekAndPopController);
void _onPushPeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onUpdatePeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onCancelPeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onFinishPeekAndPop(PeekAndPopControllerState _peekAndPopController);
void _onClosePeekAndPop(PeekAndPopControllerState _peekAndPopController);

void _onPressStart(dynamic dragDetails);
void _onPressUpdate(dynamic dragDetails);
void _onPressEnd(dynamic dragDetails);
 

Further Explanations:

For a complete set of descriptions for all parameters and methods, see the documentation.

  • Set [uiChildUseCache] to true if your [uiChild] doesn't change during the Peek & Pop process.
  • Set [peekAndPopBuilderUseCache] to true if your [peekAndPopBuilder] doesn't change during the Peek & Pop process.
  • If [peekAndPopBuilderAtPop] and [peekAndPopBuilderAtPeek] are set, [peekAndPopBuilder] and [peekAndPopBuilderUseCache] are ignored.
  • If one of [peekAndPopBuilderAtPop] and [peekAndPopBuilderAtPeek] is set, the other one must be set too.
  • If [quickActionsBuilder] is set, it is recommended that [peekAndPopBuilderAtPop] and [peekAndPopBuilderAtPop] are set too.
  • [overlayBuilder] is an optional second view to be displayed during the Peek & Pop process. This entire widget is built after everything else.
  • For all [PeekAndPopProcessNotifier] callbacks such as [willPeekAndPopComplete], you can return false to prevent the default action.
  • All [PeekAndPopProcessNotifier] and [PeekAndPopProcessCallback] callbacks will return a reference to the created [PeekAndPopController] state. You can save this instance for further actions.
  • [pageTransition] is the transition to be used when the view is opened directly or when the view is closed. A default [SlideTransition] is provided.
  • Use [PeekAndPopControllerState]'s [void closePeekAndPop()] method to close the Peek & Pop process. Do not call [Navigator.of(context).pop()] directly.
  • Use [PeekAndPopControllerState]'s [stage] variable to get enumeration for the stage of the Peek & Pop process. If you want to only know when the Peek & Pop process will be or is completed, you can also use [willBeDone] or [isDone] variables.

Notes #

I started using and learning Flutter only some weeks ago so this package might have some parts that don't make sense, that should be completely different, that could be much better, etc. Please let me know! Nicely!

Any help, suggestion or criticism is appreciated!

Cheers.





Use this package as a library

1. Depend on it

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


dependencies:
  peek_and_pop: ^1.0.2

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter pub get

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

3. Import it

Now in your Dart code, you can use:


import 'package:peek_and_pop/peek_and_pop.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
63
Health:
Code health derived from static analysis. [more]
99
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
90
Overall:
Weighted score of the above. [more]
79
Learn more about scoring.

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

  • Dart: 2.5.1
  • pana: 0.12.21
  • Flutter: 1.9.1+hotfix.4

Platforms

Detected platforms: Flutter

References Flutter, and has no conflicting libraries.

Health suggestions

Fix lib/peek_and_pop_child.dart. (-1 points)

Analysis of lib/peek_and_pop_child.dart reported 2 hints:

line 666 col 15: The member 'lerp' can only be used within instance members of subclasses of 'package:flutter/src/animation/tween.dart'.

line 674 col 15: The member 'lerp' can only be used within instance members of subclasses of 'package:flutter/src/animation/tween.dart'.

Format lib/animated_cross_fade.dart.

Run flutter format to format lib/animated_cross_fade.dart.

Format lib/gesture_detector.dart.

Run flutter format to format lib/gesture_detector.dart.

Format lib/misc.dart.

Run flutter format to format lib/misc.dart.

Format lib/peek_and_pop_controller.dart.

Run flutter format to format lib/peek_and_pop_controller.dart.

Maintenance issues and suggestions

Support latest dependencies. (-10 points)

The version constraint in pubspec.yaml does not support the latest published versions for 1 dependency (bloc).

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.2.2 <3.0.0
bloc ^0.15.0 0.15.0 0.16.1
flutter 0.0.0
snap ^1.0.4 1.0.4
transparent_image ^1.0.0 1.0.0
Transitive dependencies
collection 1.14.11 1.14.12
flick 1.0.2
meta 1.1.7
rxdart 0.22.3
sky_engine 0.0.99
typed_data 1.1.6
vector_math 2.0.8
Dev dependencies
flutter_test