cascade_widget 3.0.3
cascade_widget: ^3.0.3 copied to clipboard
A versatile Flutter cascade selection widget, offering multi-level cascading dropdowns with single and multiple selection options. Ideal for web and desktop applications.
3.0.3 - 2025-11-19 #
Fixes #
- Component Exports: Ensured that all public components, including the new
SingleSelectWidget, are correctly exported from the main library file, making them available for import in other projects.
3.0.2 #
Fixes #
- Tap Outside Detection: Corrected the tap detection area for closing the popup (
onTapOutside), which was incorrect when the popup's height was dynamically adjusted for short lists.
3.0.1 - 2025-11-18 #
BREAKING CHANGES #
- Refactored
MultipleSelectWidget: The originalMultipleSelectWidgethas been split into two separate, more focused widgets:MultipleSelectWidget: Now exclusively handles multi-selection logic.SingleSelectWidget: A new widget dedicated to single-selection scenarios. TheisSingleChoiceparameter has been removed fromMultipleSelectWidget. Please useSingleSelectWidgetfor single-choice dropdowns.
Features #
- Upward Popup Display: The popup layer can now intelligently open upwards when there is not enough space below the widget.
- Single-Select Searchable Input: In single-select mode, the input field now displays the selected text and can be edited to search/filter the list. The dropdown is triggered by the suffix icon.
- Customizable Empty List Text: Added
emptyTextandemptyTextStyletoPopupConfigto allow customization of the message shown when the list is empty for both single and multiple select widgets.
Fixes #
- Adaptive Chip Width: The width of selection chips in
MultipleSelectWidgetis now adaptive and dynamically calculated, preventing layout overflow on smaller screens or with long text.
3.0.0 - 2025-11-14 #
BREAKING CHANGES #
- Refactored configuration classes for better separation of concerns.
- Moved layout-related properties (
isRow,maxHeight,minHeight,isShowAllSelectedLabel) into a newLayoutConfigclass. - Moved
isSingleChoiceandselectedIdsfromPopupConfigto be top-level properties on theMultipleSelectWidget. - Replaced the
disabledproperty inPopupConfigwith a top-levelenabledproperty on all widgets for better API clarity.
Features #
- Added a new
LayoutConfigclass to control the layout of the field. - Improved the example application with more use cases and a clearer, more organized UI.
Fixes #
- Addressed several linter warnings and deprecated API usages.
2.1.3 #
- Fixed known bugs.
- Updated example and fixed
PopScopedeprecation warning.
2.1.2 #
- Added option to show the full path in the selected tag for the single-select cascade widget.
2.1.1 #
- Improved the UI for the single-select widget.
2.1.0 #
- Added a new
SingleSelectCascadeWidget.
2.0.6 #
- Fixed known bugs.
2.0.5 #
- Added a modal overlay and an option to customize its color.
2.0.4 #
- Fixed issues with Tab key navigation, preventing multiple popups from opening.
2.0.3 #
- Exposed more properties for customizing the search input field.
2.0.2 #
- Fixed an issue with default selections in single and multi-select modes.
- Ensured the popup closes after an item is selected in single-choice mode.
2.0.0 #
- Refactored the popup configuration class.
- Fixed various UI bugs.
1.0.7 #
- Added an option to display all selected tags in the field.
- Added a disabled state for the widget.
- Added an option to show or hide the search input field.
- Improved the initialization logic for default selections.
1.0.6 #
- fix multiple_select bug.
1.0.5 #
Exposed the CascadeWidgetController. Then continue to optimize the current class.
1.0.4 #
fix bug
1.0.3 #
fix bug
1.0.2 #
add illustration gif
1.0.1 #
cascade_widget perfect the content
1.0.0 #
cascade_widget publish