AScale class
Physics-based equivalent of AnimatedScale, renamed to AScale.
Animates changes in scale using physics-based animations, providing natural-feeling scaling effects. This is particularly useful for interactive UI elements that need to scale in response to user input.
{@macro ImplicitlyPhysicsAnimatedWidget}
{@tool snippet} This example shows a widget that bounces between two scales when tapped:
class _MyWidget extends StatefulWidget {
@override
State<_MyWidget> createState() => _MyWidgetState();
}
class _MyWidgetState extends State<_MyWidget> {
bool _enlarged = false;
@override
Widget build(BuildContext context) {
return AScale(
physics: Spring.snap,
scale: _enlarged ? 1.5 : 1.0,
alignment: Alignment.center,
child: GestureDetector(
onTap: () => setState(() => _enlarged = !_enlarged),
child: Container(
width: 100,
height: 100,
color: Colors.blue,
child: const Center(child: Text('Tap me!')),
),
),
);
}
}
{@end-tool}
Performance Considerations
- Scale animations are generally more performant than opacity animations
- Consider using filterQuality to improve scaled image quality
- Large scale factors may impact performance due to increased pixel processing
See also:
- Inheritance
Constructors
- AScale.new({Key? key, required double scale, Widget? child, Alignment alignment = Alignment.center, FilterQuality? filterQuality, Duration? duration, Physics? physics, VoidCallback? onEnd})
-
Creates a new AScale.
Physics-based equivalent of AnimatedScale, renamed to AScale.
const
Properties
- alignment → Alignment
-
final
- child → Widget?
-
final
- duration → Duration?
-
The duration of the animation.
finalinherited
- filterQuality → FilterQuality?
-
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- onEnd → VoidCallback?
-
A callback that is called when an animation completes.
finalinherited
- physics → Physics?
-
The physics or curve that controls how the animation moves.
finalinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- scale → double
-
final
Methods
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → State< AScale> -
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, int wrapWidth = 65}) → 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