94a41ff563
The per-tab entrance pop lived in each icon, but the hosts swap a tab's icon subtree when it is selected or deselected (Material wrapped the selected icon in its own circle; Cupertino did the same in activeIcon), so every tab switch remounted those icons and replayed their pop. The bar now owns the entrance, highlight slide and bounce animations and restarts the entrance only when its set of tabs changes. One highlight behind the icons glides to the new tab (250 ms, stretching to 1.25x wide mid-move) and the new icon bounces (1.08x, 180 ms); reduced motion jumps. Cupertino paints it from tab 0 above the host's backdrop blur.
205 lines
6.1 KiB
Dart
205 lines
6.1 KiB
Dart
import 'package:flutter/widgets.dart';
|
|
|
|
/// Short, quiet motion shared by the app: opening and closing sections,
|
|
/// counts and statuses changing, live items arriving. Every duration drops
|
|
/// to zero when the system asks for reduced motion.
|
|
abstract final class Motion {
|
|
/// A count, an icon or a status swapping in place.
|
|
static const Duration quick = Duration(milliseconds: 150);
|
|
|
|
/// A section opening or closing, a bar changing its actions.
|
|
static const Duration standard = Duration(milliseconds: 200);
|
|
|
|
/// The total duration of a tab's Material fade-through transition.
|
|
static const Duration tabFadeThrough = Duration(milliseconds: 250);
|
|
|
|
/// The scale at the midpoint of a tab's fade-through transition.
|
|
static const double tabFadeThroughScale = 0.96;
|
|
|
|
/// The point at which the incoming tab begins to appear.
|
|
static const double tabFadeThroughIncomingAt = 0.35;
|
|
|
|
/// Duration of each tab's entrance pop.
|
|
static const Duration tabEntranceDuration = Duration(milliseconds: 260);
|
|
|
|
/// Delay between neighbouring tabs entering as one group.
|
|
static const Duration tabEntranceStagger = Duration(milliseconds: 70);
|
|
|
|
/// The scale at which a tab starts its entrance pop.
|
|
static const double tabEntranceScaleBegin = 0.6;
|
|
|
|
/// The upward travel distance of a tab's entrance pop, in logical pixels.
|
|
static const double tabEntranceSlideDistance = 6;
|
|
|
|
/// The fraction of a tab's entrance spent fading in.
|
|
static const double tabEntranceOpacityPortion = 0.6;
|
|
|
|
/// How long a tab bar's selection highlight takes to glide to a new tab.
|
|
static const Duration tabHighlightDuration = Duration(milliseconds: 250);
|
|
|
|
/// The highlight's width, relative to its height, halfway through a move;
|
|
/// it is a circle again at rest.
|
|
static const double tabHighlightStretch = 1.25;
|
|
|
|
/// The newly selected tab icon's brief bounce.
|
|
static const Duration tabBounceDuration = Duration(milliseconds: 180);
|
|
|
|
/// The icon's scale at the top of its bounce.
|
|
static const double tabBounceScale = 1.08;
|
|
|
|
static const Curve curve = Curves.easeOutCubic;
|
|
|
|
/// [duration], or zero under the system's reduce-motion setting.
|
|
static Duration of(BuildContext context, Duration duration) =>
|
|
MediaQuery.maybeDisableAnimationsOf(context) ?? false
|
|
? Duration.zero
|
|
: duration;
|
|
}
|
|
|
|
/// Swaps [child] with a short cross-fade whenever its key changes.
|
|
class MotionSwitcher extends StatelessWidget {
|
|
const MotionSwitcher({
|
|
super.key,
|
|
required this.child,
|
|
this.duration = Motion.quick,
|
|
this.scale = false,
|
|
});
|
|
|
|
final Widget child;
|
|
final Duration duration;
|
|
|
|
/// Also grows the incoming child from 80%: for badges and pills.
|
|
final bool scale;
|
|
|
|
@override
|
|
Widget build(BuildContext context) => AnimatedSwitcher(
|
|
duration: Motion.of(context, duration),
|
|
switchInCurve: Motion.curve,
|
|
switchOutCurve: Motion.curve,
|
|
transitionBuilder: (child, animation) {
|
|
final faded = FadeTransition(opacity: animation, child: child);
|
|
if (!scale) return faded;
|
|
return ScaleTransition(
|
|
scale: Tween<double>(begin: 0.8, end: 1).animate(animation),
|
|
child: faded,
|
|
);
|
|
},
|
|
child: child,
|
|
);
|
|
}
|
|
|
|
/// Names the items of a live list, so items that arrive after the first load
|
|
/// can enter with a short fade and slide while the first load and items
|
|
/// scrolled into view appear at once.
|
|
class ArrivalScope extends StatefulWidget {
|
|
const ArrivalScope({super.key, required this.ids, required this.child});
|
|
|
|
/// Every item currently in the list, built or not.
|
|
final Iterable<Object> ids;
|
|
final Widget child;
|
|
|
|
@override
|
|
State<ArrivalScope> createState() => _ArrivalScopeState();
|
|
}
|
|
|
|
class _ArrivalScopeState extends State<ArrivalScope> {
|
|
final Set<Object> _known = {};
|
|
final Set<Object> _fresh = {};
|
|
bool _primed = false;
|
|
|
|
void _absorb() {
|
|
final ids = widget.ids.toList();
|
|
if (!_primed) {
|
|
// The first non-empty list is the starting point, not an arrival.
|
|
if (ids.isEmpty) return;
|
|
_known.addAll(ids);
|
|
_primed = true;
|
|
return;
|
|
}
|
|
for (final id in ids) {
|
|
if (_known.add(id)) _fresh.add(id);
|
|
}
|
|
}
|
|
|
|
@override
|
|
void initState() {
|
|
super.initState();
|
|
_absorb();
|
|
}
|
|
|
|
@override
|
|
void didUpdateWidget(ArrivalScope oldWidget) {
|
|
super.didUpdateWidget(oldWidget);
|
|
_absorb();
|
|
}
|
|
|
|
/// True once for an item that arrived after the first load.
|
|
bool _claim(Object id) => _fresh.remove(id);
|
|
|
|
@override
|
|
Widget build(BuildContext context) =>
|
|
_ArrivalData(state: this, child: widget.child);
|
|
}
|
|
|
|
class _ArrivalData extends InheritedWidget {
|
|
const _ArrivalData({required this.state, required super.child});
|
|
|
|
final _ArrivalScopeState state;
|
|
|
|
@override
|
|
bool updateShouldNotify(_ArrivalData oldWidget) => false;
|
|
}
|
|
|
|
/// One item of an [ArrivalScope]: fades and slides in when it is new.
|
|
class Arrival extends StatefulWidget {
|
|
const Arrival({super.key, required this.id, required this.child});
|
|
|
|
final Object id;
|
|
final Widget child;
|
|
|
|
@override
|
|
State<Arrival> createState() => _ArrivalState();
|
|
}
|
|
|
|
class _ArrivalState extends State<Arrival> with SingleTickerProviderStateMixin {
|
|
AnimationController? _controller;
|
|
|
|
@override
|
|
void didChangeDependencies() {
|
|
super.didChangeDependencies();
|
|
if (_controller != null) return;
|
|
final scope = context.getInheritedWidgetOfExactType<_ArrivalData>()?.state;
|
|
final duration = Motion.of(context, Motion.standard);
|
|
if (scope == null ||
|
|
duration == Duration.zero ||
|
|
!scope._claim(widget.id)) {
|
|
return;
|
|
}
|
|
_controller = AnimationController(vsync: this, duration: duration)
|
|
..forward();
|
|
}
|
|
|
|
@override
|
|
void dispose() {
|
|
_controller?.dispose();
|
|
super.dispose();
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
final controller = _controller;
|
|
if (controller == null) return widget.child;
|
|
final curved = CurvedAnimation(parent: controller, curve: Motion.curve);
|
|
return FadeTransition(
|
|
opacity: curved,
|
|
child: SlideTransition(
|
|
position: Tween<Offset>(
|
|
begin: const Offset(0, 0.15),
|
|
end: Offset.zero,
|
|
).animate(curved),
|
|
child: widget.child,
|
|
),
|
|
);
|
|
}
|
|
}
|