$npx -y skills add syncfusion/maui-ui-components-skills --skill 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,
| 1 | # Implementing Backdrop Pages (.NET MAUI) |
| 2 | |
| 3 | The Syncfusion **SfBackdropPage** is a layered page with two surfaces: |
| 4 | - **Back Layer** — holds actionable/contextual content (navigation menus, filters) |
| 5 | - **Front Layer** — always visible, holds primary content; slides down to reveal the back layer |
| 6 | |
| 7 | The back layer can be revealed/concealed via toolbar icon, touch/swipe, or programmatically. |
| 8 | |
| 9 | ## When to Use This Skill |
| 10 | |
| 11 | Use this skill when the user needs to: |
| 12 | |
| 13 | - **Implement menu-driven navigation** with a sliding front layer |
| 14 | - **Build filter or search panels** that slide in from behind primary content |
| 15 | - **Add reveal and conceal animations** to a layered page |
| 16 | - **Customize backdrop header icons**, corner shapes, or reveal height |
| 17 | - **Handle `BackLayerStateChanged` events** for state tracking |
| 18 | - **Apply the Liquid Glass Effect** to backdrop layers |
| 19 | |
| 20 | ## Component Overview |
| 21 | |
| 22 | The **SfBackdropPage** control provides: |
| 23 | - **Two-Layer Architecture**: Back layer for contextual actions, front layer for primary content with spatial hierarchy |
| 24 | - **Multiple Reveal Methods**: Programmatic API, toolbar icon tap, and swipe/fling gestures |
| 25 | - **Adaptive Reveal Height**: Auto mode (fits content) or Fill mode (full screen expansion) |
| 26 | - **Customizable Front Layer**: Curved or flat edge shapes with independent corner radius control |
| 27 | - **Header Integration**: Seamless NavigationPage and FlyoutPage support with customizable icons and text |
| 28 | - **Smooth Animations**: Built-in Material Design motion for reveal/conceal transitions |
| 29 | - **State Tracking**: BackLayerStateChanged event with percentage-based reveal tracking |
| 30 | - **Modern Effects**: Liquid Glass Effect support for translucent designs (iOS/macOS 26+, .NET 10) |
| 31 | |
| 32 | ## Documentation and Navigation Guide |
| 33 | |
| 34 | ### Getting Started |
| 35 | 📄 **Read:** [references/getting-started.md](references/getting-started.md) |
| 36 | - NuGet package installation (`Syncfusion.Maui.Backdrop`) |
| 37 | - Handler registration in `MauiProgram.cs` |
| 38 | - `SfBackdropPage` initialization (XAML & C#) |
| 39 | - Adding `BackdropBackLayer` and `BackdropFrontLayer` content |
| 40 | - Programmatic, touch, and swipe reveal/conceal |
| 41 | |
| 42 | ### Header Configuration |
| 43 | 📄 **Read:** [references/header-configuration.md](references/header-configuration.md) |
| 44 | - Wrapping in `NavigationPage` (required for header) |
| 45 | - Default icons in NavigationPage vs FlyoutPage |
| 46 | - Custom icon images (`OpenIconImageSource`, `CloseIconImageSource`) |
| 47 | - Custom icon text (`OpenText`, `CloseText`) |
| 48 | |
| 49 | ### Reveal Height & Corner Shape Customization |
| 50 | 📄 **Read:** [references/reveal-and-corner-customization.md](references/reveal-and-corner-customization.md) |
| 51 | - `BackLayerRevealOption`: `Fill` vs `Auto` |
| 52 | - `RevealedHeight` on the front layer |
| 53 | - `EdgeShape`: `Curved` vs `Flat` |
| 54 | - `LeftCornerRadius` / `RightCornerRadius` |
| 55 | |
| 56 | ### Events |
| 57 | 📄 **Read:** [references/events.md](references/events.md) |
| 58 | - `BackLayerStateChanged` event |
| 59 | - `BackLayerStateChangedEventArgs.Percentage` |
| 60 | - XAML and C# wiring patterns |
| 61 | |
| 62 | ### Liquid Glass Effect |
| 63 | 📄 **Read:** [references/liquid-glass-effect.md](references/liquid-glass-effect.md) |
| 64 | - Enabling `EnableLiquidGlassEffect` on Front or Back Layer |
| 65 | - Transparent background setup for glass effect |
| 66 | - Platform requirements (iOS 26+, macOS 26+, .NET 10) |