Unclaimed project
Are you a maintainer of forui? Claim this project to take control of your public changelog and roadmap.
Changelog
Duobase's Flutter UI library
Last updated 23 days ago
This update overhauls the API by introducing controls to support declarative state and adding support for the new dot-shorthand syntax.
To simplify updating to the latest version, we've included Data Driven Fixes.
This allows you to run automated fixes on your codebase to update it to be compatible with the latest version of forui.
After updating to the latest version, run:
dart fix --apply
FAccordionAdd FAccordionControl.
Remove . Use instead.
FAccordion.controllerFAccordion(control: .managed(...))Fix FAccordionItem not being properly disposed.
FAutocompleteAdd FAutocomplete.popoverControl.
Add FAutocompleteControl.
Add FAutocompleteItemMixin.item(...).
Add FAutocompleteItemMixin.raw(...).
Add FAutocompleteItemMixin.section(...).
Add FAutocompleteItemMixin.richSection(...).
Add FAutocompleteItem.item(...).
Add FAutocomplete.contentGroupId.
Breaking Rename FAutocomplete.anchor to FAutocomplete.contentAnchor.
Breaking Rename FAutocomplete.popoverConstraints to FAutocomplete.contentConstraints.
Breaking Rename FAutocomplete.spacing to FAutocomplete.contentSpacing.
Breaking Rename FAutocomplete.shift to FAutocomplete.contentOverflow.
Breaking Rename FAutocomplete.offset to FAutocomplete.contentOffset.
Breaking Rename FAutocomplete.hideRegion to FAutocomplete.contentHideRegion.
Breaking Rename FAutocomplete.onTapHide to FAutocomplete.contentOnTapHide.
Breaking Remove FAutocomplete.controller. Use FAutocomplete(control: .managed(...)) instead.
Breaking Remove FAutocomplete.initialText. Use FAutocomplete(control: .managed(...)) instead.
Breaking Remove FAutocompleteController.vsync. Use FAutocomplete(popoverControl: ...) instead.
Breaking Remove FAutocompleteController.popoverMotion. Use FAutocomplete(popoverControl: .managed(motion: ...)) instead.
Breaking Remove FAutocompleteController.content. Use FAutocomplete(popoverControl: .managed(controller: ...)) instead.
Breaking Remove FAutocompleteControl.lifted(popoverShown: ...). Use FAutocomplete(popoverControl: .lifted(...)) instead.
Breaking Remove FAutocompleteControl.lifted(onPopoverChange: ...). Use FAutocomplete(popoverControl: .lifted(...)) instead.
Breaking Remove FAutocompleteControl.lifted(motion: ...). Use FAutocomplete(popoverControl: .managed(motion: ...)) instead.
Breaking Remove FAutocompleteControl.managed(motion: ...). Use FAutocomplete(popoverControl: .managed(motion: ...)) instead.
Breaking Change FAutocompleteContentStyle to extend FPopoverStyle.
Breaking Remove FAutocompleteStyle.popoverStyle - use FAutocompleteStyle.contentStyle instead.
FBottomNavigationBarAdd FBottomNavigationBar.safeAreaTop.
Add FBottomNavigationBar.safeAreaBottom.
Change FBottomNavigationBarItem.label to be optional.
FBreadcrumbFBreadcrumb.shift to FBreadcrumb.overflow.FBreadcrumbItem.collapsed(popoverController: ...). Use FBreadcrumbItem.collapsed(popoverControl: .managed(...)) instead.FBreadcrumbItem.collapsedTiles(popoverController: ...). Use FBreadcrumbItem.collapsedTiles(popoverControl: .managed(...)) instead.FCalendarUnfortunately, FCalendar cannot be easily migrated using data driven fixes due to the complexity of its API changes.
Add FCalendarControl.
Breaking Rename FCalendarController.date(initialSelection: ...) to FCalendarController.date(initial: ...).
Breaking Rename FCalendarController.dates(initialSelections: ...) to FCalendarController.dates(initial: ...).
Breaking Rename FCalendarController.range(initialSelection: ...) to FCalendarController.range(initial: ...).
Breaking Remove FCalendar.controller. Use FCalendar(control: .managedDate(...)) instead.
FCardFCard.mainAxisSize, which defaults to MainAxisSize.min.FCheckboxFCheckbox.grouped(...). Use FSelectGroupItemMixin.checkbox(...) instead.FDateFieldAdd FDateFieldControl.
Add FDateField(popoverControl: ...).
Add FDateField.calendar(popoverControl: ...).
Add FDateField.calendar(groupId: ...).
Add FDateFieldCalendarProperties.groupId.
Change FDateField's input to preserve text selection when changing dates programmatically or via the calendar.
Breaking Rename FDateField.shift to FDateField.overflow.
Breaking Rename FDateFieldCalendarProperties.inputAnchor to FDateFieldCalendarProperties.fieldAnchor.
Breaking Rename FDateField.calendar(inputAnchor: ...) to FDateField.calendar(fieldAnchor: ...).
Breaking Rename FDateFieldController.calendar to FDateFieldController.popover.
Breaking Rename FDateFieldController(initialDate: ...) to FDateFieldController(date: ...).
Breaking Remove FDateField.controller. Use FDateField(control: .managed(controller: ...)) instead.
Breaking Remove FDateField.initialDate. Use FDateField(control: .managed(initial: ...)) instead.
Breaking Remove FDateField.onChange. Use FDateField(control: .managed(onChange: ...)) instead.
Breaking Remove FDateFieldController(vsync: ..., popoverMotion: ...). Use FDateField(popoverControl: ...) instead.
Breaking Remove FDateFieldController(truncateAndStripTimezone: ...).
FItem & FItemGroupFItemMixin.tile(...).FItemMixin.raw(...).FItemGroup.group(...).FItemGroupMixin.group(...).FItemGroupMixin.builder(...).FItemGroupMixin.merge(...).FLineCalendarAdd FLineCalendarControl.
Breaking Remove FLineCalendar.controller. Use FLineCalendar(control: .managed(controller: ...)) instead.
Breaking Remove FLineCalendar.initialSelection. Use FLineCalendar(control: .managed(initial: ...)) instead.
Breaking Remove FLineCalendar.onChange. Use FLineCalendar(control: .managed(onChange: ...)) instead.
Breaking Remove FLineCalendar.toggleable. Use FLineCalendar(control: .managed(toggleable: ...)) instead.
Fix FLineCalendar not respecting FCalendarcontroller.selectable.
FPaginationAdd FPaginationControl.
Breaking Remove FPagination.controller. Use FPagination(control: .managed(controller: ...)) instead.
Breaking Remove FPagination.initialPage. Use FPagination(control: .managed(initialPage: ...)) instead.
Breaking Remove FPagination.pages. Use FPagination(control: .managed(pages: ...)) instead.
Breaking Remove FPagination.onChange. Use FPagination(control: .managed(onChange: ...)) instead.
Breaking Change FPaginationController to extend ValueNotifier<int> instead of FChangeNotifier.
Breaking Rename FPaginationController(initialPage: ...) to FPaginationController(page: ...).
Breaking Rename FPaginationController.page to FPaginationController.value.
FPickerAdd FPickerControl.
Add FPickerController.animateTo(...).
Breaking Rename FPickerController(initialIndexes: ...) to FPickerController(indexes: ...).
Breaking Remove FPicker.controller. Use FPicker(control: .managed(...)) instead.
Breaking Remove FPicker.onChange. Use FPicker(control: .managed(...)) instead.
FPopoverAdd FPopoverControl.
Add FPopoverController.shown.
Breaking Change FPopover.shift to FPopover.overflow.
Breaking Remove FPopover.controller. Use FPopover(control: .managed(...)) instead.
Fix FPopover not interrupting ongoing animations when toggled again.
FPopoverMenuFPopoverMenu.shift to FPopoverMenu.overflow.FPopoverMenu.popoverController. Use FPopoverMenu(control: .managed(...)) instead.FPortalAdd FPortalSpacing.spacing(...).
Breaking Rename FPortalBox to FPortalRect.
Breaking Rename FPortalChildBox to FPortalChildRect.
Breaking Rename FPortalShift to FPortalOverflow.
Breaking Change FPortalShift from a function to a class. While this makes custom shift implementations slightly
more verbose, it allows the consts to synergize with dot shorthands.
Breaking Rename FPortalShift.along to FPortalShift.slide.
Breaking Rename FPortal.shift to FPortal.overflow.
Breaking Rename FPortalSpacing.resolve to FPortalSpacing.call.
FRadioFRadio.grouped(...). Use FSelectGroupItemMixin.radio(...) instead.FResizableAdd FResizable.region(...).
Add FResizableControl.
Add FResizableManagedControl.
Breaking Remove FResizable.controller. Use FResizable(control: .managed(...)) or FResizable(control: .managedCascade(...)) instead.
Breaking Remove FResizable.onChange. Use FResizable(control: .managed(...)) instead.
FSelect & FMultiSelectAdd FSelectControl.
Add FSelectItemMixin.item(...).
Add FSelectItemMixin.raw(...).
Add FSelectItemMixin.section(...).
Add FSelectItemMixin.richSection(...).
Add FSelectItem.item(...).
Add FSelect.contentGroupId.
Add FMultiSelect.contentGroupId.
Breaking Rename FSelect.anchor to FSelect.contentAnchor.
Breaking Rename FSelect.popoverConstraints to FSelect.contentConstraints.
Breaking Rename FSelect.spacing to FSelect.contentSpacing.
Breaking Rename FSelect.shift to FSelect.contentOverflow.
Breaking Rename FSelect.offset to FSelect.contentOffset.
Breaking Rename FSelect.hideRegion to FSelect.contentHideRegion.
Breaking Remove FSelect.controller. Use FSelect(control: .managed(...)) instead.
Breaking Remove FSelect.onChange. Use FSelect(control: .managed(...)) instead.
Breaking Remove FSelect.initialValue. Use FSelect(control: .managed(...)) instead.
Breaking Remove FSelectController(vsync: ..., popoverMotion: ...). Use FSelect(popoverControl: ...) instead.
Breaking Remove FSelectSearchFieldProperties.controller. Use FSelectSearchFieldProperties(control: .managed(...)) instead.
Breaking Rename FMultiSelect.anchor to FMultiSelect.contentAnchor.
Breaking Rename FMultiSelect.popoverConstraints to FMultiSelect.contentConstraints.
Breaking Rename FMultiSelect.spacing to FMultiSelect.contentSpacing.
Breaking Rename FMultiSelect.shift to FMultiSelect.contentOverflow.
Breaking Rename FMultiSelect.offset to FMultiSelect.contentOffset.
Breaking Rename FMultiSelect.hideRegion to FMultiSelect.contentHideRegion.
Breaking Remove FMultiSelect.controller. Use FMultiSelect(control: .managed(...)) instead.
Breaking Remove FMultiSelect.onChange. Use FMultiSelect(control: .managed(...)) instead.
Breaking Remove FMultiSelect.initialValue. Use FMultiSelect(control: .managed(...)) instead.
Breaking Remove FMultiSelect.min. Use FMultiSelect(control: .managed(...)) instead.
Breaking Change FSelectContentStyle to extend FPopoverStyle.
Breaking Remove FSelectStyle.popoverStyle - use FSelectStyle.contentStyle instead.
Breaking Remove FMultiSelectStyle.popoverStyle - use FMultiSelectStyle.contentStyle instead.
Breaking Remove FMultiSelect.max. Use FMultiSelect(control: .managed(...)) instead.
Breaking Remove FMultiSelectController. Use FMultiValueNotifier instead.
Fix FSelect.mouseCursor defaulting to SystemMouseCursors.click instead of MouseCursor.defer.
Deprecate FSelect.contentScrollHandles. Please open an issue if you use & and need this.
FSelectGroup & FSelectTileGroupAdd FSelectGroupItemMixin.checkbox(...).
Add FSelectGroupItemMixin.radio(...).
Breaking Remove FSelectGroup.controller. Use FSelectGroup(control: .managed(...)) instead.
Breaking Remove FSelectGroup.onChange. Use FSelectGroup(control: .managed(...)) instead.
Breaking Remove FSelectGroup.onSelect.
Breaking Remove FSelectGroupController. Use FMultiValueNotifier instead.
Breaking Rename FSelectGroupItem to FSelectGroupItemMixin.
FSelectMenuTileAdd FSelectMenuTile.menuGroupId.
Breaking Rename FSelectMenuTile.shift to FSelectMenuTile.menuOverflow.
Breaking Rename FSelectMenuTile.spacing to FSelectMenuTile.menuSpacing.
Breaking Rename FSelectMenuTile.offset to FSelectMenuTile.menuOffset.
Breaking Rename FSelectMenuTile.hideRegion to FSelectMenuTile.menuHideRegion.
Breaking Rename FSelectMenuTile.onTapHide to FSelectMenuTile.menuOnTapHide.
Breaking Rename FSelectMenuTile.focusNode to FSelectMenuTile.menuFocusNode.
Breaking Rename FSelectMenuTile.onFocusChange to FSelectMenuTile.menuOnFocusChange.
Breaking Rename FSelectMenuTile.traversalEdgeBehavior to FSelectMenuTile.menuTraversalEdgeBehavior.
Breaking Rename FSelectMenuTile.barrierSemanticsLabel to FSelectMenuTile.menuBarrierSemanticsLabel.
Breaking Rename FSelectMenuTile.barrierSemanticsDismissible to FSelectMenuTile.menuBarrierSemanticsDismissible.
Breaking Remove FSelectMenuTile.selectController. Use FSelectMenuTile(selectControl: .managed(...)) instead.
Breaking Remove FSelectMenuTile.popoverController. Use FSelectMenuTile(popoverControl: .managed(...)) instead.
Breaking Remove FSelectMenuTile.onChange. Use FSelectMenuTile(selectControl: .managed(...)) instead.
Breaking Remove FSelectMenuTile.initialValue. Use FSelectMenuTile(selectControl: .managed(...)) instead.
Breaking Remove FSelectMenuTile.onSelect.
Breaking Remove FSelectMenuTileController. Use FMultiValueNotifier instead.
FSelectTileGroupFSelectTileGroupController. Use FMultiValueNotifier instead.FSelectGroupController. Use FMultiValueNotifier instead.FSelectTileGroup.selectController. Use FSelectTileGroup(control: .managed(...)) instead.FSelectTileGroup.onChange. Use FSelectTileGroup(control: .managed(...)) instead.FSelectTileGroup.onSelect.FScaffoldFToaster from FScaffold. This was causing toasts to be cleared when switching between pages.
Use FToaster directly instead.FSheetshowFSheet(resizeToAvoidBottomInset: ...). Set to false to restore previous behavior.showFPersistentSheet(resizeToAvoidBottomInset: ...). Set to false to restore previous behavior.FModalSheetRoute.resizeToAvoidBottomInset. Set to false to restore previous behavior.FSliderAdd FSlider.onEnd.
Add FSliderMark.mark(...).
Add FSliderControl.
Add FSliderManagedControl.
Breaking Rename FSliderSelection to FSliderValue.
Breaking Remove FSliderController.tooltips. Use FSlider.tooltipControls. instead.
Breaking Remove FSliderTooltipsController. Use FSliderTooltipControls instead.
Breaking Remove FSlider.controller. Use FSlider(control: .managed(...)) instead.
Breaking Remove FSlider.onChange. Use FSlider(control: .managed(...)) instead.
Breaking Remove FSlider.initialSelection. Use FSlider(control: .managed(...)) instead.
FTabsAdd FTabControl.
Add FTabEntry.entry(...).
Add FTabs.mouseCursor.
Breaking Remove FTabs.controller. Use FTabs(control: .managed(...)) instead.
Breaking Remove FTabs.initialIndex. Use FTabs(control: .managed(...)) instead.
Breaking Remove FTabs.onChange. Use FTabs(control: .managed(...)) instead.
Breaking Rename FTabController(initialIndex: ...) to FTabController(index: ...).
FTappableFTappable to only update focused state when it has primary focus.FTextFieldAdd FFieldClearIconBuilder.
Add FObscureTextControl.
Add FTextFieldControl.
Add FTextField.control.
Add FTextField.clearIconBuilder.
Add FTextField.password.clearIconBuilder.
Add FTextFormField.control.
Breaking Remove FTextField.controller. Use FTextField(control: .managed(...)) instead.
Breaking Remove FTextField.onChange. Use FTextField(control: .managed(...)) instead.
Breaking Remove FTextField.initialText. Use FTextField(control: .managed(...)) instead.
Breaking Remove FTextFormField.controller. Use FTextFormField(control: .managed(...)) instead.
Breaking Remove FTextFormField.onChange. Use FTextFormField(control: .managed(...)) instead.
Breaking Remove FTextFormField.initialText. Use FTextFormField(control: .managed(...)) instead.
Breaking Remove FTextField.password(obscureTextController: ...). Use FTextField.password(obscureTextControl: ...) instead.
Breaking Remove FTextFormField.password(obscureTextController: ...). Use FTextFormField.password(obscureTextControl: ...) instead.
FTile & FTileGroupAdd FTileMixin.selectMenu(...).
Add FTileMixin.selectMenuFromMap(...).
Add FTileMixin.selectMenuBuilder(...).
Add FTileMixin.tile(...).
Add FTileMixin.raw(...).
Add FTileGroupMixin.selectGroup(...).
Add FTileGroupMixin.selectGroupBuilder(...).
Add FTileGroupMixin.group(...).
Add FTileGroupMixin.builder(...).
Add FTileGroupMixin.merge(...).
Breaking Remove FTileMixin.selectMenu(selectController: ...). Use FTileMixin.selectMenu(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenu(popoverController: ...). Use FTileMixin.selectMenu(popoverControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenu(onChange: ...). Use FTileMixin.selectMenu(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenu(onSelect: ...).
Breaking Remove FTileMixin.selectMenu(initialValue: ...). Use FTileMixin.selectMenu(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuFromMap(selectController: ...). Use FTileMixin.selectMenuFromMap(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuFromMap(popoverController: ...). Use FTileMixin.selectMenuFromMap(popoverControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuFromMap(onChange: ...). Use FTileMixin.selectMenuFromMap(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuFromMap(onSelect: ...).
Breaking Remove FTileMixin.selectMenuFromMap(initialValue: ...). Use FTileMixin.selectMenuFromMap(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuBuilder(selectController: ...). Use FTileMixin.selectMenuBuilder(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuBuilder(popoverController: ...). Use FTileMixin.selectMenuBuilder(popoverControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuBuilder(onChange: ...). Use FTileMixin.selectMenuBuilder(selectControl: .managed(...)) instead.
Breaking Remove FTileMixin.selectMenuBuilder(onSelect: ...).
Breaking Remove FTileMixin.selectMenuBuilder(initialValue: ...). Use FTileMixin.selectMenuBuilder(selectControl: .managed(...)) instead.
Breaking Remove FTileGroupMixin.selectGroup(selectController: ...). Use FTileGroupMixin.selectGroup(control: .managed(...)) instead.
Breaking Remove FTileGroupMixin.selectGroup(onChange: ...). Use FTileGroupMixin.selectGroup(control: .managed(...)) instead.
Breaking Remove FTileGroupMixin.selectGroup(onSelect: ...).
Breaking Remove FTileGroupMixin.selectGroupBuilder(selectController: ...). Use FTileGroupMixin.selectGroupBuilder(control: .managed(...)) instead.
Breaking Remove FTileGroupMixin.selectGroupBuilder(onChange: ...). Use FTileGroupMixin.selectGroupBuilder(control: .managed(...)) instead.
Breaking Remove FTileGroupMixin.selectGroupBuilder(onSelect: ...).
FTimeFieldAdd FTimeFieldControl.
Add FTimeField.picker(groupId: ...).
Breaking Rename FTimeField.shift to FTimeField.overflow.
Breaking Rename FTimeField.picker(inputAnchor: ...) to FTimeField.picker(fieldAnchor: ...).
Breaking Move FTimeFieldStyle.popoverConstraints to FTimeField.picker(constraints: ...).
Breaking Remove FTimeField.controller. Use FTimeField(control: .managed(...)) instead.
Breaking Remove FTimeField.onChange. Use FTimeField(control: .managed(...)) instead.
Breaking Remove FTimeField.initialTime. Use FTimeField(control: .managed(...)) instead.
Breaking Remove FTimeFieldController(vsync: ..., popoverMotion: ...). Use FTimeField(popoverControl: ...) instead.
Breaking Rename FTimeFieldController(initialTime: ...) to FTimeFieldController(time: ...).
FTimePickerAdd FTimePickerControl.
Breaking Remove FTimePicker.controller. Use FTimePicker(control: .managed(...)) instead.
Breaking Remove FTimePicker.onChange. Use FTimePicker(control: .managed(...)) instead.
Breaking Rename FTimePickerController(initial: ...) to FTimePickerController(time: ...).
Fix FTimePickerController.animateTo(...) not working with period-first locales (e.g. Korean).
FTooltipAdd FTooltipControl.
Add FTooltipController.shown.
Change FTooltip to not be focusable.
Change FTooltip's focus-triggered behavior to only show if its immediate focusable descendant has primary focus.
Breaking Rename FTooltip.shift to FTooltip.overflow.
Breaking Remove FTooltip.controller. Use FTooltip(control: .managed(...)) instead.
Fix FTooltip not interrupting ongoing animations when toggled again.
FToastFToasterMotion.collapseCurve's default value from easeOutCubic to easeOut.Add FMultiValueControl.
Add FTypeaheadController.fromValue(...).
Add FTypeheadTextStyles.
Breaking Remove FSidebar.width. This field was never intended for public usage - Use FSidebarStyle.constraints
instead.
Deprecate FValueNotifier. Please open an issue if there's a use-case that isn't covered.
Deprecate FValueNotifier.addValueListener(...). Please open an issue if there's a use-case that isn't covered.
Deprecate FValueNotifier.removeValueListener(...). Please open an issue if there's a use-case that isn't covered.
Deprecate FMultiValueNotifier.addUpdateListener(...). Please open an issue if there's a use-case that isn't covered.
Deprecate FMultiValueNotifier.removeUpdateListener(...). Please open an issue if there's a use-case that isn't covered.
Fix generated style docs being malformed.
An open-source cross-platform alternative to AirDrop
Bring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.
A multi-platform proxy client based on ClashMeta,simple and easy to use, open-source and ad-free.
🎧 Open source music streaming app! Available for both desktop & mobile!