syncfusion-maui-navigation-drawer

$npx mdskill add syncfusion/maui-ui-components-skills/syncfusion-maui-navigation-drawer

Implements Syncfusion .NET MAUI Navigation Drawer for sliding panels.

  • Creates navigation menus, hamburger menus, and drawer-based layouts.
  • Depends on Syncfusion .NET MAUI toolkit (SfNavigationDrawer).
  • Configures drawer position, animation, swipe gestures, and events.
  • Renders a sliding drawer with main content and customizable pane.

SKILL.md

.github/skills/syncfusion-maui-navigation-drawerView on GitHub ↗
---
name: syncfusion-maui-navigation-drawer
description: Implements Syncfusion .NET MAUI Navigation Drawer (SfNavigationDrawer) component. Use when working with navigation drawers, sliding drawers, side menus, hamburger menus, or drawer panels in .NET MAUI apps. Covers drawer positioning (left/right/top/bottom), animations (SlideOnTop/Push/Reveal), content management, swipe gestures, and events.
metadata:
  author: "Syncfusion Inc"
  version: "34.1.29"
---

# Implementing Navigation Drawers

The .NET MAUI Navigation Drawer (SfNavigationDrawer) is a component for creating navigation panes with sliding drawer functionality. It consists of a main content area and a sliding pane that extends from any edge of the screen. The drawer can be opened via swipe gestures or programmatically, supporting multiple positions, animations, and customization options.

## When to Use This Skill

Use this skill when the user needs to:

- **Navigation menus** - Side panels for app navigation with menu items
- **Hamburger menus** - Classic mobile navigation pattern with slide-out drawer
- **Drawer-based layouts** - Apps requiring slide-out panels from any screen edge
- **Multi-drawer UIs** - Applications with drawers on multiple sides (left and right)
- **Swipe navigation** - Touch-based drawer interaction with gesture support
- **Animated transitions** - Smooth drawer animations (SlideOnTop, Push, Reveal)
- **Context panels** - Secondary content areas that slide in/out on demand

## Component Overview

The **SfNavigationDrawer** control provides:
- Four-directional positioning (Left, Right, Top, Bottom)
- Three animation types (SlideOnTop, Push, Reveal)
- Content areas: Drawer header, Drawer footer, Drawer content, Main Content
- Programmatic and gesture-based control
- Event-driven architecture for drawer state
- Multi-drawer support (primary + secondary)
- Customizable sizing and backgrounds
- Swipe gesture configuration
- Liquid glass effect (iOS 26+, macOS 26+, .NET 10+)

## Documentation and Navigation Guide

### Getting Started
📄 **Read:** [references/getting-started.md](references/getting-started.md)

When to read: User is setting up NavigationDrawer for the first time or needs installation guidance.
- NuGet package installation (Syncfusion.Maui.NavigationDrawer)
- Registering Syncfusion handler (.ConfigureSyncfusionCore())
- Basic drawer implementation with ContentView
- Creating hamburger menu toggle
- First working example with drawer content

### Drawer Positioning and Sizing
📄 **Read:** [references/drawer-positioning.md](references/drawer-positioning.md)

When to read: User needs to position drawer on specific side or adjust drawer dimensions.
- Position property (Left, Right, Top, Bottom)
- DrawerWidth for left/right positioning
- DrawerHeight for top/bottom positioning
- Side-specific configuration examples
- Sizing best practices

### Content Management
📄 **Read:** [references/content-management.md](references/content-management.md)

When to read: User needs to set up drawer content areas, headers, footers, or main content.
- ContentView (main content area - mandatory)
- DrawerHeaderView configuration
- DrawerContentView (navigation menu content)
- DrawerFooterView setup
- Header/footer height customization
- ContentBackground styling
- Using CollectionView as drawer content
- Dynamic content switching patterns

### Animations and Transitions
📄 **Read:** [references/animations-transitions.md](references/animations-transitions.md)

When to read: User wants to customize drawer opening/closing animations or effects.
- Transition types (SlideOnTop, Push, Reveal)
- Animation differences and use cases
- Duration property for animation speed
- AnimationEasing customization
- Performance considerations
- Visual comparison of animation types

### Toggling and Drawer Control
📄 **Read:** [references/toggling-drawer.md](references/toggling-drawer.md)

When to read: User needs to open/close drawer programmatically or control drawer state.
- ToggleDrawer() method
- IsOpen property for state management
- Programmatic open/close operations
- Setting initial drawer state
- Closing drawer on menu item selection
- Integration with hamburger button

### Event Handling
📄 **Read:** [references/events.md](references/events.md)

When to read: User needs to respond to drawer state changes or control drawer behavior.
- DrawerOpening event (with cancellation)
- DrawerOpened event
- DrawerClosing event (with cancellation)
- DrawerClosed event
- DrawerToggled event
- Event arguments and usage patterns
- Preventing drawer open/close with Cancel property

### Swipe Gestures
📄 **Read:** [references/swipe-gestures.md](references/swipe-gestures.md)

When to read: User wants to enable/disable swipe gestures or adjust touch sensitivity.
- EnableSwipeGesture property
- TouchThreshold for swipe region
- Swipe-to-open behavior
- Swipe-to-close behavior
- Disabling gestures when needed
- Adjusting sensitivity for different devices

### Advanced Features
📄 **Read:** [references/advanced-features.md](references/advanced-features.md)

When to read: User needs multi-drawer setup, liquid glass effects, or complex drawer scenarios.
- Multi-drawer implementation (DrawerSettings + SecondaryDrawerSettings)
- ToggleSecondaryDrawer() method
- Opening multiple drawers on different sides
- Liquid glass effect (EnableLiquidGlassEffect)
- LiquidGlassSettings for iOS 26+/macOS 26+
- Complex navigation patterns
- Performance optimization techniques

More from syncfusion/maui-ui-components-skills

SkillDescription
syncfusion-maui-accordionImplements Syncfusion .NET MAUI Accordion (SfAccordion) - a vertically collapsible panel with stacked headers for expanding/collapsing content. Use when working with accordions, collapsible panels, expandable lists, employee lists with details, or FAQ sections in .NET MAUI applications. Covers AccordionItem configuration, expand modes, and grouped content display.
syncfusion-maui-ai-assistviewImplements Syncfusion .NET MAUI AI AssistView (SfAIAssistView) for AI-powered interactive chat interfaces. Use when working with AI chat interfaces, AI AssistView, SfAIAssistView, conversational UI, or chat with AI responses. Covers integrating AI services, creating chat UIs, implementing conversation flows, managing AI requests/responses, and displaying AI suggestions.
syncfusion-maui-autocompleteImplements and configure Syncfusion .NET MAUI Autocomplete (SfAutocomplete) control for intelligent text input with suggestions. Use when implementing autocomplete, autosuggest, type-ahead search, smart search, or filtered dropdowns in .NET MAUI applications. Covers data binding, filtering modes, custom search logic, AI-powered search, multi-selection with tokens, and UI customization.
syncfusion-maui-avatar-viewImplements Syncfusion .NET MAUI Avatar View (SfAvatarView) for displaying user profile pictures, initials, or group avatars. Use when working with avatar views, profile pictures, user images, initials display, profile icons, or contact images. Ideal for implementing user profile displays, contact lists, chat interfaces, or social feeds.
syncfusion-maui-backdropImplements Syncfusion .NET MAUI Backdrop Page (SfBackdropPage) with back layer and front layer surfaces. Use when working with backdrop pages, SfBackdropPage, back layer, front layer, or reveal/conceal animations. Covers backdrop navigation patterns, header icons, corner shapes, reveal height, layer state events, and liquid glass effect.
syncfusion-maui-badge-viewImplements Syncfusion .NET MAUI Badge View (SfBadgeView) control. Use when adding badge notifications, status indicators, unread counts, or notification overlays to MAUI applications. Covers SfBadgeView setup, badge text customization, position adjustments, animations, predefined symbols, and accessibility features.
syncfusion-maui-barcode-generatorImplements Syncfusion .NET MAUI Barcode Generator (SfBarcodeGenerator) for generating machine-readable barcodes. Use when working with barcodes, barcode generation, QR codes, data matrix, EAN codes, UPC codes, Code128, or Code39. This skill covers both one-dimensional (linear) and two-dimensional (matrix) barcode symbologies with extensive customization options.
syncfusion-maui-busy-indicatorImplements Syncfusion .NET MAUI Busy Indicator (SfBusyIndicator) for showing loading states, data processing, and app activity indicators. Use when displaying loading indicators, busy animations, activity spinners, or processing feedback in .NET MAUI apps. Covers busy indicator setup, animations, and visual feedback during long-running operations.
syncfusion-maui-buttonImplements and customize Syncfusion .NET MAUI Button (SfButton) control. Use when working with MAUI buttons, SfButton implementation, button customization, or visual states. Covers button icons, background images, RTL support, Liquid Glass effects, custom button views, button styling, events, and checkable buttons.
syncfusion-maui-calendarImplements and customize Syncfusion .NET MAUI Calendar (SfCalendar) control. Use when implementing calendar functionality, date selection (single, multiple, range), or calendar views (month, year, decade, century). Covers date restrictions (min/max dates, EnablePastDates, SelectableDayPredicate), calendar customization, events (ViewChanged, SelectionChanged, Tapped), and header/footer customization.