elegant_announcement_bar 1.0.0

A highly customizable, animated, and elegant announcement bar for Flutter apps with RTL support and smart pausing.

Elegant Announcement Bar 🌟

A highly customizable, animated, and premium announcement bar for Flutter applications. Designed to grab users' attention with beautiful animations, built-in themes, and seamless RTL support.

---

---

Why Elegant Announcement Bar? 🤔

Traditional snackbars or banners can be intrusive or easily ignored. This package provides a sleek, non-intrusive way to display multiple rolling announcements, updates, or promotions in a fixed layout.

---

Key Features ✨

• ⚡ Auto-Rotating: Seamlessly cycle through multiple announcements.
• 🎭 Premium Animations: Smooth slide-and-fade transitions out of the box.
• ⏸️ Smart Pausing: Automatically pauses rotation when the user touches or holds the bar.
• 🌍 Native RTL Support: Intelligent layout and animation direction (Arabic, Hebrew, etc.).
• 🎨 Built-in Themes: Pre-designed styles for info, warning, success, and promotion.
• 🧩 Fully Customizable: Control colors, icons, durations, curves, margins, and text styles.
• 🔘 Indicators: Progress dots show users where they are in the announcement queue.

---

🚀 Getting Started

Add the package to your pubspec.yaml:

dependencies:
  elegant_announcement_bar: ^0.0.1

💡 Usage

Basic Setup

import 'package:elegant_announcement_bar/elegant_announcement_bar.dart';

ElegantAnnouncementBar(
  items: [
    AnnouncementItem(
      title: 'Update Ready!',
      message: 'Version 2.0 is now available for download.',
      type: AnnouncementType.info,
    ),
    AnnouncementItem(
      title: 'Congratulations!',
      message: 'You have earned 50 loyalty points.',
      type: AnnouncementType.success,
    ),
  ],
)

Advanced Customization

ElegantAnnouncementBar(
  items: itemsList,
  scrollDuration: const Duration(seconds: 4),
  animationDuration: const Duration(milliseconds: 600),
  showIndicators: true,
  pauseOnTouch: true,
  borderRadius: 12.0,
  margin: EdgeInsets.all(16),
  titleStyle: TextStyle(fontWeight: FontWeight.bold, fontSize: 16),
  onItemTap: (item) => print("Tapped ${item.title}"),
)

---

🌍 RTL Support (اللغة العربية)

The widget automatically detects the current Directionality of the context. When used in an Arabic or RTL environment, the icons and text align to the right, and the slide animations reverse direction to feel natural.

Directionality(
  textDirection: TextDirection.rtl,
  child: ElegantAnnouncementBar(items: arabicItems),
)

---

🎨 Design System

Property	Description	Default
scrollDuration	Time each item stays on screen	5 seconds
animationDuration	Duration of the slide animation	800 ms
pauseOnTouch	Pauses auto-rotation on touch/hold	true
messageMaxLines	Limit message text lines	1
borderRadius	Curvature of the bar corners	16.0
showIndicators	Show/Hide progress dot indicators	true
animationCurve	Movement curve (e.g., Cubic, Linear)	Curves.easeOut

---

🤝 Contribution & Feedback

We welcome contributions! If you have ideas for new features, themes, or find any bugs, please open an issue or submit a pull request on our GitHub Repository.

Made with ❤️ by manar42