flutter · MitchellGoodwin · Oct 7, 2025 · Oct 16, 2025 · Oct 21, 2025 · Oct 29, 2025
diff --git a/examples/api/lib/cupertino/sheet/cupertino_sheet.3.dart b/examples/api/lib/cupertino/sheet/cupertino_sheet.3.dart
@@ -0,0 +1,122 @@
+// 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/cupertino.dart';
+
+/// Flutter code sample for [CupertinoSheetRoute].
+
+void main() {
+  runApp(const CupertinoSheetApp());
+}
+
+class CupertinoSheetApp extends StatelessWidget {
+  const CupertinoSheetApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const CupertinoApp(
+      title: 'Scrollable Cupertino Sheet',
+      home: HomePage(),
+    );
+  }
+}
+
+class HomePage extends StatelessWidget {
+  const HomePage({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return CupertinoPageScaffold(
+      navigationBar: const CupertinoNavigationBar(
+        middle: Text('Scrollable Cupertino Sheet Example'),
+        automaticBackgroundVisibility: false,
+      ),
+      child: Center(
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: <Widget>[
+            CupertinoButton.filled(
+              onPressed: () {
+                Navigator.of(context).push(
+                  CupertinoSheetRoute<void>.scrollable(
+                    scrollableBuilder:
+                        (BuildContext context, ScrollController controller) =>
+                            _ScrollableSheetBody(scrollController: controller),
+                  ),
+                );
+              },
+              child: const Text('Open Sheet'),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _ScrollableSheetBody extends StatelessWidget {
+  const _ScrollableSheetBody({required this.scrollController});
+
+  final ScrollController scrollController;
+
+  @override
+  Widget build(BuildContext context) {
+    return CupertinoPageScaffold(
+      navigationBar: CupertinoSheetNavbar(
+        child: CupertinoNavigationBar(
+          backgroundColor: CupertinoColors.systemGrey3,
+          middle: const Text('Scrollable Sheet'),
+          automaticBackgroundVisibility: false,
+          leading: CupertinoButton(
+            padding: EdgeInsets.zero,
+            child: const Text('Close'),
+            onPressed: () {
+              CupertinoSheetRoute.popSheet(context);
+            },
+          ),
+        ),
+      ),
+      child: CustomScrollView(
+        controller: scrollController,
+        primary: false,
+        slivers: <Widget>[
+          SliverList(
+            delegate: SliverChildBuilderDelegate((
+              BuildContext context,
+              int index,
+            ) {
+              return Container(
+                alignment: Alignment.center,
+                height: 100,
+                child: const Text('Scroll Me'),
+              );
+            }, childCount: 20),
+          ),
+        ],
+      ),
+    );
+  }
+}
+
+class CupertinoSheetNavbar extends StatelessWidget
+    implements ObstructingPreferredSizeWidget {
+  const CupertinoSheetNavbar({super.key, required this.child});
+
+  final CupertinoNavigationBar child;
+
+  @override
+  bool shouldFullyObstruct(BuildContext context) {
+    return child.shouldFullyObstruct(context);
+  }
+
+  @override
+  Size get preferredSize {
+    return child.preferredSize;
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return CupertinoSheetDragArea(child: child);
+  }
+}
diff --git a/examples/api/test/cupertino/sheet/cupertino_sheet.3_test.dart b/examples/api/test/cupertino/sheet/cupertino_sheet.3_test.dart
@@ -0,0 +1,62 @@
+// 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/rendering.dart';
+import 'package:flutter_api_samples/cupertino/sheet/cupertino_sheet.3.dart'
+    as example;
+import 'package:flutter_test/flutter_test.dart';
+
+void main() {
+  testWidgets('Tap on button displays cupertino sheet', (
+    WidgetTester tester,
+  ) async {
+    await tester.pumpWidget(const example.CupertinoSheetApp());
+
+    final Finder dialogTitle = find.text('Scrollable Sheet');
+    expect(dialogTitle, findsNothing);
+
+    await tester.tap(find.text('Open Sheet'));
+    await tester.pumpAndSettle();
+    expect(dialogTitle, findsOneWidget);
+
+    await tester.tap(find.text('Close'));
+    await tester.pumpAndSettle();
+    expect(dialogTitle, findsNothing);
+  });
+
+  testWidgets('Drag on nav bar triggers drag only', (
+    WidgetTester tester,
+  ) async {
+    await tester.pumpWidget(const example.CupertinoSheetApp());
+
+    final Finder dialogTitle = find.text('Scrollable Sheet');
+    expect(dialogTitle, findsNothing);
+
+    await tester.tap(find.text('Open Sheet'));
+    await tester.pumpAndSettle();
+    expect(dialogTitle, findsOneWidget);
+
+    final RenderBox box =
+        tester.renderObject(find.text('Scrollable Sheet')) as RenderBox;
+    final Offset navbarOffset = box.localToGlobal(Offset.zero);
+    final double initialSheetHeight = navbarOffset.dy;
+
+    final TestGesture gesture = await tester.startGesture(navbarOffset);
+    await gesture.moveBy(const Offset(0, -50));
+    await tester.pump();
+
+    // Upwards drag triggers stretch, and not scroll.
+    final double currentSheetHeight = box.localToGlobal(Offset.zero).dy;
+    expect(currentSheetHeight, lessThan(initialSheetHeight));
+
+    await gesture.moveBy(const Offset(0, 200));
+    await tester.pump();
+
+    final double finalSheetHeight = box.localToGlobal(Offset.zero).dy;
+    expect(finalSheetHeight, greaterThan(initialSheetHeight));
+
+    await gesture.up();
+    await tester.pumpAndSettle();
+  });
+}