feature_discovery 0.14.2
feature_discovery: ^0.14.2 copied to clipboard
A Flutter package that implements Material Design Feature discovery to show a description of specific features to new users. See https://tinyurl.com/FeatureDiscovery
Changelog #
0.14.0 #
- Migrated to null safety
0.13.0+1 #
- Clear Preferences issue fixed
0.13.0 #
- Introduce a PersistenceProvider interface for storing step completion in any mechanism the user wants.
- Fully backward compatible, no need to change your code.
- All historic steps are honored and will not show again, just as you’d expect.
0.12.0+2 #
- Fixes FeatureDiscovery position issue
0.12.0+1 #
- Fixes a null pointer exception.
0.12.0 #
- Breaking change:
isDisplayedis replaced byhasPreviouslyCompleted. - Fix: the
onCompletereturned value will no longer be ignored, and the next overlay won't show if this function returnsfalse. FeatureDiscovery.completeCurrentStepwill force complete the current step and not execute theonCompletefunction.- Deprecated methods in
FeatureDiscoveryhave been removed. - New parameter
recordStepsInSharedPreferencesinFeatureDiscoveryto prevent step completions to be recorded in Shared Preferences. - New parameter
sharedPreferencesPrefixinFeatureDiscovery.
0.11.0 #
- Added
FeatureDiscovery.backgroundOpacityin order to customize overlay background opacity when it is displayed.backgroundOpacityis optional. If ignored, the default value is 0.96.
0.10.0 #
- Added
FeatureDiscovery.isDisplayedmethod to check status of feature - Added Feature/animation durations customization
- Added
openDurationflag that controls open animation duration. - Added
pulseDurationflag that controls tap target pulse animation duration. - Added
completeDurationflag that controls complete animation duration. - Added
dismissDurationflag that controls dismiss animation duration.
0.9.0 #
- Added
barrierDismissibleflag which decides whether the overlay should dismiss on touching outside or not.
0.8.0 #
- Breaking change:
FeatureDiscovery.completeCurrentStepis async now. - Added preferences for each feature to show is understood by user or not
- Library will not show understood feature
- Added method for reset all preferences of features
FeatureDiscovery.clearPreferences
0.7.0 #
- Breaking change: removed deprecated static methods in
FeatureDiscovery. - Breaking change: removed deprecated parameters in the
EnsureVisibleconstructor. - Breaking change: overlays will always be dismissed when calling
FeatureDiscovery.dismissAll. - Deprecated
activeFeatureId; replaced bycurrentFeatureIdOfto emphasize that this is a getter. - Deprecated
FeatureDiscovery.dismiss; replaced bydismissAllto indicate that no next step will be shown. - Added
assertto require at least one step to be passed toFeatureDiscovery.discoverFeatures. - Incorrect documentation of some static methods in
FeatureDiscoveryhas been updated. - Error messages have been improved : the error thrown when the widget tree isn't wrapped in
a
FeatureDiscoverywidget is clearer. - Incorrect behavior when
onDismissreturnedFuture<false>has been fixed.
0.6.1 #
- Update version constraint to
^4.0.1forproviderdependency.
0.6.0 #
- Breaking change: Renamed
ContentOrientationtoContentLocation. - Breaking change: Made
onCompleteof typeFuture<bool> Function()to matchonOpenandonDismiss. - Methods
completeStepandmarkStepCompletehave been deprecated andcompleteCurrentStepshould now be used. - Method
clearis deprecated anddismissshould now be used. - Added an
OverflowModeenum and theoverflowModeparameter toDescribedFeatureOverlayto control how the overlay should handle content that exceeds the background's boundaries. - Added
FeatureDiscovery.activeFeatureId, which allows you to get the feature id of the current feature discovery step. - Added
duration,curve, andpreciseAligmentparameters toEnsureVisibleState.ensureVisible. - Deprecated
EnsureVisible.durationandEnsureVisible.curveas parameters because they should be passed when callingEnsureVisibleState.ensureVisible. This is not a breaking change. - Made the return type of
EnsureVisibleState.ensureVisiblebeFuture<void>. This is not a breaking change because the previous return type wasvoid, which you cannot work with. - Made the
enablePulsingAnimationrespond to rebuilds, allowing to change it after the overlay has been shown. - Added GIF demo of the package to the
README.mdfile of the package and the example. - Updated example.
- Added
OverflowModetoREADME.md. - Added
CONTRIBUTING.mdand mentioned it inREADME.md.
0.5.0 #
- Breaking change: Instead of the
iconparameter, you now need to use thetapTargetparameter, which takes aWidgetinstead ofIconData. Before:DescribedFeatureOverlay(icon: Icons.add, ..)After:DescribedFeatureOverlay(tapTarget: const Icon(Icons.add), ..) - Breaking change:
titleanddescriptionparameters now take aWidget. - Breaking change: Callbacks are now
onOpen,onDismiss, andonComplete.onOpenandonDismissneed to returnFuture<bool>when specified to decide if the step should be open or dismissed respectively. - Fixed
DescribedFeatureOverlay's constantly rebuilding even if they were never displayed. - Fixed
DescribedFeatureOverlay's rebuilding after dismissing them. - Warning:
Theme.of(context)is now used to determine text styles - Title and description can now be null.
- Added option to disable pulsing animation.
- Added parameter that is called when the overlay is dismissed.
- Added parameters to change text color, target color, and icon color.
- Added possibility to pass any
Iterablefor the steps toFeatureDiscovery.discoverFeatures. - Added the
@requiredannotation to parameters that cannot be null. - Ensured that overlay for each step is only shown once at a time.
- Removed unnecessary files.
- Formatted files.
- Updated the plugin description.
0.4.1 #
- Fixed animation bugs.
0.4.0 #
- Added
ContentOrientation.
0.3.0 #
- Consider landscape and portrait orientation in
DescribedFeatureDiscoveryWidget.
0.2.0 #
- Add
EnsureVisiblewidget to scroll to target when it is in a scrollable container.
0.1.1 #
- Applied Pub health suggestions.
0.1.0 #
- Applied Pub health suggestions.
0.0.1 #
- Initial release.