LottieBuilder class

A widget that displays a Lottie animation.

Several constructors are provided for the various ways that a Lottie file can be provided:

Inheritance

Constructors

LottieBuilder({Key? key, required LottieProvider lottie, Animation<double>? controller, FrameRate? frameRate, bool? animate, bool? reverse, bool? repeat, LottieDelegates? delegates, LottieOptions? options, void onLoaded(LottieComposition)?, LottieFrameBuilder? frameBuilder, ImageErrorWidgetBuilder? errorBuilder, double? width, double? height, BoxFit? fit, AlignmentGeometry? alignment, bool? addRepaintBoundary, FilterQuality? filterQuality, WarningCallback? onWarning, RenderCache? renderCache})
const
LottieBuilder.asset(String name, {Animation<double>? controller, FrameRate? frameRate, bool? animate, bool? reverse, bool? repeat, LottieDelegates? delegates, LottieOptions? options, LottieImageProviderFactory? imageProviderFactory, void onLoaded(LottieComposition)?, Key? key, AssetBundle? bundle, LottieFrameBuilder? frameBuilder, ImageErrorWidgetBuilder? errorBuilder, double? width, double? height, BoxFit? fit, AlignmentGeometry? alignment, String? package, bool? addRepaintBoundary, FilterQuality? filterQuality, WarningCallback? onWarning, LottieDecoder? decoder, RenderCache? renderCache, bool? backgroundLoading})
Creates a widget that displays an LottieComposition obtained from an AssetBundle.
LottieBuilder.file(File file, {Animation<double>? controller, FrameRate? frameRate, bool? animate, bool? reverse, bool? repeat, LottieDelegates? delegates, LottieOptions? options, LottieImageProviderFactory? imageProviderFactory, void onLoaded(LottieComposition)?, Key? key, LottieFrameBuilder? frameBuilder, ImageErrorWidgetBuilder? errorBuilder, double? width, double? height, BoxFit? fit, AlignmentGeometry? alignment, bool? addRepaintBoundary, FilterQuality? filterQuality, WarningCallback? onWarning, LottieDecoder? decoder, RenderCache? renderCache, bool? backgroundLoading})
Creates a widget that displays an LottieComposition obtained from a File.
LottieBuilder.memory(Uint8List bytes, {Animation<double>? controller, FrameRate? frameRate, bool? animate, bool? reverse, bool? repeat, LottieDelegates? delegates, LottieOptions? options, LottieImageProviderFactory? imageProviderFactory, void onLoaded(LottieComposition)?, ImageErrorWidgetBuilder? errorBuilder, Key? key, LottieFrameBuilder? frameBuilder, double? width, double? height, BoxFit? fit, AlignmentGeometry? alignment, bool? addRepaintBoundary, FilterQuality? filterQuality, WarningCallback? onWarning, LottieDecoder? decoder, RenderCache? renderCache, bool? backgroundLoading})
Creates a widget that displays an LottieComposition obtained from a Uint8List.
LottieBuilder.network(String src, {Client? client, Map<String, String>? headers, Animation<double>? controller, FrameRate? frameRate, bool? animate, bool? reverse, bool? repeat, LottieDelegates? delegates, LottieOptions? options, LottieImageProviderFactory? imageProviderFactory, void onLoaded(LottieComposition)?, Key? key, LottieFrameBuilder? frameBuilder, ImageErrorWidgetBuilder? errorBuilder, double? width, double? height, BoxFit? fit, AlignmentGeometry? alignment, bool? addRepaintBoundary, FilterQuality? filterQuality, WarningCallback? onWarning, LottieDecoder? decoder, RenderCache? renderCache, bool? backgroundLoading})
Creates a widget that displays an LottieComposition obtained from the network.

Properties

addRepaintBoundary bool?
Indicate to automatically add a RepaintBoundary widget around the animation. This allows to optimize the app performance by isolating the animation in its own Layer.
final
alignment AlignmentGeometry?
How to align the animation within its bounds.
final
animate bool?
If no controller is specified, this value indicate whether or not the Lottie animation should be played automatically (default to true). If there is an animation controller specified, this property has no effect.
final
controller Animation<double>?
The animation controller of the Lottie animation. The animated value will be mapped to the progress property of the Lottie animation.
final
delegates LottieDelegates?
A group of options to further customize the lottie animation.
final
errorBuilder ImageErrorWidgetBuilder?
A builder function that is called if an error occurs during loading.
final
filterQuality FilterQuality?
The quality of the image layer. See FilterQuality FilterQuality.high is highest quality but slowest.
final
fit BoxFit?
How to inscribe the animation into the space allocated during layout.
final
frameBuilder → LottieFrameBuilder?
A builder function responsible for creating the widget that represents this lottie animation.
final
frameRate FrameRate?
The number of frames per second to render. Use FrameRate.composition to use the original frame rate of the Lottie composition (default) Use FrameRate.max to advance the animation progression at every frame.
final
hashCode int
The hash code for this object.
no setterinherited
height double?
If non-null, require the lottie animation to have this height.
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
lottie LottieProvider
The lottie animation to load. Example of providers: AssetLottie, NetworkLottie, FileLottie, MemoryLottie
final
onLoaded → void Function(LottieComposition)?
A callback called when the LottieComposition has been loaded. You can use this callback to set the correct duration on the AnimationController with composition.duration
final
onWarning → WarningCallback?
A callback called when there is a warning during the loading or painting of the animation.
final
options LottieOptions?
Some options to enable/disable some feature of Lottie
final
renderCache RenderCache?
Opt-in to a special render mode where the frames of the animation are lazily rendered and kept in a cache. Subsequent runs of the animation will be cheaper to render.
final
repeat bool?
Specify that the automatic animation should repeat in a loop (default to true). The property has no effect if animate is false or controller is not null.
final
reverse bool?
Specify that the automatic animation should repeat in a loop in a "reverse" mode (go from start to end and then continuously from end to start). It default to false. The property has no effect if animate is false, repeat is false or controller is not null.
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
width double?
If non-null, require the lottie animation to have this width.
final

Methods

createElement() StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() State<LottieBuilder>
Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
override
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a one-line detailed description of the object.
inherited
toStringShort() String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited