Word Carousel #

A smooth, animated text carousel widget for Flutter that displays rotating text with beautiful transitions. Perfect for creating engaging user interfaces with dynamic text animations.

Features #

• 🎭 Smooth bottom-to-top character animations
• 🎯 Fixed text with rotating words
• ⚙️ Highly customizable appearance and timing
• 🎮 External controller support
• 🔄 Automatic or manual text rotation
• 📏 Adjustable spacing and styling
• 🎨 Customizable container color
• 🔁 Optional looping functionality

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  word_carousel: ^0.0.1

Usage #

import 'package:word_carousel/word_carousel.dart';

// Basic usage
WordCarousel(
  fixedText: "I am a",
  rotatingWords: ["Developer", "Designer", "Creator"],
);

// Advanced usage with controller
final controller = WordCarouselController();

WordCarousel(
  fixedText: "I love",
  rotatingWords: ["Flutter", "Coding", "Animation"],
  stayDuration: Duration(milliseconds: 2000),
  animationDuration: Duration(milliseconds: 500),
  fixedTextStyle: TextStyle(fontSize: 24),
  rotatingTextStyle: TextStyle(
    fontSize: 24,
    fontWeight: FontWeight.bold,
  ),
  spacing: 8.0,
  loop: true,
  autoStart: true,
  containerColor: Colors.cyan,
  controller: controller,
  onTextChanged: (index) {
    print('Text changed to: ${rotatingWords[index]}');
  },
);

// Control the carousel externally
controller.next();      // Move to next word
controller.reset();     // Reset to first word
controller.jumpTo(2);   // Jump to specific index

Properties #