animated_options_bar 0.1.3

A reusable animated tabbar/scrollbar component with smooth selection animations for Flutter.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.1.3 - 2026-05-14

Changed

• Option labels render on a single line with TextOverflow.ellipsis when space is limited, avoiding clipped or overflowing text in the bar.

Fixed

• In equal-width tab bar mode, the selection pill no longer extends past its slot (and get clipped) when one label’s intrinsic width is larger than its share of the row but the row still fits in tab bar mode.

0.1.2 - 2026-01-15

Added

• Disabled items support via isItemEnabled callback in AnimatedOptionsBar
• disabledTextColor parameter in OptionsBarConfig for styling disabled items
• Visual feedback for disabled state (reduced opacity, non-interactive)

0.1.1 - 2026-01-14

Added

• centerOptions parameter to OptionsBarConfig for centering option items within the bar
  • When true, items are tightly grouped in the center with natural widths
  • When false (default), maintains original behavior (expanded in tabbar mode, left-aligned in scrollbar mode)
  • Particularly useful in tabbar mode when items don't fill the entire width

Changed

• Updated minimum SDK constraint from ^3.9.2 to >=2.17.0 for broader compatibility
• Updated example SDK constraint to match package requirements

Fixed

• Selection indicator positioning when centerOptions is enabled
• Text alignment with selection indicator in centered mode
• Item width calculation for proper alignment in centered tabbar mode

0.1.0 - 2025-12-05

Added

• Initial release of animated_options_bar package
• AnimatedOptionsBar widget with smooth sliding and resizing animations
• Automatic layout mode detection (tabbar vs scrollbar)
• OptionsBarConfig for customizable styling
• Support for String items with auto-detection (getId/getLabel optional)
• Support for custom item types with getId/getLabel functions
• Built-in accessibility support with Semantics widgets
• Comprehensive error handling and edge case management
• Cached text measurements for performance optimization
• Comprehensive test suite

Features

• Smooth selection animations with configurable duration
• Automatic switching between tabbar mode (full width) and scrollbar mode (horizontal scrolling)
• Configurable colors, padding, spacing, and border radius
• Optional scroll arrows for scrollbar mode
• Optional background color and custom text styles