flutter_resizable_container 4.0.0

flutter_resizable_container: ^4.0.0 copied to clipboard

Stable release of v4 with all changes of prior beta releases.

• Account for expand sizes with min/max bounds
• Prevent the controller from notifying its listeners during layout/init
• Make ResizableSize subclasses' constructor's private
• Improve doc comments

• Move the min/max bounds out of the ResizableChild and into the ResizableSize
• Remove the divider property of the ResizableContainer and add it into the ResizableChild
• Add a cursor property to the ResizableDivider to display a custom MouseCursor when hovering over the divider

• Add a ResizableLayout widget that uses a custom RenderObject to handle the initial layout and the layout after any properties on the ResizableContainer are updated.

• Rewrite the Controller/Container logic to allow Flutter to handle the initial layout of all widgets, updating the rendered sizes in the controller after the first frame. This shouldn't have any major impact to the API, but it does introduce the use of Timers, which could affect tests.
• Rename ResizableController.sizes to ResizableController.pixels to more clearly indicate its value.
• Store, expose, and utilize the current list of ResizableSize values in the controller. This enables the values to be used even after manually updating them.

• Fix a bug/add support for RTL Directionality.

• Reinstate the removed ResizableControllerManager#setChildren method. This method was removed because the method it targets on the controller was made public. However, the package version was incorrectly bumped since this could be a breaking change. This patch reinstates the method, fixing the breaking change, but adds a deprecation warning in favor of the public controller method.

• Make the "setChildren" method of the ResizableContainer public to address a limitation that was causing the "children length equals sizes length" assertions to fail (#61).

• Fix a bug causing negative values in a BoxConstraint, which was throwing an AssertionError (#60).

After much feedback, I revised the ResizableContainerDivider to be even more customizable. The changes include:

1. Replace the size, indent, and endIndent properties with a length property, of type ResizableSize, to control how long the dividing line is
2. Add crossAxisAlignment and mainAxisAlignment properties to control where the line sits in its available space (if the line does not take up its full length and/or has padding, see below).
3. Add a padding property to add empty space along the main axis - the divider sits within, or alongside, this empty space

New major version! See the beta notes below.

• Fix a bug in the "available size" initialization that was throwing a "marked dirty during build" exception

• Add a ResizableSize.expand constructor that takes a flex integer (defaults to 1)
• Remove the optionality of the size parameter in ResizableChild and use a default ResizableSize.expand() value
• Adjust the controller to disallow null values for ResizableSize arguments
• Adjust the controller to prioritize modifying ResizableSize.expand children when scaling the window (up or down) over the pixel and ratio children, unless no expand children are set

• Added a new ResizableSize class that defines a "size" in pixels or as a ratio
• Changed the startingRatio in the ResizableChild to startingSize that takes an optional ResizableSize
  • This change allows the starting size of a child to be defined as an absolute value (in logical pixels) or as a ratio of the available space
  • If there is a mixture of pixels and ratio sizes, the pixel sizes will be given priority and then the ratio sizes will be given the remaining available space
• Added a setSizes method to the ResizableController that takes a list of optional ResizableSizes. These sizes will be applied to the current children following the same rules as noted above
• Removed the ratios setter in favor of the new setSizes method
• Made the controller an optional param in the ResizableContainer ctor

• Renamed ResizableChildData to ResizableChild
• Added an expand flag to the ResizableChild ctor
  • If there is a startingRatio set and this flag is true, the child will automatically expand to fill any remaining available space. If this flag is false, the child will only expand to meet its startingRatio constraint
  • If the startingRatio is null, the child will automatically expand to fill any remaining available space, regardless of whether or not this flag is set
• Move the list of ResizableChild objects out of the ResizableController and back into the ResizableContainer as the children parameter
  • This allows the list of children to be modified on-the-fly without recreating a ResizableController

First stable version!

• Encapsulation of divider configuration in a new ResizableDivider class
  • Divider thickness and size properties, mirroring the Flutter Divider's thickness and width properties, have been added
  • onHoverEnter and onHoverExit callbacks allow you to react to the user's interactions with the divider
• All size tracking and calculations have been moved out of the ResizableContainer widget and into the ResizableController
  • This fixed several bugs and improves performance by converting the ResizableContainer to a StatelessWidget (from stateful)
• ResizableContainer now requires a List<Widget> as its children property, as the List<ResizableChildData> have been moved into the ResizableController
• Added and improved tests
• Added a GH workflow to deploy the example app to GH Pages

• Adds dividerIndent and dividerEndIndent properties to the resizable container

• Fixes an issue with the didUpdateWidget lifecycle hook causing errors to be thrown during hot-reloads

• Add tests for ResizableController
• Add tests for ResizableContainer
• Add GitHub Actions workflow

• Add ResizableController to allow programmatic control of resizable children
• Fix a bug causing adjacent containers to grow in size when the target container reaches is minimum size

• Make divider color and width customizable

• Fix package description to improve pub.flutter-io.cn score

• Update the Dart SDK constraints to >=3.0.0 <4.0.0

• Fix a bug causing overflows when the window is resized
• Remove the factory and add the debug assert directly to the ctor

• Remove commented code from the example project

• Improve documentation and comments

• Rework dividers to lie in-line with child widgets, taking up space along the primary axis, instead of being placed in a stack and positioned according to the child sizes
• Add a custom divider who's width is known and can be controlled to ease calculating the available space for child widgets
• Remove the optionality of the divider - this widget is now required to be visible, as hiding it would disable the resize functionality

• Fix divider and cursor positioning

• Add optional divider line
• Fix a bug allowing child sizes to grow beyond available space
• Improve example with switchable direction and toggle-able divider

• Add example to README
• Add example project
• Fix a bug allowing negative child sizes

• Fix a typo in the README

Initial Release

• Container resizes and enforces child size constraints (if present)
• Resize cursor responds to user clicks and drags on web