Struct Button 

pub struct Button<'a> { /* private fields */ }

Button Widget

A clickable button widget that displays text and responds to user interaction.

Buttons are one of the most fundamental widgets in Kolibri. They provide a simple way to trigger actions in response to user input. Buttons can be created with just a text label and optionally support smartstate-based incremental redrawing for better performance.

Features

• Text label with customizable font and colors
• Visual feedback for different interaction states (normal, hover, pressed)
• Optional smartstate support for incremental redrawing
• Automatic sizing based on text content and style settings

Example

// Create a basic button
if ui.add(Button::new("Click me!")).clicked() {
    // Handle click
}

// Create a button with smartstate for incremental redrawing
let mut smartstateProvider = SmartstateProvider::<20>::new();
if ui.add(Button::new("Efficient!").smartstate(smartstateProvider.nxt())).clicked() {
    // Handle click with improved performance
}

// Create a button in a horizontal layout
if ui.add_horizontal(Button::new("-")).clicked() {
    // Handle click in horizontal layout
}

Visual States

Buttons have three visual states that provide user feedback:

1. Normal - Default appearance with standard border and background
2. Hover - Enhanced appearance when mouse/pointer is over the button
3. Pressed - Highlighted appearance when clicked/pressed

Styling

Buttons follow the [UI]’s current style settings including:

• Border colors and widths (normal and highlighted)
• Background colors (normal, highlighted, and pressed)
• Text color and font
• Padding and spacing

Implementations

impl<'a> Button<'a>

pub fn new(label: &'a str) -> Button<'a>

Creates a new button with the given text label.

Arguments

• label - The text to display on the button

Returns

A new Button instance with the specified label and no smartstate

pub fn smartstate(self, smartstate: &'a mut Smartstate) -> Self

Adds smartstate support to the button for incremental redrawing.

When a smartstate is provided, the button will only redraw when its visual state changes, significantly improving performance especially on slower displays.

Arguments

• smartstate - The smartstate to use for tracking the button’s state

Returns

Self with smartstate configured

Trait Implementations

impl Widget for Button<'_>

fn draw<DRAW: DrawTarget<Color = COL>, COL: PixelColor>( &mut self, ui: &mut Ui<'_, DRAW, COL>, ) -> GuiResult<Response>