Struct ButtonBuilder 

pub struct ButtonBuilder { /* private fields */ }

Builder for creating buttons with consistent styling

Implementations

impl ButtonBuilder

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

Create a new button builder with text

pub fn style(self, style: ButtonStyle) -> Self

Set the button style

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

Set the button size

pub fn width(self, width: Val) -> Self

Set a custom width

pub fn height(self, height: Val) -> Self

Set a custom height

pub fn margin(self, margin: UiRect) -> Self

Set the margin

pub fn hover_scale(self, scale: f32) -> Self

Enable hover scale effect

pub fn hover_brightness(self, brightness: f32) -> Self

Enable hover brightness effect

pub fn disabled(self) -> Self

Set the button as disabled

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

Set whether the button is enabled

pub fn icon(self, icon: impl Into<String>) -> Self

Add an icon (emoji or symbol)

pub fn selectable(self) -> Self

Make the button selectable (supports toggle/selection behavior)

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

Set the initial selected state (implies selectable)

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

Set the button as active (implies selectable) Active state is used for current tab/page indicators

pub fn manual_toggle(self) -> Self

Disable auto-toggle behavior (selection must be managed manually)

pub fn in_group(self, group_entity: Entity) -> Self

Add this button to a button group for exclusive selection (radio button behavior) Automatically makes the button selectable

pub fn selection_colors( self, selected: StateColorSet, active: StateColorSet, ) -> Self

Set custom colors for selected and active states If not set, colors are auto-generated from the button style

pub fn with_marker<M: Component>(self, marker: M) -> ButtonBuilderWithMarker<M>

Attach a marker component to the button

pub fn build_in(self, parent: &mut ChildSpawnerCommands<'_>) -> Entity

Build the button entity (alias for build)

pub fn build(self, parent: &mut ChildSpawnerCommands<'_>) -> Entity

Build the button entity