RadzenBadge Class

A small label component used to display counts, statuses, or short text labels with semantic color coding. RadzenBadge is a compact visual indicator commonly used for notification counts, status indicators, tags, or highlighting important information. Supports multiple styles (Primary, Secondary, Success, Info, Warning, Danger, Light, Dark) for semantic coloring, variants (Filled, Flat, Outlined, Text) for different appearances, and shapes (standard rectangular or pill-shaped via IsPill). Content can be simple text via Text property or custom content via ChildContent. Can be absolutely positioned to overlay other elements (e.g., notification icon with count). Often used inline with text, on buttons (to show counts), or overlaid on icons (notification badges).

Inheritance

Object

ComponentBase

RadzenComponent

RadzenBadge

Implements

IComponent

IHandleEvent

IHandleAfterRender

Namespace: Radzen.Blazor

Assembly: Radzen.Blazor.dll

Syntax

public class RadzenBadge : RadzenComponent, IComponent, IHandleEvent, IHandleAfterRender

Examples

Basic badge with text:

<RadzenBadge BadgeStyle="BadgeStyle.Primary" Text="New" />

Notification count badge:

<div style="position: relative; display: inline-block;">
    <RadzenIcon Icon="notifications" />
    <RadzenBadge BadgeStyle="BadgeStyle.Danger" Text="3" IsPill="true" 
                 Style="position: absolute; top: -8px; right: -8px;" />
</div>

Status badge with custom variant:

<RadzenBadge BadgeStyle="BadgeStyle.Success" Variant="Variant.Flat" Text="Active" IsPill="true" />

Constructors

RadzenBadgelink

A small label component used to display counts, statuses, or short text labels with semantic color coding. RadzenBadge is a compact visual indicator commonly used for notification counts, status indicators, tags, or highlighting important information. Supports multiple styles (Primary, Secondary, Success, Info, Warning, Danger, Light, Dark) for semantic coloring, variants (Filled, Flat, Outlined, Text) for different appearances, and shapes (standard rectangular or pill-shaped via IsPill). Content can be simple text via Text property or custom content via ChildContent. Can be absolutely positioned to overlay other elements (e.g., notification icon with count). Often used inline with text, on buttons (to show counts), or overlaid on icons (notification badges).

Declaration
public RadzenBadge()

Properties

BadgeStylelink

Gets or sets the semantic color style of the badge. Determines the badge's color based on its purpose (Primary, Success, Danger, Warning, etc.).

Declaration
public BadgeStyle BadgeStyle { get; set; }
Property Value
Type Description
BadgeStyleGets or sets the semantic color style of the badge. Determines the badge's color based on its purpose (Primary, Success, Danger, Warning, etc.).

ChildContentlink

Gets or sets the custom child content to render inside the badge. When set, overrides the Text property for displaying custom markup.

Declaration
public RenderFragment ChildContent { get; set; }
Property Value
Type Description
RenderFragmentGets or sets the custom child content to render inside the badge. When set, overrides the Text property for displaying custom markup.

IsPilllink

Gets or sets whether the badge should have rounded pill-shaped ends instead of rectangular corners. Pill badges have a more modern, capsule-like appearance and are often used for tags or status indicators.

Declaration
public bool IsPill { get; set; }
Property Value
Type Description
boolGets or sets whether the badge should have rounded pill-shaped ends instead of rectangular corners. Pill badges have a more modern, capsule-like appearance and are often used for tags or status indicators.

Shadelink

Gets or sets the color intensity shade for the badge. Works in combination with BadgeStyle to adjust the color darkness/lightness.

Declaration
public Shade Shade { get; set; }
Property Value
Type Description
ShadeGets or sets the color intensity shade for the badge. Works in combination with BadgeStyle to adjust the color darkness/lightness.

Textlink

Gets or sets the text content displayed in the badge. Typically used for short text like numbers, single words, or abbreviations.

Declaration
public string Text { get; set; }
Property Value
Type Description
stringGets or sets the text content displayed in the badge. Typically used for short text like numbers, single words, or abbreviations.

Variantlink

Gets or sets the design variant that controls the badge's visual appearance. Options include Filled (solid background), Flat (subtle background), Outlined (border only), and Text (minimal styling).

Declaration
public Variant Variant { get; set; }
Property Value
Type Description
VariantGets or sets the design variant that controls the badge's visual appearance. Options include Filled (solid background), Flat (subtle background), Outlined (border only), and Text (minimal styling).

Methods

BuildRenderTreelink

Declaration
protected override void BuildRenderTree(Rendering.RenderTreeBuilder __builder)
Parameters
Type Name Description
Rendering.RenderTreeBuilder __builder

GetComponentCssClasslink

Declaration
protected override string GetComponentCssClass()
Returns
Type Description
string
An error has occurred. This app may no longer respond until reloaded. Reload 🗙