context_menu_android 1.0.5

iOS-style context menu widget for Flutter with blur, smooth animations, and nested sub-menus; optimized for Android.

🍎 ios_style_context_menu

A Flutter package that brings the elegant iOS-style context menu experience to Android — complete with blur effects, fluid animations, and nested sub-menus.
Perfect for creating beautiful long-press menus on any widget, such as cards, images, or list items — all with the finesse of Apple design.

---

✨ Why ios_style_context_menu?

Feature	Description
🍏 True iOS Feel	Replicates iOS’s smooth context menu interaction, animations, and visual hierarchy.
🧩 Fully Customizable	Adjust text, icons, colors, padding, and animation curves — effortlessly.
💫 Smooth Transitions	Powered by Flutter animations and BackdropFilter for silky blur effects.
🪄 Nested Menus Support	Easily create sub-menus with back navigation — ideal for complex actions.
🌗 Dark & Light Themes	Automatically adapts to the system theme or use isDark to override.
🧠 Smart Delete Detection	Destructive actions (like “Delete”) are automatically highlighted in red.
⚙️ Performance-Optimized	Uses efficient animation controllers and responsive sizing for any screen.

---

🚀 Getting Started

Add to your project:

dependencies:
  ios_style_context_menu: ^1.0.5

Then run:

flutter pub get

Import it in your code:

import 'package:ios_style_context_menu/ios_style_context_menu.dart';

---

🧠 Basic Usage

Wrap any widget with IosStyleContextMenu and pass a list of actions:

IosStyleContextMenu(
  child: Image.network('https://picsum.photos/200'),
  actions: [
    ContextMenuAndroid(
      icon: Icons.share,
      label: 'Share',
      onTap: () => print('Shared!'),
    ),
    ContextMenuAndroid(
      icon: Icons.favorite,
      label: 'Add to Favorites',
      onTap: () => print('Added to favorites!'),
    ),
    ContextMenuAndroid(
      icon: Icons.delete,
      label: 'Delete',
      onTap: () => print('Deleted!'),
    ),
  ],
);

---

🌿 Advanced Example with Sub-Menus

IosStyleContextMenu(
  child: Card(
    elevation: 6,
    child: ListTile(
      leading: Icon(Icons.movie),
      title: Text('Inception'),
      subtitle: Text('Tap & hold for menu'),
    ),
  ),
  actions: [
    ContextMenuAndroid(
      icon: Icons.play_arrow,
      label: 'Play',
      onTap: () => print('Playing Inception...'),
    ),
    ContextMenuAndroid(
      icon: Icons.more_horiz,
      label: 'More',
      subMenu: [
        ContextMenuAndroid(
          icon: Icons.info_outline,
          label: 'Details',
          onTap: () => print('Opening details...'),
        ),
        ContextMenuAndroid(
          icon: Icons.download,
          label: 'Download',
          onTap: () => print('Downloading...'),
        ),
      ],
    ),
  ],
);

---

⚙️ Customization Options

Property	Type	Description
child	Widget	Required. The widget that triggers the context menu.
actions	List<ContextMenuAndroid>	Required. A list of action items, each with icon, label, and callback.
isDark	bool?	Forces dark mode (if not set, it follows system theme).
textStyle	TextStyle?	Custom text style for action labels.
backgroundColor	Color?	Background color of the menu container (defaults based on theme).
dividerColor	Color?	Divider color between menu items.
iconColor	Color?	Icon color (automatically turns red for “Delete” actions).
contentPadding	EdgeInsetsGeometry?	Padding around the menu container.
textSize	double?	Font size for text, scales responsively.
iconSize	double?	Optional icon size (currently unused by default).

---

📸 Live Preview

---

🧱 Architecture Overview

lib/
├── ios_style_context_menu.dart    # Core widget and animations
├── context_menu.dart              # Data model for menu actions
└── src/
    ├── animations/
    ├── widgets/
    └── utils/

---

💡 Pro Tips

• ✅ Use Navigator.pop(context) manually only if you wrap custom dialogs inside.
• 🔁 You can open nested sub-menus dynamically using subMenu property.
• 🎨 Combine with Theme.of(context) for adaptive color matching.
• 🕹 Long-press gesture wrappers can be added for auto-open menus.

---

🧰 Planned Add-ons (v2.0)

• ✨ Built-in long-press wrapper (IosContextMenuWrapper).
• 🔊 Haptic feedback for tap and open events.
• 🎬 Custom animation styles (fade, slide, scale).
• 🧩 Public theme configuration class (ContextMenuThemeData).

---

📄 License

This project is licensed under the MIT License.
You’re free to use, modify, and distribute it with proper attribution.

---

❤️ Credits

Developed and maintained with 💙 by
Omar Shawkey

"Design like Apple. Animate like Flutter." 🍏