mcpField
S
syncfusion-maui-toolkit-popup

syncfusion-maui-toolkit-popup

github.com/syncfusionDesign & UI3948 installsUpdated 7w ago
Repository

About syncfusion-maui-toolkit-popup

A guidance skill for using Syncfusion’s SfPopup control in .NET MAUI applications. It helps developers build dialogs and overlays, with guidance on positioning, layout, animations, modal behavior, and event handling.

Key features

  1. 01Center, absolute, relative, and full-screen positioning
  2. 02Custom header, content, and footer layouts
  3. 03One- or two-button footer modes
  4. 04Modal behavior and overlay controls
  5. 05Built-in and configurable animations
  6. 06Lifecycle and button events

Use cases

  1. 01Displaying alerts and confirmations
  2. 02Showing forms or custom views in dialogs
  3. 03Creating contextual menus or tooltips
  4. 04Presenting loading or progress dialogs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/syncfusion/maui-toolkit-ui-components-skills --skill syncfusion-maui-toolkit-popup

After installing, type/syncfusion-maui-toolkit-popupin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
advanced-integration.md
events-and-modal.md
getting-started.md
layout-customization.md
positioning.md
sizing-and-animations.md
styling-and-appearance.md

Details

From the project README

Implementing .NET MAUI Popups

A comprehensive skill for implementing the Syncfusion .NET MAUI Popup (SfPopup) control to display alert messages, custom views, and modal dialogs with extensive positioning and customization options.

When to Use This Skill

Use this skill when you need to:

  • Display alert messages, confirmations, or notifications in .NET MAUI apps
  • Show modal dialogs that require user interaction
  • Create popups with custom headers, footers, and content
  • Position popups at specific locations (center, absolute, relative to views)
  • Display information overlays without navigating to new pages
  • Implement tooltips, contextual menus, or flyout content
  • Show loading indicators or progress dialogs
  • Create full-screen modal experiences
  • Display custom views (ListView, DataGrid, forms) in popups
  • Handle accept/decline user actions with button callbacks

Component Overview

Syncfusion .NET MAUI Popup (SfPopup) is a versatile layout control that displays customizable popups with:

  • Flexible Positioning: Center, absolute coordinates, relative to any view, or full-screen
  • Customizable Layout: Header, body, and footer with template support and custom styling.
  • Appearance Modes: One-button or two-button footer layouts
  • Modal Support: Prevent background interaction until popup is dismissed
  • Animations: Built-in zoom, fade, and slide animations
  • Auto-sizing: Automatically adjust to content dimensions
  • MVVM Support: Full data binding and command support

Documentation and Navigation Guide

Getting Started and Installation

📄 Read: references/getting-started.md

  • NuGet package installation (Syncfusion.Maui.Toolkit)
  • Handler registration in MauiProgram.cs
  • Basic popup initialization (XAML and C#)
  • Displaying and dismissing popups
  • First popup implementation
  • Native embedding (Android/iOS)
Positioning Options

📄 Read: references/positioning.md

  • Center positioning with IsOpen or Show()
  • Absolute positioning at x, y coordinates
  • Relative positioning to any view
  • Absolute relative positioning with offsets
  • Full-screen mode
  • MVVM positioning patterns
  • Auto-close with duration
  • Position over action bar
  • Returning results with ShowAsync()
Layout Customizations

📄 Read: references/layout-customization.md

  • Appearance modes (OneButton, TwoButton)
  • Show/hide header, footer, close button
  • Custom header templates
  • Custom footer templates
  • Custom content templates
  • Header and footer height
  • Button text customization
  • Message property
  • Disable overlay background
Sizing and Animations

📄 Read: references/sizing-and-animations.md

  • Width and height configuration
  • Auto-sizing modes (Height, Width, Both, None)
  • Full-screen popup mode
  • Animation types (Zoom, Fade, SlideOnLeft, SlideOnRight, SlideOnTop, SlideOnBottom)
  • Animation duration and easing
  • Custom animation effects
Events and Modal Behavior

📄 Read: references/events-and-modal.md

  • Popup lifecycle events (Opening, Opened, Closing, Closed)
  • Event arguments and cancellation
  • Modal mode configuration
  • Overlay interaction settings
  • Close on overlay tap behavior
  • Accept and decline button events
Styling and Appearance

📄 Read: references/styling-and-appearance.md

When to read: Customizing visual appearance of popup with styling header, footer, messages. Overlay and stroke customizations.

Covers:

  • Header styling
  • Footer styling
  • Message/content styling
  • Border customization
  • Overlay background styling
  • Blur effects
  • Background styling
  • Shadow effects
  • Styling examples

Advanced Integration and Examples

📄 Read: references/advanced-integration.md

  • Displaying ListView in popup
  • DataGrid cell tap integration
  • Switch control binding examples
  • MVVM patterns with commands
  • Localization support
  • Migration from older versions
  • Best practices and patterns

Comments

Markdown supported