flutter_fancy_tree_view 1.6.0

A collection of widgets and slivers that helps bringing hierarchical data to life.

1.6.0 24-04-2024

• Added a way to set the default expansion state of tree nodes through the defaultExpansionState property of TreeController.
• Made TreeController.toggledNodes public for state restoration/persistence.

1.5.0 10-04-2024

• Fixed an issue that prevented two AnimatedTreeViews with the same nodes to be displayed alongside each other or on a router stack.
• Follwing the updates to the Flutter Framework's DragTarget widget:
  • Added TreeDragTarget.onWillAcceptWithDetails
  • Deprecated TreeDragTarget.onWillAccept
  • Deprecated TreeDragTarget.onAccept

1.4.1 04-10-2023

• Revert v1.4.0 change to collapseCascading(). The change broke non-cascading animations

1.4.0 04-10-2023

• Added TreeController.search() + filtering example
• Added a way to limit the depth of the tree. Checkout IndentGuide.maxLevel
• Fixed collapseCascading() when used with an animated tree would only animate the first level and the other levels would just vanish immediately
• Deprecated (Descend|Return)Condition in favor of ValuePredicate
• Deprecated alwaysReturnsTrue and alwaysReturnsFalse

1.3.0 13-09-2023

• Added pub topics to pubspec.yaml
• Indentation Improvements:
  • Added a way to apply dashing algorithms to the indentation lines through AbstractLineGuide.pathModifier
  • Added an optional connection between the line of a parent node and its subtree lines with ConnectingLinesGuide.connectBranches
  • Added the IndentGuide.padding property, which is added to the Padding widget that indents tree nodes
  • Fixed an issue with rounded corners being mistakenly offset by ConnectingLinesGuide.origin

1.2.0 18-08-2023

• Upgrade to Dart 3
• Rudimentary Drag and Drop support

1.1.1 04-04-2023

• Fix an issue that caused some nodes to lose line hierarchy when the tree structure changes (e.g., node added/removed/reordered).

1.1.0 24-03-2023

• Fix refresh issue on controller change
  • Author: @bambinoua (https://github.com/bambinoua)
• TreeController improvements
  • Added: breadthFirstSearch()
  • Added: expandAll(), collapseAll(), isTreeExpanded, isTreeCollapsed, areAllRootsExpanded, areAllRootsCollapsed
    • Co-Author: @bambinoua (https://github.com/bambinoua)

1.0.0 20-03-2023

⚠️ Warning: Major Rewrite

Please, treat this version as a whole new package. Migrating from previous versions is discouraged as the package went through a major rewrite and has many breaking changes.

---

Additions:

• Dynamic "TreeNode" modeling through callbacks
• IndentGuides indentation decorations API
• SliverTree and SliverAnimatedTree slivers
• AnimatedTreeView widget
• TreeEntry tree node details object

Changes:

• Renamed TreeViewController to TreeController
  • Removed: find(), shouldRefresh(), nodeRefreshed(), refreshNode(), reset(), nodeAt(), isVisible(), indexOf(), expandAll(), collapseAll(), useBinarySearch, rootNode, visibleNodes, expandedNodes
  • Renamed methods:
    • expandNode -> expand
    • collapseNode -> collapse
    • toggleExpanded -> toggleExpansion
    • expandSubtree -> expandCascading
    • collapseSubtree -> collapseCascading
    • expandUntil -> expandAncestors
    • isExpanded -> getExpansionState
  • Added: roots, childrenProvider(), setExpansionState(), rebuild(), depthFirstTraversal()
• NodeWidgetLeadingIcon was rewritten as FolderButton

Removals:

• Removed nodeHeight from TreeView (fixed height not required anymore)
• Removed TreeViewControllerBase
• Removed TreeNode and TreeNodeScope
• Removed NodeWidget as it was just a wrapper around InkWell + Row
• Removed ExpandNodeIcon as it was just a wrapper around ExpandIcon
• Removed TreeViewTheme, LinesWidget, LinesPainter and TreeLine in favor of the new IndentGuide + TreeIndentation API.

0.5.3+2 01-10-2022

• Update [NodeWidgetLeadingIcon] icon types from [Icon] to [Widget]
  • Author: @naory159 (https://github.com/naory159)

0.5.3+1 12-08-2022

• Fix rtl line painting bug
  • Author: @naory159 (https://github.com/naory159)

0.5.3 09-08-2022

• Add Right-to-Left support to line painting
  • Author: @naory159 (https://github.com/naory159)

0.5.2 29-06-2022

• Allow [TreeView.nodeHeight] to be nullable.
  • Author: @mz2 (https://github.com/mz2)

0.5.1+1 10-06-2021

• Fixes logic that marks nodes to refresh

  Before only child nodes were getting marked as needing refresh, causing the grand children and it's subtrees not to refresh, breaking lines hierarchy.

0.5.1 10-06-2021

• Adds new refreshNode Feature to [TreeViewController]

• Updates TreeNode's [delete] and [clearChildren] logic

• Adds linesToBeDrawn check in shouldRepaint of [LinesPainter]

• New example App UI

0.5.0 30-05-2021

Reverts most changes from 0.4.0

• Removing the TreeViewController made nodes inside a different page or in a drawer to lose their state.

  • TreeViewController is back, all logic from _TreeViewState got moved back to it.

• Merged the utils methods into TreeNode (ancestors, descendants, ...).

• The TreeView no longer auto scrolls nodes.

  • Now scrolling has to be done by the user.

0.4.0 17-05-2021

Simplification of the TreeView API.

• Dropped TreeViewController and merged it's logic into [TreeViewState] to make the code less 'spaghetti'. Instead of the controller, use a [GlobalKey

  • Made [TreeViewState] not private anymore.

• New scrolling functionality.

  • Added [scrollController] optional property to [TreeView].

  • Added [shouldAutoScroll] property to [TreeView].

  • Added [scrollTo] method to [TreeViewState].

• Renamed ScopedTreeNode to TreeNodeScope.

• Renamed InheritedTreeView to _TreeViewScope.

• Removed reversedSubtreeGenerator from utils.dart as it was not being used.

0.3.1 16-04-2021

• Implemented rounded corners for connected lines.

0.3.0 15-04-2021

• [ExpandNodeIcon] and [NodeWidgetLeadingIcon] are able to expand/collapse leaf nodes.

• [TreeNode.children] changed from [List] to [Set] to avoid duplicate children.

• The [TreeViewController] received a new callback.

  • The new onAboutToExpand is useful to dynamically populate the [TreeView].

• Some performance improvements when expanding/collapsing nodes.

0.2.1 11-04-2021

• Added useBinarySearch option to TreeViewController.

• Many performance improvements by reducing the amount of loops that expandNode and collapseNode took.

0.2.0 31-03-2021

• Stable null safety release.

• Refactoring of the entire API:

  • The old API was very "janky" with AnimatedList, TreeView now uses ListView.custom under the hood.

  • New InheritedTreeView inherited widget is used under the hood to get access to TreeViewController and TreeViewTheme from TreeView.of() method.

  • New ScopedTreeNode inherited widget, to get a TreeNode from anywhere under it in the widget tree, every TreeNode has its own ScopedTreeNode.

  • New NodeWidgetLeadingIcon for a folder/file icon approach.

  • The TreeViewController is now a ChangeNotifier, to talk to TreeView more easily.

  • TreeNode received a delete() method that removes it from the tree and clear its relationships.

• Extracted the main implementation of TreeViewController to a base class to be able to change the expansion of a node without notifying listeners.

  • Added some tests to TreeViewControllerBase.

• Updated NodeWidget to a Row instead of a ListTile

  • ListTile had some errors when using LinesWidget as leading.

• Dropped support for selecting/disabling nodes as it was getting very complicated and "hacky" to manage.

• Dropped TreeLine.link as it was complicating the indentation of nodes.

• Plus Many upgrades and fixes.

0.1.0-nullsafety.0 12-02-2021

• First release.