syncfusion-maui-toolkit-navigation-drawer

用途

Syncfusion .NET MAUI Navigation Drawer（SfNavigationDrawer）是一个灵活的组件，用于在 .NET MAUI 应用中创建从屏幕边缘滑出的导航面板。适用于汉堡菜单、侧边导航面板、底部抽屉导航、应用抽屉、覆盖式菜单等滑动式导航场景。

主要能力

• 四方向定位：抽屉面板可从左侧、右侧、顶部或底部滑入。
• 动画过渡：支持 SlideOnTop、Push、Reveal 三种动画类型。
• 滑动手势：支持通过滑动打开或关闭抽屉。
• 事件处理：提供 DrawerOpening、DrawerOpened、DrawerClosing、DrawerClosed、DrawerToggled 事件。
• 尺寸配置：可配置抽屉的宽度或高度以及动画时长。
• 内容布局：支持复杂抽屉内容布局，包含主内容区、头部和抽屉面板。

组件结构

SfNavigationDrawer 由两个主要区域组成：

• ContentView：始终可见的主内容区域（必填）。
• Drawer Pane：从屏幕边缘滑入的隐藏面板，可定位为 Left、Right、Top 或 Bottom。

使用方式

该技能按以下参考文档组织，建议根据实现需求按顺序阅读：

1. 入门（references/getting-started.md）：安装 Syncfusion MAUI Toolkit 包、在 MauiProgram.cs 中注册处理器、创建第一个 Navigation Drawer、设置 ContentView（必填）、基础 XAML 与 C# 实现。
2. 内容配置与布局（references/drawer-content.md）：配置主内容（ContentView 属性）、设置抽屉面板内容、头部与布局配置、动态内容切换、内容组织最佳实践。
3. 定位与尺寸（references/positioning-sizing.md）：抽屉定位（Left、Right、Top、Bottom）、DrawerSettings 配置、设置抽屉宽度与高度、抽屉头部尺寸、响应式尺寸模式。
4. 事件与交互处理（references/events-interaction.md）：事件类型（DrawerOpening、DrawerOpened、DrawerClosing、DrawerClosed、DrawerToggled）、处理抽屉状态变化、取消抽屉操作、基于事件的导航模式、用户交互工作流。
5. 动画与过渡（references/animations-transitions.md）：动画类型（SlideOnTop、Push、Reveal）、时长配置与计时、切换动画设置、平滑过渡模式、性能注意事项。
6. 手势与无障碍（references/gestures-accessibility.md）：打开/关闭的滑动手势支持、以编程方式切换抽屉、键盘交互与无障碍、屏幕阅读器支持、包容性设计最佳实践。

适用场景

• 需要在 .NET MAUI 应用中实现滑动面板导航。
• 需要从屏幕左、右、上、下边缘定位导航面板。
• 需要处理抽屉交互，包括打开/关闭事件、动画和手势支持。
• 需要配置包含主内容区、头部和抽屉面板布局的抽屉内容。
• 需要通过动画、尺寸和样式选项自定义外观。
• 需要添加响应滑动或以编程方式切换的移动端友好导航。
• 需要管理复杂导航流程，由抽屉提供上下文菜单或附加选项。

限制

资料未提供该控件的收费、价格、平台兼容性、性能指标或具体效果等信息，暂未提供。