infinite_scrollable_tabbar 0.0.1

infinite_scrollable_tabbar: ^0.0.1 copied to clipboard

Initial release of the Infinite Scrollable TabBar package.

Features #

• ✨ Infinite Scrolling: Tabs repeat seamlessly in both directions for unlimited scrolling
• 🎯 Smart Controller: InfiniteScrollableTabController with intelligent index mapping
• 🎨 Fully Customizable:
  • Custom tab styles (selected and unselected)
  • Custom tab builder for complete control over tab appearance
  • Custom indicator builder
  • Configurable indicator position (top or bottom)
  • Adjustable tab width, height, and padding
  • Custom background colors
• 🎭 Smooth Animations: Built-in support for animated transitions with dual scrolling modes
  • Tap Behavior: Scrolls directly to the visible tab instance you tap for natural, intuitive interaction
  • Programmatic Behavior: animateToIndex() uses intelligent shortest-path detection for efficient navigation
  • animateToVirtualIndex() for scrolling to specific tab instances
  • jumpToIndex() for instant navigation with shortest-path logic
  • Configurable animation duration and curves
  • Automatically determines whether to scroll forward or backward based on context
• 📱 Responsive: Works seamlessly with dynamic tab lists
• 🚀 Easy Integration: Simple API with sensible defaults

Components #

• InfiniteScrollableTabBar: Main widget for displaying the infinite scrollable tab bar
• InfiniteScrollableTabController: Controller for managing state and programmatic scrolling
• TabItem: Data model representing a single tab with support for labels, icons, and badges
• TabIndicator: Customizable indicator widget for selected tabs
• IndicatorPosition: Enum for indicator positioning (top/bottom)

Example App #

Includes comprehensive example app demonstrating:

• Basic usage with text tabs
• Custom styled tabs
• Tabs with icons
• Programmatic scrolling (next, previous, random)
• Dynamic tab management (add/remove tabs)

Scroll Behavior #

The package implements two distinct scrolling behaviors for optimal UX:

Tab Tap Behavior:

• When you tap a visible tab, it scrolls directly to that specific instance
• Natural and intuitive - you get exactly what you tap
• Example: Tapping Tab 3 when at Tab 5 scrolls to the visible Tab 3

Programmatic Navigation:

• Uses intelligent shortest-path calculation
• Automatically chooses to scroll forward or backward based on efficiency
• Perfect for button-based navigation (Next/Previous/Random)
• Example: From Tab 5, calling animateToIndex(1) wraps forward (5→0→1) instead of going backward

Documentation #

• Comprehensive README with usage examples
• Complete API reference with tap vs programmatic scrolling explanation
• Detailed inline documentation (dartdoc)
• How it works explanation
• Example app with 5 interactive demos