Package detailsv2.0.0

flutter_toggle_tab

Library to create Beautiful and Customized Toggle Tab Widget on Flutter

AndroidiOSWebmacOSWindowsLinux

pub.dev API documentation Source code

30-day downloads: 10.7K
Likes: 121
Pub points: 160

Install package

flutter pub add flutter_toggle_tab

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that enables developers to create visually appealing and highly customizable toggle tab widgets. It provides a flexible, easy-to-use interface for implementing segmented controls with smooth animations and responsive behavior across all major platforms. Ideal for filtering content, switching between views, or selecting options in a clean, modern UI. The library supports custom styling, alignment, and dynamic content rendering, making it suitable for both simple and complex use cases.

Use cases

Filtering data by category
Switching between app views
Creating form input selectors
Implementing theme toggles
Building navigation tabs
Customizing segmented controls

Key features

Highly customizable appearance
Smooth animation transitions
Cross-platform compatibility
Support for dynamic content
Easy integration with existing widgets
Responsive design handling

Suitable for

Developers building modern UIs
Apps requiring segmented selection
Designers seeking visual polish
Projects on multiple platforms
Teams prioritizing reusable components

Considerations

Requires understanding of Flutter layout principles
May need additional styling for complex themes
Performance impact with large numbers of tabs
Limited built-in accessibility features
Not optimized for extremely high-frequency updates

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Flutter Tab Toggle

A Beautiful and Simple Toggle Tab widget. It can be fully customized with desired icons, width, colors, text, corner radius, etc. It also maintains selection state.

Getting Started

In the pubspec.yaml of your flutter project, add the following dependency:

dependencies:
  flutter_toggle_tab: "^latestVersion"

Import it:

import 'package:flutter_toggle_tab/flutter_toggle_tab.dart';

Usage Examples

Basic tab/toggle switch


// Here default theme colors are used for activeBgColor, activeFgColor, inactiveBgColor and inactiveFgColor
FlutterToggleTab
(
  width: 90, // width in percent
  borderRadius: 30,
  height: 50,
  selectedIndex: _tabTextIndexSelected,
  selectedBackgroundColors: [Colors.blue, Colors.blueAccent],
  selectedTextStyle: TextStyle(
  color: Colors.white,
  fontSize: 18,
  fontWeight: FontWeight.w700),
  unSelectedTextStyle: TextStyle(
  color: Colors.black87,
  fontSize: 14,
  fontWeight: FontWeight.w500),
  dataTabs: _listTextTabToggle,
  selectedLabelIndex: (index) {
    setState(() {
        _tabTextIndexSelected = index;
    });
  },
  isScroll:false,
)

Basic tab/toggle switch with Custom Counter Widget


// Here default theme colors are used for activeBgColor, activeFgColor, inactiveBgColor and inactiveFgColor
FlutterToggleTab
(
  width: 90, // width in percent
  borderRadius: 30,
  height: 50,
  selectedIndex: _tabTextIndexSelected,
  selectedBackgroundColors: [Colors.blue, Colors.blueAccent],
  selectedTextStyle: TextStyle(
  color: Colors.white,
  fontSize: 18,
  fontWeight: FontWeight.w700),
  unSelectedTextStyle: TextStyle(
  color: Colors.black87,
  fontSize: 14,
  fontWeight: FontWeight.w500),
  dataTabs: _listTextTabToggleCounter,
  selectedLabelIndex: (index) {
    setState(() {
        _tabTextIndexSelected = index;
    });
  },
  isScroll:false,
)

Basic tab/toggle switch with Icon

FlutterToggleTab
(
  width: 50,
  borderRadius: 15,
  selectedTextStyle: TextStyle(
  color: Colors.white,
  fontSize: 18,
  fontWeight: FontWeight.w600),
  unSelectedTextStyle: TextStyle(
  color: Colors.blue,
  fontSize: 14,
  fontWeight: FontWeight.w400),
  dataTabs: _listGenderText,
  selectedIndex: _tabTextIconIndexSelected,
  selectedLabelIndex: (index) {
    setState(() {
      _tabTextIconIndexSelected = index;
    });
  },
)

Basic tab/toggle switch with Icon Only and add margin on selected item

FlutterToggleTab
(
  width: 40,
  borderRadius: 15,
  selectedIndex: _tabIconIndexSelected,
  selectedTextStyle: TextStyle(
  color: Colors.white,
  fontSize: 18,
  fontWeight: FontWeight.w600),
  unSelectedTextStyle: TextStyle(
  color: Colors.grey,
  fontSize: 14,
  fontWeight: FontWeight.w400),
  dataTabs: _listIconTabToggle,
  selectedLabelIndex: (index) {
    setState(() {
      _tabIconIndexSelected = index;
    });
  },
  marginSelected: EdgeInsets.symmetric(horizontal: 4,vertical:4),
)

Update selected tab Programmatically

FlutterToggleTab
(
  width: 90,
  borderRadius: 15,
  selectedIndex: _tabSelectedIndexSelected,
  selectedTextStyle: TextStyle(
  color: Colors.white,
  fontSize: 18,
  fontWeight: FontWeight.w600),
  unSelectedTextStyle: TextStyle(
  color: Colors.grey,
  fontSize: 14,
  fontWeight: FontWeight.w400),
  dataTabs: _listTextSelectedToggle,
  selectedLabelIndex: (index) {
    setState(() {
      _tabSelectedIndexSelected = index;
    });
  },
)

Available Parameters

Param	isRequired
List<DataTab> dataTabs	Yes
Function(int) selectedLabelIndex	Yes
TextStyle selectedTextStyle default:Theme.of(context).textTheme.bodyMedium,	No
TextStyle unSelectedTextStyle default:Theme.of(context).textTheme.bodyMedium,	No
int selectedIndex (listener for index selected) see on example	Yes
double width (in Percent of width Screen) default: 100	No
double height (double) default: 45	No
double iconSize	No
double borderRadius (double) default 30	No
List<Color> selectedBackgroundColors default : [ Theme.of(context).primaryColor]	No
List<Color> unSelectedBackgroundColors default [ Color(0xffe0e0e0)]	No
Alignment begin default : Alignment.topCenter	No
Alignment end default : Alignment.bottomCenter	No
bool isScroll default : true	No
EdgeInsets marginSelected default : EdgeInsets.zero	No
bool isShadowEnable default : true	No
bool isInnerShadowEnable default : true	No