blob: 0c2f989427bed38638a65b8440cef52a4986065c [file] [log] [blame]
// Copyright 2017 The Chromium 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_test/flutter_test.dart';
import 'package:flutter/material.dart';
import 'package:flutter/rendering.dart';
import 'package:flutter/widgets.dart';
import 'package:flutter/gestures.dart' show DragStartBehavior;
import 'semantics_tester.dart';
import 'states.dart';
const Duration _frameDuration = Duration(milliseconds: 100);
void main() {
testWidgets('PageView control test', (WidgetTester tester) async {
final List<String> log = <String>[];
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageView(
dragStartBehavior: DragStartBehavior.down,
children: kStates.map<Widget>((String state) {
return GestureDetector(
dragStartBehavior: DragStartBehavior.down,
onTap: () {
log.add(state);
},
child: Container(
height: 200.0,
color: const Color(0xFF0000FF),
child: Text(state),
),
);
}).toList(),
),
));
await tester.tap(find.text('Alabama'));
expect(log, equals(<String>['Alabama']));
log.clear();
expect(find.text('Alaska'), findsNothing);
await tester.drag(find.byType(PageView), const Offset(-20.0, 0.0));
await tester.pump();
expect(find.text('Alabama'), findsOneWidget);
expect(find.text('Alaska'), findsOneWidget);
expect(find.text('Arizona'), findsNothing);
await tester.pumpAndSettle(_frameDuration);
expect(find.text('Alabama'), findsOneWidget);
expect(find.text('Alaska'), findsNothing);
await tester.drag(find.byType(PageView), const Offset(-401.0, 0.0));
await tester.pumpAndSettle(_frameDuration);
expect(find.text('Alabama'), findsNothing);
expect(find.text('Alaska'), findsOneWidget);
expect(find.text('Arizona'), findsNothing);
await tester.tap(find.text('Alaska'));
expect(log, equals(<String>['Alaska']));
log.clear();
await tester.fling(find.byType(PageView), const Offset(-200.0, 0.0), 1000.0);
await tester.pumpAndSettle(_frameDuration);
expect(find.text('Alabama'), findsNothing);
expect(find.text('Alaska'), findsNothing);
expect(find.text('Arizona'), findsOneWidget);
await tester.fling(find.byType(PageView), const Offset(200.0, 0.0), 1000.0);
await tester.pumpAndSettle(_frameDuration);
expect(find.text('Alabama'), findsNothing);
expect(find.text('Alaska'), findsOneWidget);
expect(find.text('Arizona'), findsNothing);
});
testWidgets('PageView does not squish when overscrolled', (WidgetTester tester) async {
await tester.pumpWidget(MaterialApp(
theme: ThemeData(platform: TargetPlatform.iOS),
home: PageView(
children: List<Widget>.generate(10, (int i) {
return Container(
key: ValueKey<int>(i),
color: const Color(0xFF0000FF),
);
}),
),
));
Size sizeOf(int i) => tester.getSize(find.byKey(ValueKey<int>(i)));
double leftOf(int i) => tester.getTopLeft(find.byKey(ValueKey<int>(i))).dx;
expect(leftOf(0), equals(0.0));
expect(sizeOf(0), equals(const Size(800.0, 600.0)));
// Going into overscroll.
await tester.drag(find.byType(PageView), const Offset(100.0, 0.0));
await tester.pump();
expect(leftOf(0), greaterThan(0.0));
expect(sizeOf(0), equals(const Size(800.0, 600.0)));
// Easing overscroll past overscroll limit.
await tester.drag(find.byType(PageView), const Offset(-200.0, 0.0));
await tester.pump();
expect(leftOf(0), lessThan(0.0));
expect(sizeOf(0), equals(const Size(800.0, 600.0)));
});
testWidgets('PageController control test', (WidgetTester tester) async {
final PageController controller = PageController(initialPage: 4);
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: Center(
child: SizedBox(
width: 600.0,
height: 400.0,
child: PageView(
controller: controller,
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
),
),
));
expect(find.text('California'), findsOneWidget);
controller.nextPage(duration: const Duration(milliseconds: 150), curve: Curves.ease);
await tester.pumpAndSettle(const Duration(milliseconds: 100));
expect(find.text('Colorado'), findsOneWidget);
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: Center(
child: SizedBox(
width: 300.0,
height: 400.0,
child: PageView(
controller: controller,
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
),
),
));
expect(find.text('Colorado'), findsOneWidget);
controller.previousPage(duration: const Duration(milliseconds: 150), curve: Curves.ease);
await tester.pumpAndSettle(const Duration(milliseconds: 100));
expect(find.text('California'), findsOneWidget);
});
testWidgets('PageController page stability', (WidgetTester tester) async {
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: Center(
child: SizedBox(
width: 600.0,
height: 400.0,
child: PageView(
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
),
),
));
expect(find.text('Alabama'), findsOneWidget);
await tester.drag(find.byType(PageView), const Offset(-1250.0, 0.0));
await tester.pumpAndSettle(const Duration(milliseconds: 100));
expect(find.text('Arizona'), findsOneWidget);
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: Center(
child: SizedBox(
width: 250.0,
height: 100.0,
child: PageView(
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
),
),
));
expect(find.text('Arizona'), findsOneWidget);
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: Center(
child: SizedBox(
width: 450.0,
height: 400.0,
child: PageView(
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
),
),
));
expect(find.text('Arizona'), findsOneWidget);
});
testWidgets('PageController nextPage and previousPage return Futures that resolve', (WidgetTester tester) async {
final PageController controller = PageController();
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageView(
controller: controller,
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
));
bool nextPageCompleted = false;
controller.nextPage(duration: const Duration(milliseconds: 150), curve: Curves.ease)
.then((_) => nextPageCompleted = true);
expect(nextPageCompleted, false);
await tester.pump(const Duration(milliseconds: 200));
expect(nextPageCompleted, false);
await tester.pump(const Duration(milliseconds: 200));
expect(nextPageCompleted, true);
bool previousPageCompleted = false;
controller.previousPage(duration: const Duration(milliseconds: 150), curve: Curves.ease)
.then((_) => previousPageCompleted = true);
expect(previousPageCompleted, false);
await tester.pump(const Duration(milliseconds: 200));
expect(previousPageCompleted, false);
await tester.pump(const Duration(milliseconds: 200));
expect(previousPageCompleted, true);
});
testWidgets('PageView in zero-size container', (WidgetTester tester) async {
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: Center(
child: SizedBox(
width: 0.0,
height: 0.0,
child: PageView(
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
),
),
));
expect(find.text('Alabama', skipOffstage: false), findsOneWidget);
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: Center(
child: SizedBox(
width: 200.0,
height: 200.0,
child: PageView(
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
),
),
));
expect(find.text('Alabama'), findsOneWidget);
});
testWidgets('Page changes at halfway point', (WidgetTester tester) async {
final List<int> log = <int>[];
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageView(
onPageChanged: log.add,
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
));
expect(log, isEmpty);
final TestGesture gesture =
await tester.startGesture(const Offset(100.0, 100.0));
// The page view is 800.0 wide, so this move is just short of halfway.
await gesture.moveBy(const Offset(-380.0, 0.0));
expect(log, isEmpty);
// We've crossed the halfway mark.
await gesture.moveBy(const Offset(-40.0, 0.0));
expect(log, equals(const <int>[1]));
log.clear();
// Moving a bit more should not generate redundant notifications.
await gesture.moveBy(const Offset(-40.0, 0.0));
expect(log, isEmpty);
await gesture.moveBy(const Offset(-40.0, 0.0));
await tester.pump();
await gesture.moveBy(const Offset(-40.0, 0.0));
await tester.pump();
await gesture.moveBy(const Offset(-40.0, 0.0));
await tester.pump();
expect(log, isEmpty);
await gesture.up();
await tester.pumpAndSettle();
expect(log, isEmpty);
expect(find.text('Alabama'), findsNothing);
expect(find.text('Alaska'), findsOneWidget);
});
testWidgets('Bouncing scroll physics ballistics does not overshoot', (WidgetTester tester) async {
final List<int> log = <int>[];
final PageController controller = PageController(viewportFraction: 0.9);
Widget build(PageController controller, { Size size }) {
final Widget pageView = Directionality(
textDirection: TextDirection.ltr,
child: PageView(
controller: controller,
onPageChanged: log.add,
physics: const BouncingScrollPhysics(),
children: kStates.map<Widget>((String state) => Text(state)).toList(),
),
);
if (size != null) {
return OverflowBox(
child: pageView,
minWidth: size.width,
minHeight: size.height,
maxWidth: size.width,
maxHeight: size.height,
);
} else {
return pageView;
}
}
await tester.pumpWidget(build(controller));
expect(log, isEmpty);
// Fling right to move to a non-existent page at the beginning of the
// PageView, and confirm that the PageView settles back on the first page.
await tester.fling(find.byType(PageView), const Offset(100.0, 0.0), 800.0);
await tester.pumpAndSettle();
expect(log, isEmpty);
expect(find.text('Alabama'), findsOneWidget);
expect(find.text('Alaska'), findsOneWidget);
expect(find.text('Arizona'), findsNothing);
// Try again with a Cupertino "Plus" device size.
await tester.pumpWidget(build(controller, size: const Size(414.0, 736.0)));
expect(log, isEmpty);
await tester.fling(find.byType(PageView), const Offset(100.0, 0.0), 800.0);
await tester.pumpAndSettle();
expect(log, isEmpty);
expect(find.text('Alabama'), findsOneWidget);
expect(find.text('Alaska'), findsOneWidget);
expect(find.text('Arizona'), findsNothing);
});
testWidgets('PageView viewportFraction', (WidgetTester tester) async {
PageController controller = PageController(viewportFraction: 7/8);
Widget build(PageController controller) {
return Directionality(
textDirection: TextDirection.ltr,
child: PageView.builder(
controller: controller,
itemCount: kStates.length,
itemBuilder: (BuildContext context, int index) {
return Container(
height: 200.0,
color: index % 2 == 0
? const Color(0xFF0000FF)
: const Color(0xFF00FF00),
child: Text(kStates[index]),
);
},
),
);
}
await tester.pumpWidget(build(controller));
expect(tester.getTopLeft(find.text('Alabama')), const Offset(50.0, 0.0));
expect(tester.getTopLeft(find.text('Alaska')), const Offset(750.0, 0.0));
controller.jumpToPage(10);
await tester.pump();
expect(tester.getTopLeft(find.text('Georgia')), const Offset(-650.0, 0.0));
expect(tester.getTopLeft(find.text('Hawaii')), const Offset(50.0, 0.0));
expect(tester.getTopLeft(find.text('Idaho')), const Offset(750.0, 0.0));
controller = PageController(viewportFraction: 39/40);
await tester.pumpWidget(build(controller));
expect(tester.getTopLeft(find.text('Georgia')), const Offset(-770.0, 0.0));
expect(tester.getTopLeft(find.text('Hawaii')), const Offset(10.0, 0.0));
expect(tester.getTopLeft(find.text('Idaho')), const Offset(790.0, 0.0));
});
testWidgets('Page snapping disable and reenable', (WidgetTester tester) async {
final List<int> log = <int>[];
Widget build({ bool pageSnapping }) {
return Directionality(
textDirection: TextDirection.ltr,
child: PageView(
pageSnapping: pageSnapping,
onPageChanged: log.add,
children:
kStates.map<Widget>((String state) => Text(state)).toList(),
),
);
}
await tester.pumpWidget(build(pageSnapping: true));
expect(log, isEmpty);
// Drag more than halfway to the next page, to confirm the default behavior.
TestGesture gesture = await tester.startGesture(const Offset(100.0, 100.0));
// The page view is 800.0 wide, so this move is just beyond halfway.
await gesture.moveBy(const Offset(-420.0, 0.0));
expect(log, equals(const <int>[1]));
log.clear();
// Release the gesture, confirm that the page settles on the next.
await gesture.up();
await tester.pumpAndSettle();
expect(find.text('Alabama'), findsNothing);
expect(find.text('Alaska'), findsOneWidget);
// Disable page snapping, and try moving halfway. Confirm it doesn't snap.
await tester.pumpWidget(build(pageSnapping: false));
gesture = await tester.startGesture(const Offset(100.0, 100.0));
// Move just beyond halfway, again.
await gesture.moveBy(const Offset(-420.0, 0.0));
// Page notifications still get sent.
expect(log, equals(const <int>[2]));
log.clear();
// Release the gesture, confirm that both pages are visible.
await gesture.up();
await tester.pumpAndSettle();
expect(find.text('Alabama'), findsNothing);
expect(find.text('Alaska'), findsOneWidget);
expect(find.text('Arizona'), findsOneWidget);
expect(find.text('Arkansas'), findsNothing);
// Now re-enable snapping, confirm that we've settled on a page.
await tester.pumpWidget(build(pageSnapping: true));
await tester.pumpAndSettle();
expect(log, isEmpty);
expect(find.text('Alaska'), findsNothing);
expect(find.text('Arizona'), findsOneWidget);
expect(find.text('Arkansas'), findsNothing);
});
testWidgets('PageView small viewportFraction', (WidgetTester tester) async {
final PageController controller = PageController(viewportFraction: 1/8);
Widget build(PageController controller) {
return Directionality(
textDirection: TextDirection.ltr,
child: PageView.builder(
controller: controller,
itemCount: kStates.length,
itemBuilder: (BuildContext context, int index) {
return Container(
height: 200.0,
color: index % 2 == 0
? const Color(0xFF0000FF)
: const Color(0xFF00FF00),
child: Text(kStates[index]),
);
},
),
);
}
await tester.pumpWidget(build(controller));
expect(tester.getTopLeft(find.text('Alabama')), const Offset(350.0, 0.0));
expect(tester.getTopLeft(find.text('Alaska')), const Offset(450.0, 0.0));
expect(tester.getTopLeft(find.text('Arizona')), const Offset(550.0, 0.0));
expect(tester.getTopLeft(find.text('Arkansas')), const Offset(650.0, 0.0));
expect(tester.getTopLeft(find.text('California')), const Offset(750.0, 0.0));
controller.jumpToPage(10);
await tester.pump();
expect(tester.getTopLeft(find.text('Connecticut')), const Offset(-50.0, 0.0));
expect(tester.getTopLeft(find.text('Delaware')), const Offset(50.0, 0.0));
expect(tester.getTopLeft(find.text('Florida')), const Offset(150.0, 0.0));
expect(tester.getTopLeft(find.text('Georgia')), const Offset(250.0, 0.0));
expect(tester.getTopLeft(find.text('Hawaii')), const Offset(350.0, 0.0));
expect(tester.getTopLeft(find.text('Idaho')), const Offset(450.0, 0.0));
expect(tester.getTopLeft(find.text('Illinois')), const Offset(550.0, 0.0));
expect(tester.getTopLeft(find.text('Indiana')), const Offset(650.0, 0.0));
expect(tester.getTopLeft(find.text('Iowa')), const Offset(750.0, 0.0));
});
testWidgets('PageView large viewportFraction', (WidgetTester tester) async {
final PageController controller =
PageController(viewportFraction: 5/4);
Widget build(PageController controller) {
return Directionality(
textDirection: TextDirection.ltr,
child: PageView.builder(
controller: controller,
itemCount: kStates.length,
itemBuilder: (BuildContext context, int index) {
return Container(
height: 200.0,
color: index % 2 == 0
? const Color(0xFF0000FF)
: const Color(0xFF00FF00),
child: Text(kStates[index]),
);
},
),
);
}
await tester.pumpWidget(build(controller));
expect(tester.getTopLeft(find.text('Alabama')), const Offset(-100.0, 0.0));
expect(tester.getBottomRight(find.text('Alabama')), const Offset(900.0, 600.0));
controller.jumpToPage(10);
await tester.pump();
expect(tester.getTopLeft(find.text('Hawaii')), const Offset(-100.0, 0.0));
});
testWidgets(
'Updating PageView large viewportFraction',
(WidgetTester tester) async {
Widget build(PageController controller) {
return Directionality(
textDirection: TextDirection.ltr,
child: PageView.builder(
controller: controller,
itemCount: kStates.length,
itemBuilder: (BuildContext context, int index) {
return Container(
height: 200.0,
color: index % 2 == 0
? const Color(0xFF0000FF)
: const Color(0xFF00FF00),
child: Text(kStates[index]),
);
},
),
);
}
final PageController oldController = PageController(viewportFraction: 5/4);
await tester.pumpWidget(build(oldController));
expect(tester.getTopLeft(find.text('Alabama')), const Offset(-100, 0));
expect(tester.getBottomRight(find.text('Alabama')), const Offset(900.0, 600.0));
final PageController newController = PageController(viewportFraction: 4);
await tester.pumpWidget(build(newController));
newController.jumpToPage(10);
await tester.pump();
expect(tester.getTopLeft(find.text('Hawaii')), const Offset(-(4 - 1) * 800 / 2, 0));
});
testWidgets(
'All visible pages are able to receive touch events',
(WidgetTester tester) async {
final PageController controller = PageController(viewportFraction: 1/4, initialPage: 0);
int tappedIndex;
Widget build() {
return Directionality(
textDirection: TextDirection.ltr,
child: PageView.builder(
controller: controller,
itemCount: 20,
itemBuilder: (BuildContext context, int index) {
return GestureDetector(
onTap: () => tappedIndex = index,
child: SizedBox.expand(child: Text('$index')),
);
},
),
);
}
Iterable<int> visiblePages = const <int> [0, 1, 2];
await tester.pumpWidget(build());
// The first 3 items should be visible and tappable.
for (int index in visiblePages) {
expect(find.text(index.toString()), findsOneWidget);
// The center of page 2's x-coordinate is 800, so we have to manually
// offset it a bit to make sure the tap lands within the screen.
final Offset center = tester.getCenter(find.text('$index')) - const Offset(3, 0);
await tester.tapAt(center);
expect(tappedIndex, index);
}
controller.jumpToPage(19);
await tester.pump();
// The last 3 items should be visible and tappable.
visiblePages = const <int> [17, 18, 19];
for (int index in visiblePages) {
expect(find.text('$index'), findsOneWidget);
await tester.tap(find.text('$index'));
expect(tappedIndex, index);
}
});
testWidgets('PageView does not report page changed on overscroll', (WidgetTester tester) async {
final PageController controller = PageController(
initialPage: kStates.length - 1,
);
int changeIndex = 0;
Widget build() {
return Directionality(
textDirection: TextDirection.ltr,
child: PageView(
children:
kStates.map<Widget>((String state) => Text(state)).toList(),
controller: controller,
onPageChanged: (int page) {
changeIndex = page;
},
),
);
}
await tester.pumpWidget(build());
controller.jumpToPage(kStates.length * 2); // try to move beyond max range
// change index should be zero, shouldn't fire onPageChanged
expect(changeIndex, 0);
await tester.pump();
expect(changeIndex, 0);
});
testWidgets('PageView can restore page', (WidgetTester tester) async {
final PageController controller = PageController();
try {
controller.page;
fail('Accessing page before attaching should fail.');
} on AssertionError catch (e) {
expect(
e.message,
'PageController.page cannot be accessed before a PageView is built with it.',
);
}
final PageStorageBucket bucket = PageStorageBucket();
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageStorage(
bucket: bucket,
child: PageView(
key: const PageStorageKey<String>('PageView'),
controller: controller,
children: const <Widget>[
Placeholder(),
Placeholder(),
Placeholder(),
],
),
),
));
expect(controller.page, 0);
controller.jumpToPage(2);
expect(await tester.pumpAndSettle(const Duration(minutes: 1)), 1);
expect(controller.page, 2);
await tester.pumpWidget(
PageStorage(
bucket: bucket,
child: Container(),
),
);
try {
controller.page;
fail('Accessing page after detaching all PageViews should fail.');
} on AssertionError catch (e) {
expect(
e.message,
'PageController.page cannot be accessed before a PageView is built with it.',
);
}
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageStorage(
bucket: bucket,
child: PageView(
key: const PageStorageKey<String>('PageView'),
controller: controller,
children: const <Widget>[
Placeholder(),
Placeholder(),
Placeholder(),
],
),
),
));
expect(controller.page, 2);
final PageController controller2 = PageController(keepPage: false);
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageStorage(
bucket: bucket,
child: PageView(
key: const PageStorageKey<String>('Check it again against your list and see consistency!'),
controller: controller2,
children: const <Widget>[
Placeholder(),
Placeholder(),
Placeholder(),
],
),
),
));
expect(controller2.page, 0);
});
testWidgets('PageView exposes semantics of children', (WidgetTester tester) async {
final SemanticsTester semantics = SemanticsTester(tester);
final PageController controller = PageController();
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageView(
controller: controller,
children: List<Widget>.generate(3, (int i) {
return Semantics(
child: Text('Page #$i'),
container: true,
);
}),
),
));
expect(controller.page, 0);
expect(semantics, includesNodeWith(label: 'Page #0'));
expect(semantics, isNot(includesNodeWith(label: 'Page #1')));
expect(semantics, isNot(includesNodeWith(label: 'Page #2')));
controller.jumpToPage(1);
await tester.pumpAndSettle();
expect(semantics, isNot(includesNodeWith(label: 'Page #0')));
expect(semantics, includesNodeWith(label: 'Page #1'));
expect(semantics, isNot(includesNodeWith(label: 'Page #2')));
controller.jumpToPage(2);
await tester.pumpAndSettle();
expect(semantics, isNot(includesNodeWith(label: 'Page #0')));
expect(semantics, isNot(includesNodeWith(label: 'Page #1')));
expect(semantics, includesNodeWith(label: 'Page #2'));
semantics.dispose();
});
testWidgets('PageMetrics', (WidgetTester tester) async {
final PageMetrics page = PageMetrics(
minScrollExtent: 100.0,
maxScrollExtent: 200.0,
pixels: 150.0,
viewportDimension: 25.0,
axisDirection: AxisDirection.right,
viewportFraction: 1.0,
);
expect(page.page, 6);
final PageMetrics page2 = page.copyWith(
pixels: page.pixels - 100.0,
);
expect(page2.page, 4.0);
});
testWidgets('Page controller can handle rounding issue', (WidgetTester tester) async {
final PageController pageController = PageController();
await tester.pumpWidget(Directionality(
textDirection: TextDirection.ltr,
child: PageView(
controller: pageController,
children: List<Widget>.generate(3, (int i) {
return Semantics(
child: Text('Page #$i'),
container: true,
);
}),
),
));
// Simulate precision error.
pageController.position.jumpTo(799.99999999999);
expect(pageController.page, 1);
});
}