Struct Button 

pub struct Button {
    pub label: String,
    pub variant: ButtonVariant,
    pub disabled: bool,
    pub icon: Option<Box<dyn Widget>>,
    pub width: Option<f32>,
    pub height: f32,
    pub font_size: Option<f32>,
    pub radius: f32,
    /* private fields */
}

A clickable labeled button.

Attach a callback with .on_press(|| ...). The callback fires when the button is clicked — no boilerplate needed.

Fields

label: String

variant: ButtonVariant

disabled: bool

icon: Option<Box<dyn Widget>>

width: Option<f32>

height: f32

font_size: Option<f32>

None = read from the active theme’s typography.label_large (D127 “environment” track — see Checkbox::resolved_font_size’s doc for the reasoning).

radius: f32

Implementations

impl Button

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

pub fn variant(self, v: ButtonVariant) -> Self

pub fn disabled(self) -> Self

pub fn disabled_if(self, condition: bool) -> Self

Conditional form of Self::disabled (D116 Phase 28 Step 8) — the natural way to gate a submit button on form.is_valid() without an if/else at every call site: Button::new("Submit").disabled_if(!form.is_valid()).

pub fn width(self, w: f32) -> Self

pub fn height(self, h: f32) -> Self

pub fn font_size(self, s: f32) -> Self

pub fn background(self, c: Color) -> Self

Overrides the variant’s own fill color — for a one-off custom color outside the Primary/Secondary/Ghost/Danger/Success/Link palette.

pub fn color(self, c: Color) -> Self

Overrides the variant’s own label/icon color.

pub fn radius(self, r: f32) -> Self

pub fn icon(self, w: impl Widget + 'static) -> Self

pub fn on_press(self, f: impl Fn() + Send + Sync + 'static) -> Self

Set the click handler. The closure is called on every left-click inside the button’s bounds.

Trait Implementations

impl Widget for Button

fn layout(&self, ctx: &LayoutCtx<'_>) -> Size

Measure under ctx.constraints and return a size within them.

fn paint(&self, ctx: &mut PaintCtx<'_>)

Record draw commands for ctx.rect.

fn children(&self) -> Children<'_>

Declare this widget’s children. Drives every default below.

fn flex_factor(&self) -> f32

Flex weight inside Row/Column. Wrappers are transparent by default.

fn into_element(self) -> Element

where Self: Sized + 'static,

Wrap this widget in an Element so it can be returned from Component::build().