Adaptive Menu #

A Flutter package that provides an adaptive menu widget. It displays a native iOS pull-down menu on iOS and a Material Design popup menu on other platforms. This ensures your app feels native on every device, especially on iOS.

Features #

• Platform-Adaptive: Automatically uses UIMenu on iOS for a native feel and falls back to PopupMenuButton on Android and other platforms.
• Easy to Use: A simple AdaptiveMenu widget that takes a list of actions and a child to display.
• Customizable: Supports menu groups, icons, and destructive actions.

Getting Started #

Add the package to your pubspec.yaml:

dependencies:
  adaptive_menu: ^0.0.1 # Replace with the latest version

Then run flutter pub get.

Usage #

Here's a simple example of how to use the AdaptiveMenu widget.

import 'package:adaptive_menu/adaptive_menu.dart';

class MenuDemo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Adaptive Menu Demo'),
        actions: [
          AdaptiveMenu(
            // The widget that will trigger the menu.
            child: Icon(Icons.more_vert),
            // The items to display in the menu.
            items: [
              AdaptiveMenuAction(
                title: 'Share',
                icon: Icons.share,
                onPressed: () => print('Shared!'),
              ),
              AdaptiveMenuAction(
                title: 'Favorite',
                icon: Icons.favorite,
                onPressed: () => print('Favorited!'),
              ),
              // Use an inline group to create a section with a divider.
              AdaptiveMenuGroup.inline(
                actions: [
                  AdaptiveMenuAction.destructive(
                    title: 'Delete',
                    icon: Icons.delete,
                    onPressed: () => print('Deleted!'),
                  ),
                ],
              ),
            ],
          ),
        ],
      ),
      body: Center(
        child: Text('Press the menu button in the app bar!'),
      ),
    );
  }
}

Forcing a Menu Type #

By default, AdaptiveMenu chooses the menu type based on the platform. However, you can force a specific type using the type parameter:

AdaptiveMenu(
  // Force a Material menu, even on iOS.
  type: AdaptiveMenuType.material,
  child: Icon(Icons.more_vert),
  items: [
    // ... your menu items
  ],
)

Limitations #

• The provided MaterialMenu uses Flutter's built-in MenuAnchor widget, which currently doesn't support customizing animations. Refer to this issue for more information.

• Widgets with too much drop shadow such as Card or Container with elevation higher than 1.0 might not be displayed correctly (shadows might be cropped).