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 65)

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

    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, 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 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.