animated_line_through 1.0.4 copy "animated_line_through: ^1.0.4" to clipboard
animated_line_through: ^1.0.4 copied to clipboard

Animated line through for text for Flutter, with full control over animation

Animated Line Through #

A super simple package to add animated line through text in your Flutter app!

We created this package because Flutter currently lacks built-in support for animating text decorations, particularly the line through effect.

Example

Usage #

This package provides two widgets: AnimatedLineThrough and AnimatedLineThroughRaw.

Both widgets require a child argument, which must be a widget that uses either RenderParagraph or RenderEditable as its render object. Without this, the line through effect won't work.

Typically, you'll use widgets like Text, RichText, TextField, or TextFormField.

AnimatedLineThrough

The AnimatedLineThrough widget is ready to use out-of-the-box, just like any other declarative widget. It expects 3 arguments: duration, isCrossed and strokeWidth(optional).

Here's an example using Text as the child widget:

AnimatedLineThrough(
  duration: const Duration(milliseconds: 500),
  isCrossed: _isCrossed,
  strokeWidth: 2,
  child: Text('Our text'),
);
  • duration specifies the duration of the animation,
  • isCrossed is a boolean that indicates whether the text should have a line through effect or not,
  • strokeWidth defines the width of the line-through to paint over the text.

AnimatedLineThroughRaw

The AnimatedLineThroughRaw widget gives you more control over the line animation. It expects an Animation<double> object for line progress and a color for the line.

Here's an example using AnimationController and Tween to control the line animation:

late final _controller = AnimationController();
late final _animation = Tween(begin: 0.0, end: 1.0).animate(
  CurvedAnimation(
    parent: _controller,
    curve: const Interval(0, 0.7, curve: Curves.easeInOut),
  ),
);

AnimatedLineThroughRaw(
  crossed: _animation,
  color: Colors.black,
  strokeWidth: 2.5,
  child: Text('Our text'),
);

Text Fields issues #

The workaround for TextField (and TextFormField) is much more complex than the workaround for simple Text widget. The problem is that those widgets doesn't use RenderEditable directly, but have many widget before that.

So, instead of simple get RenderEditable we need to find it through render-tree, try to find RenderBox above it and then count everything we need to draw a cross line.

But for you it's just that simple as use with simple Text widget, just wrap your TextField (or TextFormField) with AnimatedLineThrough:

AnimatedLineThrough(
  duration: const Duration(milliseconds: 500),
  isCrossed: _isCrossed,
  strokeWidth: 2,
  child: TextField(),
);

As the version 1.0.3 we fix main problem with editable widgets, so from now on it's count width of each line correctly.

I hope this helps! Let me know if you have any further questions or issues. ๐Ÿงก

21
likes
160
pub points
76%
popularity

Publisher

unverified uploader

Animated line through for text for Flutter, with full control over animation

Repository (GitHub)
View/report issues

Documentation

API reference

License

BSD-3-Clause (license)

Dependencies

flutter

More

Packages that depend on animated_line_through