Search packages, repositories and app categories

GitHub repositorycaseyryan/flutter_cupertino_bottom_sheet

flutter_cupernino_bottom_sheet

A package that mimics a fullscreen Cupertino Style bottom sheet

flutter_cupernino_bottom_sheet project cover
Stars
10
Forks
3
Last push (UTC)
Oct 14, 2024
Project status
Active

Original README

English project snapshot. Visit GitHub for the latest content.

A package that mimics a Cupertino bottom sheet like this VERY EASILY

pub.devstyle: effective dart Awesome Flutter

Apr-20-2023 11-43-53

Unlike existing packages that can mimic the same behavior flutter_cupertino_bottom_sheet does not require a scaffold for this purpose and can be used from any place and any time. You don't have to use any special code except for wrapping your MaterialApp with CupertinoBottomSheetRepaintBoundary() at the beginning. And that's it. That simple. You don't even need a specific context for it to work

How it works.

It's very simple. Internally it uses a repaint boundary to create a screenshot of the whole screen and make a RawImage out of it. So it doesn't matter if the previous route maintains its state or not. It doesn't really need to know anything about the previous route as it uses a screenshot instead of a widget snapshot

Getting started

import the package where you initialize your app

import 'package:flutter_cupertino_bottom_sheet/flutter_cupertino_bottom_sheet.dart';

And then wrap your MaterialApp or whatever type you use with CupertinoBottomSheetRepaintBoundary

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return CupertinoBottomSheetRepaintBoundary(
      child: MaterialApp(
        ...
      ),
    );
  }
}

This will provide a necessary RenderRepaintBoundary for the library to work.

Then you can use a Navigator to push this route like this:

Navigator.of(context).push(
    CupertinoBottomSheetRoute(
        args: const CupertinoBottomSheetRouteArgs(
            swipeSettings: SwipeSettings(
            canCloseBySwipe: true,
            ),
        ),
        builder: (context) {
            return const TestPage();
        },
    ),
);
Want less code? No problem.

Pass a cupertinoBottomSheetNavigatorKey to your App initialization

@override
Widget build(BuildContext context) {
  return CupertinoBottomSheetRepaintBoundary(
    child: MaterialApp(
      navigatorKey: cupertinoBottomSheetNavigatorKey,
      ...
    ),
  );
}

And then call openCupertinoBottomSheet() from any place, regardless of context

openCupertinoBottomSheet(builder: (c) {
    return const TestPage();
    args: CupertinoBottomSheetRouteArgs(
      appBar: CupertinoBottomSheetAppBar.withCloseButton(
        title: 'Cupertino Actionsheet',
        buttonText: 'Done',
        headerStyle: Theme.of(context).textTheme.bodyMedium,
        onClosePressed: Navigator.of(context).pop,
      ),
    ),
});
Konstantin Serov GitHub avatar
GitHub author

Konstantin Serov ↗

Senior Flutter / Dart developer passionate for cool complex modern UI designs. 8+ years of commercial work on Flutter and 9+ years of other technologies

Serov KonstantinNovosibirskOfficial website ↗
LanguagesDartC++CMakeRubyHTMLCSwiftKotlinObjective-C

Dependencies used

Dependency list 4 items

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗