curved_ribbon_banner 1.0.0
curved_ribbon_banner: ^1.0.0 copied to clipboard
A decorative Flutter widget that displays repeating text along a curved wave path with gradient fill, animated shadow, and shimmer effects.
curved_ribbon_banner #
A decorative Flutter widget that displays repeating text along a curved wave path with gradient fill, animated drop shadow, and shimmer effects.
Features #
- Repeating text along a curved wave path
- Gradient ribbon fill with smooth color transitions
- Animated drop shadow
- Periodic shimmer/shine sweep for a premium feel
- Configurable wave shape, animation speed, and text styling
- Precomputed text positions for better performance
Installation #
Add to your pubspec.yaml:
dependencies:
curved_ribbon_banner: ^1.0.0
Then run:
flutter pub get
Usage #
import 'package:curved_ribbon_banner/curved_ribbon_banner.dart';
// Basic usage
CurvedRibbonBanner(
text: 'SELAMAT DATANG',
ribbonColor: Colors.indigo,
)
// Custom colors
CurvedRibbonBanner(
text: 'FLASH SALE 50% OFF',
ribbonColor: Colors.red,
textColor: Colors.yellow,
)
// Custom size and font
CurvedRibbonBanner(
text: 'PREMIUM MEMBER',
ribbonColor: Colors.teal,
height: 80,
fontSize: 18,
)
// Custom wave shape
CurvedRibbonBanner(
text: 'CUSTOM WAVE',
ribbonColor: Colors.purple,
waveAmplitude: 1.5,
waveFrequency: 1.2,
)
// Fast animation
CurvedRibbonBanner(
text: 'FAST',
ribbonColor: Colors.orange,
animationDuration: Duration(seconds: 4),
)
Properties #
| Property | Type | Default | Description |
|---|---|---|---|
text |
String |
required | Text that repeats along the wave path |
ribbonColor |
Color |
required | Fill color of the ribbon |
textColor |
Color |
Colors.white |
Color of the repeating text |
height |
double |
64 |
Height of the widget |
fontSize |
double |
13 |
Font size of the text |
letterSpacing |
double |
1.2 |
Spacing between characters |
animationDuration |
Duration |
12s |
Duration of one full animation cycle |
waveAmplitude |
double |
1.0 |
Amplitude factor of the wave (0.0 - 1.0+) |
waveFrequency |
double |
1.0 |
Frequency factor of the wave |
Example #
See the example directory for a complete demo app.
License #
MIT License - see LICENSE for details.