Badge

A small status/tag indicator combining an optional icon and short text.

BadgeComponent · type key standard.badge · Contents · property blocks: ITooltipComponent

new BadgeComponent("badge")

Properties

Property	Type	Default	Binding	Description
`Style` SetStyle · BindStyle	`UIBadgeType?`	`UIBadgeType.Primary`	one-way	The badge's visual style — Primary, Accent, Info, Warning, Success, Danger, or Surface; default Primary.
`Color` SetColor · BindColor	`UIThemeColor?`	`null`	one-way	Overrides `BadgeComponent.Style` with an explicit color when set, e.g. a tag/category swatch.
`Icon` SetIcon · BindIcon	`string`	`null`	one-way	The icon shown beside the badge text, by name from the registered icon font/set. translatable
`IconColor` SetIconColor · BindIconColor	`UIThemeColor?`	`Default`	one-way	The icon's colour; unset resolves to `color: inherit`, so it follows whatever it's drawn in.
`IconSize` SetIconSize · BindIconSize	`UIIconSize?`	`null`	one-way	The icon's size; unset the glyph is as tall as the badge's own text.
`Text` SetText · BindText	`string`	`null`	one-way	The short text drawn inside the badge, beside its icon. translatable
`TextType` SetTextType · BindTextType	`UITextAppearance?`	`Overline`	one-way	The text style used to render `BadgeComponent.Text`.
`Tooltip` SetTooltip · BindTooltip	`string`	`null`	one-way	The tooltip shown on hover and on focus. On a button-shaped control with no title of its own — an icon button — it is also the name a screen reader gets. translatable
`TooltipPlacement` SetTooltipPlacement · BindTooltipPlacement	`UIPopupPlacement?`	`UIPopupPlacement.Top`	one-way	The side the tooltip prefers; flips to the opposite side when there is no room for it there.

Common properties (16) — layout, visibility, theme, and the rest every component shares

Property	Type	Default	Binding	Description
`Visibility` SetVisibility · BindVisibility	`UIResponsive<UIVisibility>?`	`Visible`	one-way	What the component does with the room it was given, optionally overridden per breakpoint (e.g. collapsed from a given width up).
`Enabled` SetEnabled · BindEnabled	`bool?`	`true`	one-way	Whether the component responds to input; false dims it and marks it, and its subtree, inert.
`Theme` SetTheme · BindTheme	`UIThemeMode?`	`null`	one-way	The theme mode forced on this component's subtree, or `null` to inherit the ambient theme.
`HorizontalAlignment` SetHorizontalAlignment · BindHorizontalAlignment	`UIAlignment?`	`UIAlignment.Stretch`	one-way	Where the component sits within its grid cell along the horizontal axis.
`VerticalAlignment` SetVerticalAlignment · BindVerticalAlignment	`UIAlignment?`	`UIAlignment.Stretch`	one-way	Where the component sits within its grid cell along the vertical axis.
`Width` SetWidth · BindWidth	`UIResponsive<UILayoutLength>?`	`null`	one-way	The component width, optionally overridden per breakpoint.
`MinWidth` SetMinWidth · BindMinWidth	`UIResponsive<UILayoutLength>?`	`null`	one-way	The component minimum width, optionally overridden per breakpoint.
`MaxWidth` SetMaxWidth · BindMaxWidth	`UIResponsive<UILayoutLength>?`	`null`	one-way	The component maximum width, optionally overridden per breakpoint.
`Height` SetHeight · BindHeight	`UIResponsive<UILayoutLength>?`	`null`	one-way	The component height, optionally overridden per breakpoint.
`MinHeight` SetMinHeight · BindMinHeight	`UIResponsive<UILayoutLength>?`	`null`	one-way	The component minimum height, optionally overridden per breakpoint.
`MaxHeight` SetMaxHeight · BindMaxHeight	`UIResponsive<UILayoutLength>?`	`null`	one-way	The component maximum height, optionally overridden per breakpoint.
`ZIndex` SetZIndex · BindZIndex	`int?`	`0`	one-way	The stacking order within the visual tree.
`Margin` SetMargin · BindMargin	`UIResponsive<UIThickness>?`	`null`	one-way	The outer spacing around the component, optionally overridden per breakpoint.
`Placement` SetPlacement · BindPlacement	`UIResponsive<UIGridPlacement>?`	`null`	one-way	The grid placement, optionally overridden per breakpoint.
`Loading` SetLoading · BindLoading	`bool?`	`false`	one-way	Whether the component is in loading state — a live state a controller turns on and off.
`ShowContextMenu` SetShowContextMenu · BindShowContextMenu	`bool?`	`true`	one-way	Whether a right-click opens the `IVisualComponent.ContextMenu`; on a host with rows, whether it opens any row's. Off, the menu stays in the tree and nothing opens it.