mirror of
https://github.com/flutter/flutter.git
synced 2026-02-20 02:29:02 +08:00
The scroll notification events reported for a press-drag-release gesture within a scrollable on a touch screen device begin with a `ScrollStartNotification`, followed by a series of `ScrollUpdateNotifications`, and conclude with a `ScrollEndNotification`. This protocol can be used to defer work until an interactive scroll gesture ends. For example, you might defer updating a scrollable's contents via network requests until the scroll has ended, or you might want to automatically auto-scroll at that time. In the example that follows the CustomScrollView automatically scrolls so that the last partially visible fixed-height item is completely visible when the scroll gesture ends. Many iOS applications do this kind of thing. It only makes sense to auto-scroll when the user isn't actively dragging the scrollable around. It's easy enough to do this by reacting to a ScrollEndNotifcation by auto-scrolling to align the last fixed-height list item ([source code](https://gist.github.com/HansMuller/13e2a7adadc9afb3803ba7848b20c410)). https://github.com/flutter/flutter/assets/1377460/a6e6fc77-6742-4f98-81ba-446536535f73 Dragging the scrollbar thumb in a desktop application is a similar user gesture. Currently it's not possible to defer work or auto-scroll (or whatever) while the scrollable is actively being dragged via the scrollbar thumb because each scrollbar thumb motion is mapped to a scroll start - scroll update - scroll end series of notifications. On a desktop platform, the same code behaves quite differently when the scrollbar thumb is dragged. https://github.com/flutter/flutter/assets/1377460/2593d8a3-639c-407f-80c1-6e6f67fb8c5f The stream of scroll-end events triggers auto-scrolling every time the thumb moves. From the user's perspective this feels like a losing struggle. One can also detect the beginning and end of a touch-drag by listening to the value of a ScrollPosition's `isScrollingNotifier`. This approach suffers from a similar problem: during a scrollbar thumb-drag, the `isScrollingNotifier` value isn't updated at all. This PR refactors the RawScrollbar implementation to effectively use a ScrollDragController to manage scrolls caused by dragging the scrollbar's thumb. Doing so means that dragging the thumb will produce the same notifications as dragging the scrollable on a touch device. Now desktop applications can choose to respond to scrollbar thumb drags in the same that they respond to drag scrolling on a touch screen. With the changes included here, the desktop or web version of the app works as expected, whether you're listing to scroll notifications or the scroll position's `isScrollingNotifier`. https://github.com/flutter/flutter/assets/1377460/67435c40-a866-4735-a19b-e3d68eac8139 This PR also makes the second [ScrollPosition API doc example](https://api.flutter.dev/flutter/widgets/ScrollPosition-class.html#cupertino.ScrollPosition.2) work as expected when used with the DartPad that's part of API doc page. Desktop applications also see scroll start-update-end notifications due to the mouse wheel. There is no touch screen analog for the mouse wheel, so an application that wanted to enable this kind of auto-scrolling alignment would have to include a heuristic that dealt with the sequence of small scrolls triggered by the mouse wheel. Here's an example of that: [source code](https://gist.github.com/HansMuller/ce5c474a458f5f4bcc07b0d621843165). This version of the app does not auto-align in response to small changes, wether they're triggered by dragging the scrollbar thumb of the mouse wheel. Related sliver utility PRs: https://github.com/flutter/flutter/pull/143538, https://github.com/flutter/flutter/pull/143196, https://github.com/flutter/flutter/pull/143325.
340 lines
12 KiB
Dart
340 lines
12 KiB
Dart
// Copyright 2014 The Flutter Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file.
|
|
|
|
import 'package:flutter/gestures.dart';
|
|
import 'package:flutter/material.dart';
|
|
import 'package:flutter_test/flutter_test.dart';
|
|
|
|
void main() {
|
|
testWidgets('ScrollMetricsNotification test', (WidgetTester tester) async {
|
|
final List<Notification> events = <Notification>[];
|
|
Widget buildFrame(double height) {
|
|
return NotificationListener<Notification>(
|
|
onNotification: (Notification value) {
|
|
events.add(value);
|
|
return false;
|
|
},
|
|
child: SingleChildScrollView(
|
|
child: SizedBox(height: height),
|
|
),
|
|
);
|
|
}
|
|
await tester.pumpWidget(buildFrame(1200.0));
|
|
expect(events.length, 1);
|
|
ScrollMetricsNotification event = events[0] as ScrollMetricsNotification;
|
|
expect(event.metrics.extentBefore, 0.0);
|
|
expect(event.metrics.extentInside, 600.0);
|
|
expect(event.metrics.extentAfter, 600.0);
|
|
expect(event.metrics.extentTotal, 1200.0);
|
|
|
|
events.clear();
|
|
await tester.pumpWidget(buildFrame(1000.0));
|
|
// Change the content dimensions will trigger a new event.
|
|
expect(events.length, 1);
|
|
event = events[0] as ScrollMetricsNotification;
|
|
expect(event.metrics.extentBefore, 0.0);
|
|
expect(event.metrics.extentInside, 600.0);
|
|
expect(event.metrics.extentAfter, 400.0);
|
|
expect(event.metrics.extentTotal, 1000.0);
|
|
|
|
events.clear();
|
|
final TestGesture gesture = await tester.startGesture(const Offset(100.0, 100.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
await gesture.moveBy(const Offset(-10.0, -10.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
await gesture.up();
|
|
await tester.pump(const Duration(seconds: 1));
|
|
|
|
expect(events.length, 5);
|
|
// user scroll do not trigger the ScrollMetricsNotification.
|
|
expect(events[0] is ScrollStartNotification, true);
|
|
expect(events[1] is UserScrollNotification, true);
|
|
expect(events[2] is ScrollUpdateNotification, true);
|
|
expect(events[3] is ScrollEndNotification, true);
|
|
expect(events[4] is UserScrollNotification, true);
|
|
|
|
events.clear();
|
|
// Change the content dimensions again.
|
|
await tester.pumpWidget(buildFrame(500.0));
|
|
expect(events.length, 1);
|
|
event = events[0] as ScrollMetricsNotification;
|
|
expect(event.metrics.extentBefore, 0.0);
|
|
expect(event.metrics.extentInside, 600.0);
|
|
expect(event.metrics.extentAfter, 0.0);
|
|
expect(event.metrics.extentTotal, 600.0);
|
|
|
|
events.clear();
|
|
// The content dimensions does not change.
|
|
await tester.pumpWidget(buildFrame(500.0));
|
|
expect(events.length, 0);
|
|
});
|
|
|
|
testWidgets('Scroll notification basics', (WidgetTester tester) async {
|
|
late ScrollNotification notification;
|
|
|
|
await tester.pumpWidget(NotificationListener<ScrollNotification>(
|
|
onNotification: (ScrollNotification value) {
|
|
if (value is ScrollStartNotification || value is ScrollUpdateNotification || value is ScrollEndNotification) {
|
|
notification = value;
|
|
}
|
|
return false;
|
|
},
|
|
child: const SingleChildScrollView(
|
|
child: SizedBox(height: 1200.0),
|
|
),
|
|
));
|
|
|
|
final TestGesture gesture = await tester.startGesture(const Offset(100.0, 100.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
expect(notification, isA<ScrollStartNotification>());
|
|
expect(notification.depth, equals(0));
|
|
final ScrollStartNotification start = notification as ScrollStartNotification;
|
|
expect(start.dragDetails, isNotNull);
|
|
expect(start.dragDetails!.globalPosition, equals(const Offset(100.0, 100.0)));
|
|
|
|
await gesture.moveBy(const Offset(-10.0, -10.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
expect(notification, isA<ScrollUpdateNotification>());
|
|
expect(notification.depth, equals(0));
|
|
final ScrollUpdateNotification update = notification as ScrollUpdateNotification;
|
|
expect(update.dragDetails, isNotNull);
|
|
expect(update.dragDetails!.globalPosition, equals(const Offset(90.0, 90.0)));
|
|
expect(update.dragDetails!.delta, equals(const Offset(0.0, -10.0)));
|
|
|
|
await gesture.up();
|
|
await tester.pump(const Duration(seconds: 1));
|
|
expect(notification, isA<ScrollEndNotification>());
|
|
expect(notification.depth, equals(0));
|
|
final ScrollEndNotification end = notification as ScrollEndNotification;
|
|
expect(end.dragDetails, isNotNull);
|
|
expect(end.dragDetails!.velocity, equals(Velocity.zero));
|
|
});
|
|
|
|
testWidgets('Scroll notification depth', (WidgetTester tester) async {
|
|
final List<Type> depth0Types = <Type>[];
|
|
final List<Type> depth1Types = <Type>[];
|
|
final List<int> depth0Values = <int>[];
|
|
final List<int> depth1Values = <int>[];
|
|
|
|
await tester.pumpWidget(NotificationListener<ScrollNotification>(
|
|
onNotification: (ScrollNotification value) {
|
|
depth1Types.add(value.runtimeType);
|
|
depth1Values.add(value.depth);
|
|
return false;
|
|
},
|
|
child: SingleChildScrollView(
|
|
dragStartBehavior: DragStartBehavior.down,
|
|
child: SizedBox(
|
|
height: 1200.0,
|
|
child: NotificationListener<ScrollNotification>(
|
|
onNotification: (ScrollNotification value) {
|
|
depth0Types.add(value.runtimeType);
|
|
depth0Values.add(value.depth);
|
|
return false;
|
|
},
|
|
child: Container(
|
|
padding: const EdgeInsets.all(50.0),
|
|
child: const SingleChildScrollView(
|
|
dragStartBehavior: DragStartBehavior.down,
|
|
child: SizedBox(height: 1200.0),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
));
|
|
|
|
final TestGesture gesture = await tester.startGesture(const Offset(100.0, 100.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
await gesture.moveBy(const Offset(-10.0, -40.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
await gesture.up();
|
|
await tester.pump(const Duration(seconds: 1));
|
|
|
|
final List<Type> types = <Type>[
|
|
ScrollStartNotification,
|
|
UserScrollNotification,
|
|
ScrollUpdateNotification,
|
|
ScrollEndNotification,
|
|
UserScrollNotification,
|
|
];
|
|
expect(depth0Types, equals(types));
|
|
expect(depth1Types, equals(types));
|
|
|
|
expect(depth0Values, equals(<int>[0, 0, 0, 0, 0]));
|
|
expect(depth1Values, equals(<int>[1, 1, 1, 1, 1]));
|
|
});
|
|
|
|
testWidgets('ScrollNotifications bubble past Scaffold Material', (WidgetTester tester) async {
|
|
final List<Type> notificationTypes = <Type>[];
|
|
|
|
await tester.pumpWidget(
|
|
MaterialApp(
|
|
home: NotificationListener<ScrollNotification>(
|
|
onNotification: (ScrollNotification value) {
|
|
notificationTypes.add(value.runtimeType);
|
|
return false;
|
|
},
|
|
child: Scaffold(
|
|
body: SizedBox.expand(
|
|
child: SingleChildScrollView(
|
|
dragStartBehavior: DragStartBehavior.down,
|
|
child: SizedBox(
|
|
height: 1200.0,
|
|
child: Container(
|
|
padding: const EdgeInsets.all(50.0),
|
|
child: const SingleChildScrollView(
|
|
dragStartBehavior: DragStartBehavior.down,
|
|
child: SizedBox(height: 1200.0),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
final TestGesture gesture = await tester.startGesture(const Offset(100.0, 100.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
await gesture.moveBy(const Offset(-10.0, -40.0));
|
|
await tester.pump(const Duration(seconds: 1));
|
|
await gesture.up();
|
|
await tester.pump(const Duration(seconds: 1));
|
|
|
|
final List<Type> types = <Type>[
|
|
ScrollStartNotification,
|
|
UserScrollNotification,
|
|
ScrollUpdateNotification,
|
|
ScrollEndNotification,
|
|
UserScrollNotification,
|
|
];
|
|
expect(notificationTypes, equals(types));
|
|
});
|
|
|
|
testWidgets('ScrollNotificationObserver', (WidgetTester tester) async {
|
|
late ScrollNotificationObserverState observer;
|
|
ScrollNotification? notification;
|
|
|
|
void handleNotification(ScrollNotification value) {
|
|
if (value is ScrollStartNotification || value is ScrollUpdateNotification || value is ScrollEndNotification) {
|
|
notification = value;
|
|
}
|
|
}
|
|
|
|
await tester.pumpWidget(
|
|
ScrollNotificationObserver(
|
|
child: Builder(
|
|
builder: (BuildContext context) {
|
|
observer = ScrollNotificationObserver.of(context);
|
|
return const SingleChildScrollView(
|
|
child: SizedBox(height: 1200.0),
|
|
);
|
|
},
|
|
),
|
|
),
|
|
);
|
|
|
|
observer.addListener(handleNotification);
|
|
|
|
TestGesture gesture = await tester.startGesture(const Offset(100.0, 100.0));
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isA<ScrollStartNotification>());
|
|
expect(notification!.depth, equals(0));
|
|
|
|
final ScrollStartNotification start = notification! as ScrollStartNotification;
|
|
expect(start.dragDetails, isNotNull);
|
|
expect(start.dragDetails!.globalPosition, equals(const Offset(100.0, 100.0)));
|
|
|
|
await gesture.moveBy(const Offset(-10.0, -10.0));
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isA<ScrollUpdateNotification>());
|
|
expect(notification!.depth, equals(0));
|
|
final ScrollUpdateNotification update = notification! as ScrollUpdateNotification;
|
|
expect(update.dragDetails, isNotNull);
|
|
expect(update.dragDetails!.globalPosition, equals(const Offset(90.0, 90.0)));
|
|
expect(update.dragDetails!.delta, equals(const Offset(0.0, -10.0)));
|
|
|
|
await gesture.up();
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isA<ScrollEndNotification>());
|
|
expect(notification!.depth, equals(0));
|
|
final ScrollEndNotification end = notification! as ScrollEndNotification;
|
|
expect(end.dragDetails, isNotNull);
|
|
expect(end.dragDetails!.velocity, equals(Velocity.zero));
|
|
|
|
observer.removeListener(handleNotification);
|
|
notification = null;
|
|
|
|
gesture = await tester.startGesture(const Offset(100.0, 100.0));
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isNull);
|
|
|
|
await gesture.moveBy(const Offset(-10.0, -10.0));
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isNull);
|
|
|
|
await gesture.up();
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isNull);
|
|
});
|
|
|
|
testWidgets('ScrollBar thumb drag triggers scroll start-update-end notifications', (WidgetTester tester) async {
|
|
final ScrollController scrollController = ScrollController();
|
|
ScrollNotification? notification;
|
|
|
|
addTearDown(scrollController.dispose);
|
|
|
|
bool handleScrollNotification(ScrollNotification value) {
|
|
if (value is ScrollStartNotification || value is ScrollUpdateNotification || value is ScrollEndNotification) {
|
|
notification = value;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
await tester.pumpWidget(
|
|
MaterialApp(
|
|
home: Scaffold(
|
|
body: SizedBox.expand(
|
|
child: Scrollbar(
|
|
thumbVisibility: true,
|
|
controller: scrollController,
|
|
child: NotificationListener<ScrollNotification>(
|
|
onNotification: handleScrollNotification,
|
|
child: SingleChildScrollView(
|
|
controller: scrollController,
|
|
child: const SizedBox(height: 1200.0),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
),
|
|
);
|
|
|
|
await tester.pumpAndSettle();
|
|
expect(scrollController.offset, 0);
|
|
expect(notification, isNull);
|
|
|
|
final TestGesture dragScrollbarGesture = await tester.startGesture(const Offset(790, 45));
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isA<ScrollStartNotification>());
|
|
|
|
await dragScrollbarGesture.moveBy(const Offset(0, -20));
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isA<ScrollUpdateNotification>());
|
|
expect(scrollController.offset, 20);
|
|
|
|
await dragScrollbarGesture.moveBy(const Offset(0, -20));
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isA<ScrollUpdateNotification>());
|
|
expect(scrollController.offset, 40);
|
|
|
|
await dragScrollbarGesture.up();
|
|
await tester.pumpAndSettle();
|
|
expect(notification, isA<ScrollEndNotification>());
|
|
});
|
|
}
|