pub.dev · #4689 most downloaded on pub.dev

tabbed_view

3.1.03.4K downloads/mocaduandrade/tabbed_view ↗New releases in your daily digest, changelog included.

Flutter widget inspired by the classic Desktop-style tab component. Supports customizable themes.

Last release 6 months ago
07 Apr 2026
Release timing varies
gaps range from 2 weeks to 1.1 years
Nearly every release is documented
notes for 50 of 50 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
64 releases · first in 2021

Release timeline

64 releases since 2021

202120222023202420252026

20212026

One column per quarter.

Releases

3.1.07 Apr 2026
Adding the TabLabelBuilder typedef. #73
Updating dev workbench. #73

Adding the TabLabelBuilder typedef. #73

Using the label builder in TabHeaderWidget. #73

Overring the text with label builder. #73

Updating the CHANGELOG and reverting dev example. #73

Updating github actions. #73
Open source →
Additional notes2 sources agree
TabData

Added listenable and textProvider for reactive UI updates.

Added labelBuilder to allow custom label widget creation instead of using the internally generated widget from text.

TabsAreaThemeData

Added padding property.

Added lastVisibleTabBehavior to configure how the last remaining tab behaves when there is no space available.

LastVisibleTabBehavior

New enum with two modes: hide (moves the tab to the overflow menu) and shrink (keeps the tab visible by reducing its width).

Bugfix

TabsAreaCrossAxisAlignment

Enum was not exported.

3.0.023 Mar 2026

OnTabSelection parameter change. #68

OnTabSelection parameter change. #68
Replacing the use of the controller with a delegate within the widgets.
Declarative callbacks. #68
Reorder action #68
Simplifying the delegate. #68
Fixing imports. #68
Selection action. #68
Changing default minimalist theme padding. #68
Selected tab getter. #68
Creating an isolated class for the delegate. #68
Removing controller property from TabbedView. #68
Updating doc. #68
Separating the drag action into 3 callbacks. #68
Using TabData itself in viewBuilder. #68
Clearing the example. #68
Removing wrong class hide. #68
Updating CHANGELOG version. #68
Renaming content to view. #68
Updating CHANGELOG version. #68
Using the TabData reference in the declarative constructor callbacks.
Renaming normal TabStatus value to unselected. #68
Version 3.0.0 #68
Formating. #68

Open source →

Additional notes2 sources agree

TabDecoration
- Added support for custom tab shape.
TabbedViewThemeData
- Added a new predefined theme: folder.
TabThemeData
- Added a maxLines parameter to allow text wrapping in tab labels, specifically designed to work in conjunction with maxMainSize constraints.
TabStyleResolver
- Added to provides per-tab style overrides on top of a TabThemeData.
- Added support for changing the tab background color in some predefined themes.
TabbedView
- Added TabbedView.declarative constructor for declarative (external state) usage.

Breaking Changes

TabbedView
- Renamed contentBuilder property to viewBuilder.
  - Updated property type from IndexedWidgetBuilder to TabViewBuilder.
  - Now receives TabData instead of tab index.
TabData
- Added required id property to uniquely identify tabs.
- Hid key and uniqueKey properties from the public API.
- Updated value property type from dynamic to Object?.
- Renamed content property to view.
- Per-tab styling overrides have been moved from TabData to TabThemeData.
  - The following properties were removed from TabData:
    - normalStatusTheme
    - selectedStatusTheme
    - hoveredStatusTheme
TabStatus
- Renamed normal value to unselected.
TabDecorationBuilder
- Replaced TabStatus parameter with TabStyleContext.
OnDraggableBuild
- Removed controller parameter.
CanDrop
- Removed target parameter.
OnBeforeDropAccept
- Removed target parameter.
OnTabSelection
- Renamed to OnTabSelected.
- Updated callback signature from (int? tabIndex, TabData? tabData) to (TabSelection? selection).
OnTabRemove
- Renamed to OnTabRemoved.
OnTabReorder
- Renamed to OnTabMoved.
TabbedViewController
- Renamed onTabSelection property to onTabSelected.
- Renamed onTabRemove property to onTabRemoved.
- Renamed onTabReorder property to onTabReordered.
DraggableData
- Renamed to DraggableTabData.
- Removed controller property.
- Renamed tabData property to tab.

3.0.0-rc.322 Mar 2026pre-release

Nothing published for this version

3.0.0-rc.222 Mar 2026pre-release

Nothing published for this version

3.0.0-rc.122 Mar 2026pre-release

Nothing published for this version

2.1.021 Dec 20252 sources agree

* TabData * Added the tooltip property.

TabData
- Added the tooltip property.

Open source →

2.0.016 Sept 20252 sources agree

Removed the hiddenTabsMenuItemBuilder property.

TabbedView
- Removed the hiddenTabsMenuItemBuilder property.
- Removed the tabSelectInterceptor property.
TabbedViewController
- Moved reorderEnable property to TabbedView.
- Moved onReorder property to TabbedView.
- New methods:
  - selectTab(TabData tab)
  - getTabByValue(dynamic value)
  - selectTabByValue(dynamic value)
TabStatus
- Renamed highlighted value to hovered.
TabData
- Renamed and refactored buttons property to buttonsBuilder to use the builder pattern.
TabButton
- The constructor was replaced by two separate constructors: TabButton.icon and TabButton.menu.
TabRemoveInterceptor
- ̀Added the BuildContext parameter.
OnTabSelection
- ̀Added the tabData parameter.
Theme
- Refactored theming system to fully support all tab bar positions (top, bottom, left, right).
  - Added TabBarPosition enum to represent the bar positions.
  - Added SideTabsLayout to define how side-positioned tabs (left or right) are laid out (rotated or stacked).
- Renamed Mobile theme to Underline
- Removed Dark theme.
- Added brightness support.
- The theme data classes are now mutable.
- TabbedViewThemeData
  - New properties:
    - divider: The border that separates the content area from the tab bar.
- TabsAreaThemeData
  - Renamed normalButtonColor property to buttonColor.
  - Renamed hoverButtonColor property to hoveredButtonColor.
  - Renamed hoverButtonBackground property to hoveredButtonBackground.
  - Allowed null hoveredButtonColor to inherit default color.
  - New properties:
    - crossAxisFit: Defines how the cross axis will fit within the tabs area.
    - crossAxisAlignment: Defines the alignment of tabs in relation to the main content.
    - tabHeaderExtentSize: Defines how tab headers are sized relative to each other along their extent.
  - Removed properties:
    - gapBottomBorder
    - gapSideBorder̀
- TabStatusThemeData
  - Renamed normalButtonColor property to buttonColor.
  - Renamed hoverButtonBackground property to hoveredButtonBackground.
- TabThemeData
  - Renamed highlightedStatus property to hoveredStatus.
  - Renamed normalButtonColor property to buttonColor.
  - Renamed hoverButtonColor property to hoveredButtonColor.
  - Renamed hoverButtonBackground property to hoveredButtonBackground.
  - Allowed null hoveredButtonColor to inherit default color.
- TabThemeData and TabStatusThemeData
  - Removed properties:
    - innerBottomBorder
    - innerTopBorder
    - decoration
    - margin
  - New properties:
    - decorationBuilder: A builder for creating complex and composable tab decorators.
    - maxMainSize: The maximum main size of the tab.
    - sideTabsLayout: Define how side-positioned tabs (left or right) are laid out.
- ContentAreaThemeData
  - New properties:
    - border: The border around the outer side of the tab content area, excluding the side adjacent to the tabs.
    - borderRadius: The radius used to round the corners.
- Replaced HiddenTabsMenuThemeData with TabbedViewMenuThemeData.
Special thanks to Patrick Legacy for his great contributions to this release.

Open source →

2.0.0-rc.1116 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.1015 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.914 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.812 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.76 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.61 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.51 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.41 Sept 2025pre-release

Nothing published for this version

2.0.0-rc.329 Aug 2025pre-release

Nothing published for this version

2.0.0-rc.229 Aug 2025pre-release

Nothing published for this version

2.0.0-rc.129 Aug 2025pre-release

Nothing published for this version

1.22.122 Aug 2025

Making the layout rebuild itself when TabData.text is changed. #55

Open source →

Additional notes2 sources agree

Bugfix
- Tab width doesn't grow to fit the new title set by TabData.text.

Open source →

1.22.015 Aug 2025

Removing unnecessary imports.

Open source →

Additional notes2 sources agree

TabData
- Added the ability to override tab themes.

Open source →

1.21.020 Jun 20252 sources agree

Providing TabData in tabCloseInterceptor.

TabbedView
- Providing TabData in tabCloseInterceptor.
- Adding dragScope for drag rejection.

Open source →

1.20.025 May 20252 sources agree

Added support for asynchronous tab close interception in `TabCloseInterceptor.

Added support for asynchronous tab close interception in `TabCloseInterceptor.

Open source →

1.19.126 Oct 20242 sources agree

* Bugfix * Error setting text size

Bugfix
- Error setting text size

Open source →

1.19.026 Oct 20243 sources agree

Allows you to define a maximum width for the tab text. #34

Open source →

1.18.126 Oct 20242 sources agree

Fields in hidden tabs continue to receive focus when pressing TAB.

Bugfix
- Fields in hidden tabs continue to receive focus when pressing TAB.

Open source →

1.18.08 Sept 20232 sources agree

Highlighting the tab's drop position.

Highlighting the tab's drop position.
Allow dragging to reorder tabs to the last position.
Allow dragging tabs between different TabbedView instances.
Bugfix
- Incorrect state for the index of the highlighted tab after being closed.

Changes

Change in the signature of OnDraggableBuild.
- From: (int tabIndex, TabData tabData)
- To: (TabbedViewController controller, int tabIndex, TabData tabData)
Draggable will always be DraggableData type: Draggable<DraggableData>
TabsAreaThemeData
- New property: dropColor.

Open source →

1.17.019 May 20232 sources agree

The draggableTabBuilder has been replaced by onDraggableBuild

Tab reordering
TabbedViewController
- New methods
  - setTabs
  - reorderTab
  - selectedTab
- New property: reorderEnable
New callback: OnReorder
TabThemeData
- New properties
  - draggingDecoration
  - draggingOpacity
TabData
- New property: draggable
New class: DraggableConfig
New typedef: OnDraggableBuild
TabbedView
- The draggableTabBuilder has been replaced by onDraggableBuild
  - Automatic creation of a Draggable<TabData>
TabData
- The uniqueKey property has been renamed to key.
Minimum sdk version required: 2.19.0

Migrating custom drag feedback

From:

    TabbedView tabbedView = TabbedView(
        controller: _controller,
        draggableTabBuilder: (int tabIndex, TabData tab, Widget tabWidget) {
          return Draggable<String>(
              child: tabWidget,
              feedback: Material(
                  child: Container(
                      child: Text(tab.text),
                      padding: EdgeInsets.all(4),
                      decoration: BoxDecoration(border: Border.all()))),
              data: tab.text,
              dragAnchorStrategy: (Draggable<Object> draggable,
                  BuildContext context, Offset position) {
                return Offset.zero;
              });
        });

To:

    TabbedView tabbedView = TabbedView(
        controller: _controller,
        onDraggableBuild: (int tabIndex, TabData tabData) {
          return DraggableConfig(
              feedback: Container(
                  child: Text(tabData.text),
                  padding: EdgeInsets.all(4),
                  decoration: BoxDecoration(border: Border.all())));
        });

Open source →

1.16.0+129 Jan 2023Deprecated2 sources agree

Removing the use of deprecated constructor.

Removing the use of deprecated constructor.

Open source →

1.16.016 Jan 20232 sources agree

* Tab leading widget

Tab leading widget

Open source →

1.15.020 Nov 20222 sources agree

ContentAreaThemeData.decorationNoTabsArea

Adding properties
- TabbedView.tabsAreaVisible
- TabsAreaThemeData.visible
- ContentAreaThemeData.decorationNoTabsArea
Bugfix
- Implementing hashCode and == of the theme data.

Open source →

1.14.0+130 Oct 2022Deprecated2 sources agree

Stopping using deprecated hashValues method.

Stopping using deprecated hashValues method.

Open source →

1.14.03 Oct 20222 sources agree

Renaming MenuThemeData to TabbedViewMenuThemeData

Renaming MenuThemeData to TabbedViewMenuThemeData
- Avoiding conflict with next Flutter version.

Open source →

1.13.0+125 May 20222 sources agree

* Formatting code.

Formatting code.

Open source →

1.13.08 May 20222 sources agree

Adding interceptor for tab selection.

Adding interceptor for tab selection.

Open source →

1.12.018 Mar 20222 sources agree

Adding getTabByIndex method in TabbedViewController.

Adding getTabByIndex method in TabbedViewController.
Allowing update the following TabData properties: buttons, closable, content, text and value.

Open source →

1.11.113 Mar 20222 sources agree

Removing theme settings values equal to inherited ones

Bugfix
- Removing theme settings values equal to inherited ones
  - Mobile theme
    - tab.highlightedStatus.decoration
    - tab.selectedStatus.decoration

Open source →

1.11.06 Mar 20222 sources agree

Removing unused argument normalStatus from TabThemeData.

Removing unused argument normalStatus from TabThemeData.
paddingWithoutButton setting in TabThemeData and TabStatusThemeData

Open source →

1.10.0+110 Feb 20222 sources agree

* Removing unnecessary imports

Removing unnecessary imports

Open source →

1.10.026 Sept 20212 sources agree

ButtonColors has been split into normalButtonColor, hoverButtonColor and disabledButtonColor

API change
- ButtonColors has been split into normalButtonColor, hoverButtonColor and disabledButtonColor
- New buttons theme configurations:
  - buttonPadding, normalButtonBackground, hoverButtonBackground and disabledButtonBackground
Default themes have been changed to use buttons decoration
Bug fix
- Selected tab not being painted on top
- Changed mouse cursor over selected tab

Open source →

1.9.029 Aug 20212 sources agree

Padding added to path icons to conform to Material Design standards

Padding added to path icons to conform to Material Design standards
- Gap of the buttons removed from the default themes
API change
- IconProvider to hold an IconPath or an IconData in the themes and TabButton

Open source →

1.8.0+129 Aug 20212 sources agree

* README update

README update

Open source →

1.8.029 Aug 20212 sources agree

Default themes adjustments, such as gaps and paddings

New icons
Default themes adjustments, such as gaps and paddings
buttonsGap setting in TabsAreaThemeData
IconPath to be used in icons drawing
iconSize setting in TabButton
API changes
- minimalIconSize and defaultIconSize constants moved from TabbedViewThemeData to TabbedViewThemeConstants
- ButtonsAreaThemeData properties moved to TabsAreaThemeData
- TabButton
  - icon parameter renamed to iconData
- TabsAreaThemeData
  - closeButtonIcon renamed to closeIconData
  - hiddenTabsMenuButtonIcon renamed to menuIconData
  - tab property moved to TabbedViewThemeData
  - closeIconData property moved to TabThemeData
  - closeIconPath property moved to TabThemeData

Open source →

1.7.023 Aug 20212 sources agree

* TabButton padding

TabButton padding

Open source →

1.6.020 Aug 20212 sources agree

menuBuilder has been removed from TabbedViewController

API changes
- menuBuilder has been removed from TabbedViewController
Bug fix
- Error building menu with empty list of TabbedViewMenuItem

Open source →

1.5.019 Aug 20212 sources agree

OnTabClosing typedef renamed to TabCloseInterceptor

API changes
- OnTabClosing typedef renamed to TabCloseInterceptor
- Added OnTabClose typedef

Open source →

1.4.018 Aug 20212 sources agree

TabbedViewTheme refactored to be a widget following the same pattern used by Flutter's Theme

API changes
- TabbedViewTheme refactored to be a widget following the same pattern used by Flutter's Theme
- Old theme classes have been renamed
  - TabbedViewTheme to TabbedViewThemeData
  - TabsAreaTheme to TabsAreaThemeData
  - ContentAreaTheme to ContentAreaThemeData
  - MenuTheme to MenuThemeData
  - ButtonsAreaTheme to ButtonsAreaThemeData
  - TabTheme to TabThemeData
  - TabStatusTheme to TabStatusThemeData