flutter_root_context_menu

A customizable context menu package for Flutter with animation support, flexible styling, and web-like behavior.

Features

• Manual trigger with full control over position and timing
• Nested submenu support with unlimited depth
• 9 built-in animations + custom animation support
• Custom widget items (Switch, Checkbox, Slider, etc.)
• Customizable styling (colors, sizes, elevation, shadows, border radius)
• Smart positioning with automatic overflow prevention
• Area constraints via ContextMenuArea
• Auto-close on route changes via ContextMenuRouteObserver
• Async callback support

Installation

dependencies:
  flutter_root_context_menu: ^0.7.0

Quick Start

import 'package:flutter_root_context_menu/flutter_root_context_menu.dart';

GestureDetector(
  onSecondaryTapDown: (details) {
    showRootContextMenu(
      context: context,
      position: details.globalPosition,
      items: [
        ContextMenuItem(
          label: 'Copy',
          icon: Icon(Icons.copy, size: 18),
          onTap: () => print('Copy'),
        ),
        ContextMenuItem.divider(),
        ContextMenuItem(
          label: 'Delete',
          icon: Icon(Icons.delete, size: 18),
          textColor: Colors.red,
          onTap: () => print('Delete'),
        ),
      ],
    );
  },
  child: Text('Right-click me'),
)

Menu Item Types

Type	Description
ContextMenuItem(...)	Standard item with label, icon, onTap
ContextMenuItem.divider()	Separator line
ContextMenuItem.custom(builder: ...)	Custom widget (Switch, Checkbox, etc.)
ContextMenuItem.submenu(...)	Nested submenu with children

Submenu

ContextMenuItem.submenu(
  label: 'Share',
  icon: Icon(Icons.share, size: 18),
  children: [
    ContextMenuItem(label: 'Email', onTap: () {}),
    ContextMenuItem(label: 'Slack', onTap: () {}),
    ContextMenuItem.divider(),
    ContextMenuItem.submenu(
      label: 'Social',
      children: [
        ContextMenuItem(label: 'Twitter', onTap: () {}),
        ContextMenuItem(label: 'Facebook', onTap: () {}),
      ],
    ),
  ],
)

Submenus support:

• Unlimited nesting depth (configurable via maxSubmenuDepth)
• Auto left/right flip when hitting screen edges
• Hover open/close with configurable delays
• Tap to open on touch devices
• Independent animation and duration settings
• All item types inside submenus (standard, divider, custom, submenu)

Configuration Options

ContextMenuConfig(
  // Style
  backgroundColor: Colors.white,
  hoverColor: Color(0xFFE0E0E0),
  textStyle: TextStyle(fontSize: 14),
  itemHeight: 40.0,
  minWidth: 180.0,
  maxWidth: 280.0,
  itemPadding: EdgeInsets.symmetric(horizontal: 16.0),
  borderRadius: BorderRadius.circular(8.0),
  elevation: 8.0,
  boxShadow: null,

  // Layout
  screenPadding: EdgeInsets.zero,
  itemBorderRadius: BorderRadius.zero,
  itemMargin: EdgeInsets.zero,
  dividerMargin: EdgeInsets.zero,
  menuPadding: EdgeInsets.zero,
  iconWidth: 0,
  iconSpacing: 0,

  // Animation
  animationDuration: Duration(milliseconds: 200),
  animationBuilder: ContextMenuAnimations.popup,

  // Submenu
  submenuOpenDelay: Duration(milliseconds: 200),
  submenuCloseDelay: Duration(milliseconds: 300),
  submenuHorizontalOffset: -4.0,
  submenuAnimationBuilder: null,       // null = auto (slideRight/slideLeft)
  submenuAnimationDuration: null,      // null = use animationDuration
  maxSubmenuDepth: 5,
)

Available Animations

Animation	Description
popup	Scale + fade (default)
fade	Fade in only
slideUp	Slide from bottom
slideDown	Slide from top
slideRight	Slide from left
slideLeft	Slide from right
bounce	Elastic bounce effect
scale	Scale only
none	No animation

Helper Functions

closeRootContextMenu();       // Close the menu
isRootContextMenuOpen();      // Check if menu is open

Documentation

• Basic Usage & Styling
• Custom Widget Items
• Area Constraints
• Animations
• Route Observer & Manual Control

Example App

cd example
flutter run

License

MIT License