Files
SpotiFLAC-Mobile/lib/widgets/app_refresh_indicator.dart
zarzet 962e582acc chore(flutter): move to Flutter 3.50.0 and the material_ui packages
Flutter 3.50 deprecates its built-in Material and Cupertino libraries in
favour of the material_ui and cupertino_ui packages. The imports move
with the official fix (dart fix, migrate_design_widgets); the app's old
two-library theme bridge collapses into one Theme type.

- MaterialExpressiveScope keeps the complete host theme nearest its
  child. The reduced copy made for the expressive widgets now shares the
  app's Theme type and would hide component themes and extensions.
- LegacyThemeBrightness hands the brightness to the glass package, which
  still reads Flutter's built-in theme.
- appLocalizationsDelegates lists the material_ui localization delegates;
  the generated list still names the built-in ones.
- Tests: findByTooltip and pageBack replace the flutter_test helpers that
  only know the built-in widgets, and several tests that had gone stale
  against earlier app changes are repaired.
2026-11-15 23:33:29 +07:00

220 lines
7.3 KiB
Dart

import 'dart:async';
import 'dart:math' as math;
import 'package:cupertino_ui/cupertino_ui.dart'
show CupertinoSliverRefreshControl;
import 'package:flutter/foundation.dart';
import 'package:material_ui/material_ui.dart';
import 'package:material_3_expressive/material_3_expressive.dart';
import 'package:mornye/theme/material_expressive.dart';
import 'package:mornye/theme/mornye_theme.dart';
import 'package:mornye/utils/desktop_platform.dart';
/// Pull-to-refresh with the expressive shape-morphing indicator on Material.
/// Reduced motion keeps Flutter's [RefreshIndicator].
///
/// Mornye phones, whose lists bounce, use the iOS refresh control instead.
/// It is a sliver, so a [CustomScrollView] under this widget places
/// [AppRefreshIndicator.sliver] right after its large title. Mornye on
/// desktop, or with bouncing off (low-end phones), keeps [RefreshIndicator].
///
/// The page on screen also refreshes through [refreshVisible], which the
/// desktop Refresh command (Cmd/Ctrl+R) runs.
class AppRefreshIndicator extends StatefulWidget {
const AppRefreshIndicator({
super.key,
required this.onRefresh,
required this.child,
this.notificationPredicate = defaultScrollNotificationPredicate,
});
final RefreshCallback onRefresh;
final ScrollNotificationPredicate notificationPredicate;
final Widget child;
static final _mounted = <_AppRefreshIndicatorState>[];
/// The iOS refresh control where the enclosing [AppRefreshIndicator]
/// uses it, and an empty sliver elsewhere. [enabled] false hides it, for
/// pages whose `notificationPredicate` turns refreshing off.
static Widget sliver({bool enabled = true}) =>
_AppRefreshSliver(enabled: enabled);
/// Refreshes the most recently opened page that is on screen, showing its
/// indicator. Returns whether one was found.
static bool refreshVisible() {
for (final state in _mounted.reversed) {
if (state._onScreen) {
unawaited(state._show());
return true;
}
}
return false;
}
@override
State<AppRefreshIndicator> createState() => _AppRefreshIndicatorState();
}
class _AppRefreshIndicatorState extends State<AppRefreshIndicator> {
final _materialKey = GlobalKey<RefreshIndicatorState>();
final _expressive = M3ERefreshIndicatorController();
bool _usesExpressive = false;
/// While a pull is under way: its status and how far it has pulled.
M3ERefreshStatus? _status;
double _pull = 0;
bool get _onScreen =>
mounted &&
TickerMode.valuesOf(context).enabled &&
(ModalRoute.of(context)?.isCurrent ?? true);
/// A pull being pushed back shrinks the indicator first; the list only
/// scrolls once the pull is gone.
bool _holdsPull() =>
(_status == M3ERefreshStatus.drag || _status == M3ERefreshStatus.armed) &&
_pull > 0;
@override
void initState() {
super.initState();
AppRefreshIndicator._mounted.add(this);
}
@override
void dispose() {
AppRefreshIndicator._mounted.remove(this);
super.dispose();
}
// The iOS control has no programmatic show; it only runs on phones, which
// have no Refresh command.
Future<void> _show() => _usesExpressive
? _expressive.show()
: _materialKey.currentState?.show() ?? widget.onRefresh();
static bool _bounces(BuildContext context) {
ScrollPhysics? physics = ScrollConfiguration.of(
context,
).getScrollPhysics(context);
while (physics != null) {
if (physics is BouncingScrollPhysics) return true;
physics = physics.parent;
}
return false;
}
bool _trackPull(OverscrollNotification notification) {
final delta = notification.dragDetails?.delta.dy;
if (_holdsPull() || _status == M3ERefreshStatus.drag) {
if (delta != null) _pull = math.max(0, _pull + delta);
}
return false;
}
void _statusChanged(M3ERefreshStatus? status) {
// A new pull starts from nothing; falling back from armed keeps it.
if (status == M3ERefreshStatus.drag && _status != M3ERefreshStatus.armed) {
_pull = 0;
}
_status = status;
}
@override
Widget build(BuildContext context) {
_usesExpressive = materialExpressiveEnabled(context);
if (context.isMornye && !isDesktopPlatform && _bounces(context)) {
return _RefreshScope(onRefresh: widget.onRefresh, child: widget.child);
}
if (!_usesExpressive) {
return RefreshIndicator(
key: _materialKey,
onRefresh: widget.onRefresh,
notificationPredicate: widget.notificationPredicate,
child: widget.child,
);
}
Widget indicator = M3ERefreshIndicator.contained(
controller: _expressive,
onRefresh: widget.onRefresh,
notificationPredicate: widget.notificationPredicate,
onStatusChange: _statusChanged,
child: NotificationListener<OverscrollNotification>(
onNotification: _trackPull,
child: widget.child,
),
);
// macOS lists bounce past their top edge. Under a pinned header that
// bounce opens a gap below the title, and the indicator ignores a pull
// that starts while it is still closing, so the top edge stays put.
if (defaultTargetPlatform == TargetPlatform.macOS) {
final behavior = ScrollConfiguration.of(context);
indicator = ScrollConfiguration(
behavior: behavior.copyWith(
physics: _PullEdgeScrollPhysics(
holdsPull: _holdsPull,
parent: behavior.getScrollPhysics(context),
),
),
child: indicator,
);
}
return MaterialExpressiveScope(child: indicator);
}
}
/// Stops the leading edge instead of bouncing past it, and keeps the list
/// at that edge while [holdsPull]. A refused move is reported as overscroll,
/// so the indicator still follows the pointer.
class _PullEdgeScrollPhysics extends ScrollPhysics {
const _PullEdgeScrollPhysics({required this.holdsPull, super.parent});
final bool Function() holdsPull;
@override
_PullEdgeScrollPhysics applyTo(ScrollPhysics? ancestor) =>
_PullEdgeScrollPhysics(
holdsPull: holdsPull,
parent: buildParent(ancestor),
);
@override
double applyBoundaryConditions(ScrollMetrics position, double value) {
final min = position.minScrollExtent;
if (value < position.pixels && position.pixels <= min) {
return value - position.pixels;
}
if (value < min && min < position.pixels) return value - min;
if (value > position.pixels && position.pixels <= min && holdsPull()) {
return value - position.pixels;
}
return super.applyBoundaryConditions(position, value);
}
}
/// Hands the refresh callback to [AppRefreshIndicator.sliver] when the iOS
/// refresh control replaces the indicator.
class _RefreshScope extends InheritedWidget {
const _RefreshScope({required this.onRefresh, required super.child});
final RefreshCallback onRefresh;
@override
bool updateShouldNotify(_RefreshScope oldWidget) =>
onRefresh != oldWidget.onRefresh;
}
class _AppRefreshSliver extends StatelessWidget {
const _AppRefreshSliver({required this.enabled});
final bool enabled;
@override
Widget build(BuildContext context) {
final scope = context.dependOnInheritedWidgetOfExactType<_RefreshScope>();
if (scope == null || !enabled) return const SliverToBoxAdapter();
return CupertinoSliverRefreshControl(onRefresh: scope.onRefresh);
}
}