Struct Button 

pub struct Button { /* private fields */ }

Clickable button widget.

Implementations

impl Button

pub fn new(text: impl Into<String>, bounds: Rect) -> Button

Create a new button with the provided label text.

Examples found in repository

examples/demo.rs (line 178)

fn main() {
    let theme = Theme::material_light();
    let style = StyleBuilder::new()
        .bg(theme.tokens.colors.primary)
        .radius(theme.tokens.radii.md)
        .build();

    let new_components = (
        Progress::new(theme.control_rect(0, 0, 90, ComponentSize::Sm), 0, 100)
            .with_value(64)
            .themed(
                &theme,
                ColorScheme::Primary,
                Variant::Subtle,
                ComponentSize::Md,
            )
            .opacity(220),
        Select::new(theme.control_rect(0, 10, 90, ComponentSize::Sm).height(64))
            .with_options(&["One", "Two", "Three"])
            .with_selected_index(1)
            .themed(
                &theme,
                ColorScheme::Info,
                Variant::Outline,
                ComponentSize::Sm,
            )
            .on_change(|idx, text| println!("select: {idx} {text}")),
        Tabs::new(rect(0, 80, 120, 80), TabBarPos::Top)
            .tab("Main")
            .tab("Settings")
            .themed(
                &theme,
                ColorScheme::Primary,
                Variant::Solid,
                ComponentSize::Md,
            ),
        ButtonMatrix::new(
            theme
                .control_rect(0, 170, 120, ComponentSize::Md)
                .height(48),
        )
        .with_map(&["A", "B", "\n", "C", "D"])
        .themed(
            &theme,
            ColorScheme::Neutral,
            Variant::Outline,
            ComponentSize::Md,
        )
        .on_activate(|id, text| println!("button matrix: {:?} {text}", id)),
        Bar::new(theme.control_rect(0, 224, 90, ComponentSize::Xs), 0, 100)
            .with_value(32)
            .with_mode(BarMode::Normal)
            .themed(
                &theme,
                ColorScheme::Success,
                Variant::Subtle,
                ComponentSize::Sm,
            ),
        Led::new(
            theme
                .origin_control_rect(12, ComponentSize::Xs)
                .at(0, 240)
                .size(12, 12),
        )
        .themed(
            &theme,
            ColorScheme::Success,
            Variant::Solid,
            ComponentSize::Xs,
        )
        .brightness(180),
        Spinner::new(theme.origin_control_rect(24, ComponentSize::Md).at(20, 236))
            .animation(30, 100)
            .themed(
                &theme,
                ColorScheme::Primary,
                Variant::Ghost,
                ComponentSize::Md,
            ),
        List::new(
            theme
                .control_rect(0, 270, 100, ComponentSize::Sm)
                .height(48),
        )
        .with_items(&["Alpha", "Beta", "Gamma"])
        .themed(
            &theme,
            ColorScheme::Neutral,
            Variant::Subtle,
            ComponentSize::Sm,
        ),
        Divider::new(rect(0, 328, 100, 8), DividerOrientation::Horizontal).themed(
            &theme,
            ColorScheme::Neutral,
            Variant::Outline,
            ComponentSize::Sm,
        ),
        Spacer::height(theme.component_size(ComponentSize::Md).gap),
        Table::new(rect(0, 342, 120, 48)).themed_parts(
            &theme,
            ColorScheme::Info,
            Variant::Subtle,
            ComponentSize::Sm,
        ),
        Calendar::new(rect(0, 396, 140, 96)).themed_parts(
            &theme,
            ColorScheme::Primary,
            Variant::Outline,
            ComponentSize::Sm,
        ),
    );

    let layout = {
        #[cfg(feature = "view")]
        {
            view! { VStack::new(90)
            .child(20, |rect| Heading::new("Demo", rect))
            .child(20, |rect| Text::new("Hello", rect))
            .child(30, |rect| {
                Button::new("Tap", rect)
                    .icon("save")
                    .on_click(|_| println!("clicked"))
            })
            .child(30, |rect| {
                IconButton::new("edit", rect)
                    .on_click(|_| println!("edit"))
            })
            .child(20, |rect| {
                Checkbox::new("Accept", rect).on_change(|v| println!("checkbox: {v}"))
            })
            .child(20, |rect| {
                Switch::new(rect).on_change(|v| println!("switch: {v}"))
            })
            .child(20, |rect| {
                Radio::new("Option", rect).on_change(|v| println!("radio: {v}"))
            })
            .child(20, |rect| { Badge::new("NEW", rect) })
            .child(20, |rect| {
                Tag::new("rust", rect).on_remove(|| println!("tag removed"))
            })
            .child(30, |rect| { Alert::new("Saved", rect) })
            .child(20, |rect| {
                Input::new("Name", rect).on_change(|v| println!("input: {v}"))
            })
            .child(40, |rect| {
                Textarea::new("Multiline", rect).on_change(|v| println!("textarea: {v}"))
            })
            .child(30, |rect| Modal::new("Modal", rect))
            .child(30, |rect| Drawer::new("Menu", rect))
            .child(30, |rect| Toast::new("Saved", rect)) }
        }
        #[cfg(not(feature = "view"))]
        {
            VStack::new(90)
                .child(20, |rect| Heading::new("Demo", rect))
                .child(20, |rect| Text::new("Hello", rect))
                .child(30, |rect| {
                    Button::new("Tap", rect)
                        .icon("save")
                        .on_click(|_| println!("clicked"))
                })
                .child(30, |rect| {
                    IconButton::new("edit", rect).on_click(|_| println!("edit"))
                })
                .child(20, |rect| {
                    Checkbox::new("Accept", rect).on_change(|v| println!("checkbox: {v}"))
                })
                .child(20, |rect| {
                    Switch::new(rect).on_change(|v| println!("switch: {v}"))
                })
                .child(20, |rect| {
                    Radio::new("Option", rect).on_change(|v| println!("radio: {v}"))
                })
                .child(20, |rect| Badge::new("NEW", rect))
                .child(20, |rect| {
                    Tag::new("rust", rect).on_remove(|| println!("tag removed"))
                })
                .child(30, |rect| Alert::new("Saved", rect))
                .child(20, |rect| {
                    Input::new("Name", rect).on_change(|v| println!("input: {v}"))
                })
                .child(40, |rect| {
                    Textarea::new("Multiline", rect).on_change(|v| println!("textarea: {v}"))
                })
                .child(30, |rect| Modal::new("Modal", rect))
                .child(30, |rect| Drawer::new("Menu", rect))
                .child(30, |rect| Toast::new("Saved", rect))
        }
    };

    let _ = (style, new_components, layout);
}

pub fn style(&self) -> &Style

Immutable access to the button’s style.

pub fn style_mut(&mut self) -> &mut Style

Mutable access to the button’s style.

pub fn set_text(&mut self, text: impl Into<String>)

Update the label displayed on the button.

pub fn text(&self) -> &str

Retrieve the current button label.

pub fn set_on_click<F>(&mut self, handler: F)

where F: FnMut(&mut Button) + 'static,

Register a callback invoked when the button is released.

Trait Implementations

impl Icon for Button

fn icon(self, name: &str) -> Self

Prefix the button label with the specified icon, if known.

impl OnClick for Button

fn on_click<F: FnMut(&mut Self) + 'static>(self, handler: F) -> Self

Attach a click handler executed when the widget is released.

impl StyleProps for Button

fn style_mut(&mut self) -> &mut Style

Return the mutable style used by this widget’s main visual part.

fn with_style(self, style: Style) -> Self

Replace the complete main style.

fn bg(self, color: Color) -> Self

Set the background color.

fn bg_color(self, color: Color) -> Self

Set the background color.

fn border_color(self, color: Color) -> Self

Set the border color.

fn border_width(self, width: u8) -> Self

Set the border width in pixels.

fn radius(self, radius: u8) -> Self

Set the corner radius in pixels.

fn rounded(self, radius: u8) -> Self

Set the corner radius in pixels.

fn opacity(self, alpha: u8) -> Self

Set widget opacity as 0..=255.

fn alpha(self, alpha: u8) -> Self

Set widget opacity as 0..=255.

impl Widget for Button

fn handle_event(&mut self, event: &Event) -> bool

Delegate pointer events and invoke the click handler when released.

fn bounds(&self) -> Rect

Return the area this widget occupies relative to its parent.

fn draw(&self, renderer: &mut dyn Renderer)

Render the widget using the provided Renderer.

fn clear_region(&mut self) -> Option<Rect>

Return a region (in draw/landscape coordinates) that should be restored from the pristine background copy, or None.

fn set_bounds(&mut self, _bounds: Rect)

Called by the LPAR-10 layout pass to notify this widget of its layout-computed bounds.

fn widget_font_mut(&mut self) -> Option<&mut WidgetFont>

Expose this widget’s font slot for cascade-driven font resolution (FONT-05 §5.B).