syncfusion-maui-badge-view

$npx mdskill add syncfusion/maui-ui-components-skills/syncfusion-maui-badge-view

Add notification badges and status overlays to MAUI apps.

  • Displays unread counts, alerts, or status indicators on content.
  • Depends on Syncfusion .NET MAUI Badge View (SfBadgeView) control.
  • Customizes badge text, position, animations, symbols, and accessibility.
  • Outputs XAML or C# code for badge view integration.

SKILL.md

.github/skills/syncfusion-maui-badge-viewView on GitHub ↗
---
name: syncfusion-maui-badge-view
description: Implements 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.
metadata:
  author: "Syncfusion Inc"
  version: "34.1.29"
---

# Implementing Badge Views in .NET MAUI

A comprehensive guide for implementing and customizing Syncfusion's .NET MAUI Badge View (SfBadgeView) control. Badge views display notification counts, status indicators, or alerts overlaid on content like buttons, images, or avatars.

## When to Use This Skill

Use this skill when you need to:
- Add notification badges to buttons, icons, or profile images
- Display unread message counts or notification numbers
- Show status indicators (available, busy, away)
- Implement notification overlays with custom positioning
- Add animated badge notifications
- Create badges with predefined symbols or icons
- Customize badge appearance (colors, fonts, shapes)
- Position badges around content elements
- Implement accessible badge notifications with screen reader support

## Component Overview

The Badge View (SfBadgeView) is a notification control that overlays badges on content elements. It supports:
- **Text badges:** Display notification counts or short text
- **Icon badges:** Show predefined status symbols (available, away, busy, etc.)
- **Positioning:** Place badges at 8 positions around content (TopRight, TopLeft, BottomRight, etc.)
- **Customization:** Fonts, colors, strokes, backgrounds, corner radius
- **Animation:** Scale animations when badge text changes
- **Predefined styles:** 8 color types (Primary, Error, Success, Warning, etc.)
- **Accessibility:** Screen reader support for badge content

## Documentation and Navigation Guide

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

Read this reference when you need to:
- Install Syncfusion.Maui.Core NuGet package
- Register the Syncfusion handler in MauiProgram.cs
- Create your first badge view
- Add badge text or content
- Implement basic badge notifications
- Add accessibility with ScreenReaderText

### Badge Customization
📄 **Read:** [references/customization.md](references/customization.md)

Read this reference when you need to:
- Customize font properties (size, family, attributes)
- Add stroke borders and adjust thickness
- Change text color and padding
- Apply predefined badge types (Primary, Error, Success, Warning, Info, Dark, Light, Secondary)
- Set custom background colors
- Configure corner radius for rounded badges
- Align badges (Center, Start, End)
- Handle badge alignment with different sizing scenarios
- Keep multiple badges aligned uniformly with AutoHide
- Enable font auto-scaling for accessibility
- Control badge visibility

### Position Customization
📄 **Read:** [references/positioning.md](references/positioning.md)

Read this reference when you need to:
- Position badges around content (TopRight, TopLeft, BottomRight, BottomLeft, Left, Top, Right, Bottom)
- Fine-tune badge placement with Offset property
- Adjust X,Y coordinates for precise positioning
- Position badges on images, buttons, or custom controls

### Animation
📄 **Read:** [references/animation.md](references/animation.md)

Read this reference when you need to:
- Enable or disable badge animations
- Configure scale animation when badge text changes
- Adjust animation duration for faster or slower effects
- Create dynamic badge notifications

### Predefined Symbols
📄 **Read:** [references/predefined-symbols.md](references/predefined-symbols.md)

Read this reference when you need to:
- Use badge icons instead of text (Add, Available, Away, Busy, Delete, Dot, Prohibit)
- Display status indicators with predefined symbols
- Understand icon vs text priority
- Implement icon-based badges on avatars or images

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-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.
syncfusion-maui-cardsImplements Syncfusion .NET MAUI Cards (SfCards) - dismissible card views and swipeable card stacks. Use when working with cards, card views, card layouts, swipeable cards, dismissible cards, or card stacks in .NET MAUI. Covers card customization, card events, card data binding, and interactive card components with swipe functionality.