sliding_panel 1.0.2

A Flutter slidable widget that provides an easy to use configuration. Just as you want it!

[1.0.2] - March 25, 2020

• Fixed an issue that prevented the headerContent to take whole available Header width even if the leading was not specified. #9

[1.0.1] - January 24, 2020

sliding_panel's first 2020 update comes with a bunch of changes, fixes and enhancements!

For migration to this version, visit the Migration guide.

Dismissible panel:

• Now, the panel can be dismissed. Means, it can work as 4-state panel, namely expanded, collapsed, closed and dismissed.
• As a part of this change, PanelController.dismiss(), PanelState.dismissed and InitialPanelState.dismissed were added.
• This works for two-state panels also!

---

Modal panel:

• Use SlidingPanel exactly same as showModalBottomSheet(), by calling showModalSlidingPanel(). It pushes a new route, waits for a Navigator.of(context).pop()... And guess what, you can also send results back, same as you did in showModalBottomSheet()!!!

---

PanelHeader changes and improvements:

• PanelHeader is now rendered as a SliverAppBar! It has its own advantages.
• PanelHeader now also accepts a parameter: options, an instance of PanelHeaderOptions, specially meant to customize the header.

---

panelContent changes:

• Breaking change: PanelContent.panelContent now only accepts a List<Widget>. To get access to ScrollController, grab that by PanelController.scrollData.scrollController.
• Breaking change: As part of above change, you DON'T have to attach the ScrollController yourself to any Widget. It is now done automatically.
• panelContent is now cached, so that it doesn't require parent to provide the same content twice due to PanelAutoSizing.

---

• Breaking change: snapPanel was removed. Instead, a new enum called PanelSnapping is introduced. (The parameter is now called snapping).

• Breaking change: In PanelDecoration , the backgroundColor defaults to the app's canvas color (i.e., Theme.of(context).canvasColor).

• Breaking change: The Duration is now calculated from PanelState.dismissed to PanelState.expanded instead of from PanelState.closed to PanelState.expanded.

• Breaking change: The PanelController.popWithResult() will dismiss the panel, instead of close. To avoid this, set shouldCloseOnly to true. (This also applies to a newly introduced PanelController.popWithThrowResult()).

• Change: Now, the PanelController doesn't throw error when it is re-assigned to different SlidingPanel. It simply ignores old one and points to new one.

• Change: PanelCollapsedWidget is now shown below the PanelHeaderWidget.

• Refactor: The code in panel.dart is refactored a lot. Now, it should be easy to understand.

---

• Fix + improved: PanelAutoSizing related bugs fixed (they were many), unnecessary calculations removed.
• Fix: For calculating various heights, 'Screen height (and width)' was used. Now, available 'Constrained height' is used, for more accurate calculation.
• Fix: A bug fixed that caused double.infinity or double.NaN when duration was being calculated.
• Fix: A bug fixed that caused double.NaN when backdrop opacity was being calculated.
• Fix: A bug fixed that caused double.NaN when panel's expanded height was being calculated.
• Fix: Disposed with active ticker bug fixed. (Was caused when panel is animating and route is popped.)
• Fix: The panel now remembers the position when device's resolution / orientation changes.
• Fix: A bug with BackPressBehavior.COLLAPSE_CLOSE_POP fixed.

---

• New: A whole new Sliver based layout, where the PanelHeaderWidget is a SliverAppBar and contents are inside SliverList.
• New: Call rebuild() on PanelController to recalculate the PanelSize again.
• New: New way to notify changes to the parent, using throwResult() and popWithThrowResult() which give results to onThrowResult callback.
• New: A new parameter called useMinExpanded available in PanelAutoSizing, so that PanelSize.expandedHeight also gets considered when calculating the height.
• New: A new parameter called panelClosedOptions available. Don't forget to check it out and decide what happens when the panel is closed.
• New: Now PanelController.sizeData gives two additional properties: constrainedHeight and constrainedWidth.
• New: New parameter: animatedAppearing. If true, the panel animates to initialState, initially.
• New: New parameter: dragMultiplier. Now decide the amount of the panel slides when user drags the panel.

[0.7.0] - November 08, 2019

This release introduces below new features. There is no breaking change.

• New: Now you can specify panel's maximum width under different device orientations using PanelMaxWidth parameter.
• New: A new class PanelFooterWidget is added, so that you can give your panel a consistent bottom widget!
• New: A new class PanelScrollData is added, which is helpful to get current scrolling position of the panel.

[0.5.0] - October 06, 2019

This package release introduces some API changes (majorly breaking changes) and a new underlying mechanism. Below are some of the changes. For complete list of changes and migration to this version, visit the Migration guide.

• New: Now specify what happens when user presses back button, using BackPressBehavior and PanelPoppingBehavior.
• New: Now you can specify the limit of user's dragging the panel, using allowedDraggingTill parameter.
• New: Now you can provide Scrollable element inside panelContent, so that the panel can be dragged and scrolled at the same time.
• New: snappingTriggerPercentage added, so that you have more control over panel snapping.
• New: A new class PanelSizeData is added (accessed from PanelController), which helps to get updated PanelSize parameters of this panel.
• When using PanelAutoSizing, you can not change values of PanelSize at runtime.
• PanelController also contains some new and breaking changes.
• onPanelExpanded, onPanelCollapsed and onPanelClosed are all combined in single : onPanelStateChanged.
• Breaking change: The headerContent is now moved to a separate Widget called PanelHeaderWidget.
• Breaking change: For panelContent, a new typedef is introduced, called PanelBodyBuilder.
• Breaking change: PanelSize class no longer accepts values in pixels. Only percentage values can be given from now.
• New and Breaking change: The PanelState : animating works in adifferent way and a new state indefinite added.

[0.2.0] - September 13, 2019

Now, the package is updated with some improvements as below:

• The code is separated in multiple files for readability.
• Almost all the functions of PanelController return a Future, so that you can do some action afterwards.
• When a panel is visible, you can change the panel's height runtime and it will animate. (This feature is not stable).
• Now you can provide the height of the panel in percentage of the screen also.
• A persistent header widget can be provided.
• The panel's height can be automatically determined depending on content! (see PanelAutoSizing class for this).

[0.1.0] - September 07, 2019

The initial release of the sliding_panel package. This includes below functions to the developers:

• A highly customisable Sliding panel
• Though many options available, it is made as easy as possible to tweak look and feel of the panel
• A panel can work as Three-state panel or traditional Two-state panel
• An easy to use PanelController, which helps getting current panel state and modifying its current state
• PanelController allows to animate the panel to arbitrary position
• Various callbacks that help getting current state of the panel
• Parallax and Backdrop effects on the panel
• Provide InitialPanelState property to decide how the panel is displayed initially
• Also responds to user gestures
• Panel can return arbitrary values back to the parent