Badge

Badge — a pill-shaped label for tags, status indicators, and counts.

Badge renders a short piece of text inside a rounded-pill container. Common uses include tag chips on list items, unread-count bubbles in navigation rails, and severity labels in alert rows. The pill chrome (corner radius, padding, surface tint) is driven by the active BadgeStyle; callers may swap it per-instance (.style(...)) or theme-wide via theme.style_slots.badge.

When to use

Inline chip that annotates another widget (version tag, "NEW" label).
Standalone count indicator; pair with SeverityBadge for icon-backed status glyphs.

Accessibility

Announces as Role::Label with its resolved text as the AT name. The inner TextWidget is hidden from AT to avoid double-announcement.

#![allow(unused)]
fn main() {
use teksilo_widgets::Badge;
use teksilo_i18n::lit;
use teksilo_tokens::Color;
let _badge = Badge::new(lit!("NEW"))
    .background(Color::new(0.2, 0.6, 1.0, 1.0));
}

Builder methods at a glance

style, background, text_role, text_style, tooltip, rich_tooltip, rich_tooltip_content, composite_tooltip

API reference

📖 Full rustdoc API for this module

`pub struct Badge`

A pill-shaped label for displaying tags, counts, or status.

#![allow(unused)]
fn main() {
pub struct Badge { /* fields */ }
}

Methods

`pub fn new(label: impl Into<LocalizedString>) -> Self`

Construct a badge with the given label text.

`pub fn style(mut self, style: impl teksilo_core::styles::BadgeStyle) -> Self`

Per-call style override for the badge pill chrome. Replaces the theme-wide default BadgeStyle for just this instance.

`pub fn background(mut self, color: impl Into<ColorProp>) -> Self`

Override the badge background. Accepts Color, a SurfaceRole / TextRole, or a Signal<Color>. Default (unset) is SurfaceRole::AccentSubtle.

`pub fn text_role(mut self, color: impl Into<ColorProp>) -> Self`

Override the badge text color. Accepts Color, a role, or a signal. Default (unset) is the theme's status_info_fg.

`pub fn text_style(mut self, style: impl Into<teksilo_core::color_prop::TextStyleProp>) -> Self`

Override the label's text style (font, size, weight). Accepts a TextStyleRole, a TextStyle, or a Signal of either. Default (unset) is TextStyleRole::Tiny.

`pub fn tooltip(mut self, text: impl Into<LocalizedString>) -> Self`

Attach a plain single-line tooltip shown after a hover delay.

Mutually exclusive with rich_tooltip, rich_tooltip_content, and composite_tooltip — the last setter called wins.

`pub fn rich_tooltip(mut self, key: impl Into<String>) -> Self`

Attach a rich tooltip identified by a registry key.

Mutually exclusive with tooltip, rich_tooltip_content, and composite_tooltip — the last setter called wins.

Attach a rich tooltip from inline TooltipContent.

Mutually exclusive with tooltip, rich_tooltip, and composite_tooltip — the last setter called wins.

Attach a composite tooltip with an arbitrary widget tree body.

Mutually exclusive with tooltip, rich_tooltip, and rich_tooltip_content — the last setter called wins.

Teksilo Documentation