Struct IconButton 

pub struct IconButton { /* private fields */ }

An icon-only button component

Examples

// With text/emoji icon
IconButton::new("btn", "🔊")
    .variant(IconButtonVariant::Ghost)
    .on_click(|window, cx| { /* handle click */ })

// With custom element (e.g., SVG icon)
IconButton::with_child("btn", my_svg_icon)
    .size(IconButtonSize::Lg)
    .rounded_full()
    .theme(my_theme)

Implementations

impl IconButton

pub fn new(id: impl Into<ElementId>, icon: impl Into<SharedString>) -> Self

Create a new icon button with a text/emoji icon

pub fn with_child(id: impl Into<ElementId>, child: impl IntoElement) -> Self

Create a new icon button with a custom child element (e.g., SVG icon)

pub fn size(self, size: IconButtonSize) -> Self

Set the button size

pub fn variant(self, variant: IconButtonVariant) -> Self

Set the button variant

pub fn disabled(self, disabled: bool) -> Self

Set disabled state

pub fn selected(self, selected: bool) -> Self

Set selected state

pub fn on_click(self, handler: impl Fn(&mut Window, &mut App) + 'static) -> Self

Set click handler

pub fn rounded_full(self) -> Self

Use fully rounded corners (circular button)

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

Set custom padding (overrides default size-based padding)

pub fn theme(self, theme: IconButtonTheme) -> Self

Set the button theme

pub fn compute_colors(&self) -> (Rgba, Rgba, Rgba, Option<Rgba>)

Get the computed colors based on variant and state

pub fn build(self) -> Stateful<Div>

Build into element

Trait Implementations

impl IntoElement for IconButton

type Element = Stateful<Div>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements Element.

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed AnyElement.