Struct Button 

pub struct Button {
    pub id: Option<NodeId>,
    pub child: Option<Box<Node>>,
    pub on_press: Option<ActionEnvelope>,
    pub semantics: Option<Semantics>,
    pub width: Option<f32>,
    pub height: Option<f32>,
    pub padding: Option<[f32; 4]>,
    pub style: Option<ButtonStyleOverride>,
    pub variant: ButtonVariant,
    pub content_align: ButtonContentAlign,
    pub disabled: bool,
}

A pressable button widget with built-in theming, hover/press states, and focus ring.

Buttons come in three visual ButtonVariants (Filled, Outline, Ghost) and support flexible content alignment via ButtonContentAlign.

Example

let on_press = ctx.bind(Submit, handle_submit as fn(&mut S, Submit));

Button {
    child: Some(Box::new(Text::new("Submit").into_node())),
    on_press: Some(on_press),
    variant: ButtonVariant::Filled,
    content_align: ButtonContentAlign::Center,
    ..Default::default()
}

Fields

id: Option<NodeId>

Explicit node identity (auto-generated if None).

child: Option<Box<Node>>

The button’s content widget (typically [Text] or [Icon]).

on_press: Option<ActionEnvelope>

Action dispatched when the button is pressed.

semantics: Option<Semantics>

Custom semantics (overrides the default button semantics).

width: Option<f32>

Fixed width in layout points.

height: Option<f32>

Fixed height in layout points.

padding: Option<[f32; 4]>

Custom padding [left, right, top, bottom] (overrides theme defaults).

style: Option<ButtonStyleOverride>

Style overrides (reserved for future use).

variant: ButtonVariant

Visual variant (Filled, Outline, or Ghost).

content_align: ButtonContentAlign

Horizontal alignment of the child content.

disabled: bool

When true, the button is greyed out and its on_press action is not attached.

Implementations

impl Button

pub fn into_node(self) -> Node

Trait Implementations

impl Clone for Button

fn clone(&self) -> Button

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Button

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

Formats the value using the given formatter.

impl Default for Button

fn default() -> Button

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Button

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Button> for Node

fn from(w: Button) -> Self

Converts to this type from the input type.

impl Lower for Button

fn lower(&self, cx: &mut LoweringContext<'_>) -> NodeId

Lower this widget into the IR, returning the root node id.

impl Serialize for Button

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<S: AppState> Widget<S> for Button

fn build(&self, _ctx: &mut BuildCtx<S>, _view: &View<'_, S>) -> Node

Build the widget’s node tree.