Struct Badge 

pub struct Badge { /* private fields */ }

A notification circle painted in a corner of a widget.

Build one with Badge::new and attach it with Button::badge. The colour and corner are the two knobs you will reach for; everything else has a sane default.

Empty text (Badge::dot) renders a plain coloured dot.

Implementations

impl Badge

pub fn new(text: impl Into<WidgetText>) -> Self

Create a badge showing text (e.g. a change count) in the top-right corner, filled with ThemeColors::error.

pub fn dot() -> Self

Create a textless badge: a plain coloured dot.

pub fn color(self, color: Color32) -> Self

Circle fill. Defaults to the theme error colour.

pub fn corner(self, corner: BadgeCorner) -> Self

Which corner of the widget the badge sits in. Default: top-right.

pub fn text_color(self, text_color: Color32) -> Self

Colour of the badge text. Defaults to ThemeColors::bg so glyphs stay readable on chromatic fills.

pub fn min_diameter(self, min_diameter: f32) -> Self

Smallest diameter the circle will take, in points.

The circle grows beyond this when the text needs the room. Default: 16.0. Lower it for Button::small.

pub fn inset(self, inset: f32) -> Self

Distance between the circle and the widget corner, in points.

Negative values let the badge straddle the edge. Default: 2.0.

pub fn padding(self, padding: f32) -> Self

Gap between the text and the circle edge, in points. Default: 3.0.

pub fn outline(self, outline: impl Into<Stroke>) -> Self

Ring drawn around the circle, e.g. Stroke::new(1.5, theme.colors.bg) to lift the badge off a busy button fill.

pub fn paint_at(&self, ui: &Ui, widget_rect: Rect)

Paint the badge on top of widget_rect (usually a widget’s response rect).

Public so any widget can host a badge without re-implementing the placement and text metrics.

Trait Implementations

impl Clone for Badge

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Badge

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.