Forms

Form Components

Interactive input components for building forms. All live in aurora_widgets::components and require the text feature.

For single-line text input, see TextInput. For multi-line, see TextArea below.

---

Checkbox

A toggle checkbox with optional label.

Checkbox::new()
    .checked(true)
    .label("Accept terms")
    .on_change(|checked| println!("Checked: {checked}"))

Method	Description
checked(bool)	Initial state
label(impl Into<String>)	Text label
size(f32)	Checkbox size in pixels
disabled(bool)	Disable interaction
on_change(FnMut(bool))	Fires when toggled

---

Switch

A toggle switch (on/off).

Switch::new()
    .checked(false)
    .on_color(Color::from_hex(0x22c55e, false))
    .on_change(|on| println!("Switch: {on}"))

Method	Description
checked(bool)	Initial state
disabled(bool)	Disable interaction
on_color(Color)	Track color when on
off_color(Color)	Track color when off
on_change(FnMut(bool))	Fires when toggled

---

Slider

A horizontal slider for numeric input.

Slider::new()
    .value(0.5)
    .min(0.0)
    .max(100.0)
    .step(1.0)
    .on_change(|value| println!("Value: {value}"))

Method	Description
value(f32)	Current value
min(f32) / max(f32)	Range bounds
step(f32)	Snap increment
width(f32)	Track width
track_color(Color)	Unfilled track color
fill_color(Color)	Filled portion color
thumb_color(Color)	Thumb color
disabled(bool)	Disable interaction
on_change(FnMut(f32))	Fires on value change

---

RadioGroup

A group of mutually exclusive radio buttons.

RadioGroup::new()
    .item("Small")
    .item("Medium")
    .item("Large")
    .selected(1)
    .on_change(|index| println!("Selected: {index}"))

Method	Description
item(impl Into<String>)	Add a radio option
selected(usize)	Initially selected index
radio_size(f32)	Radio circle diameter
spacing(f32)	Gap between items
on_change(FnMut(usize))	Fires with selected index

---

Toggle

A toggle button (pressed/unpressed).

Toggle::new()
    .label("Bold")
    .pressed(false)
    .on_change(|pressed| println!("Pressed: {pressed}"))

---

ToggleGroup

A group of toggle buttons where one (or none) is active.

ToggleGroup::new()
    .item("Left")
    .item("Center")
    .item("Right")
    .selected(0)
    .on_change(|index| println!("Selected: {index}"))

---

Tabs

A tabbed panel with tab headers and content switching.

Tabs::new()
    .tab("General", general_content)
    .tab("Advanced", advanced_content)
    .selected(0)

Method	Description
tab(impl Into<String>, impl Widget)	Add a tab with label and content
selected(usize)	Initially selected tab
tab_height(f32)	Tab header height
tab_padding(f32)	Horizontal padding in tabs
indicator_height(f32)	Active tab indicator thickness
indicator_color(Color)	Active tab indicator color
width(f32)	Fixed width

---

Accordion

Collapsible sections that expand/collapse on click.

Accordion::new()
    .section("Section 1", Text::new("Content for section 1"))
    .section("Section 2", Text::new("Content for section 2"))
    .allow_multiple(false)

Method	Description
section(impl Into<String>, impl Widget)	Add a collapsible section
allow_multiple(bool)	Allow multiple sections open at once
header_height(f32)	Section header height
header_padding(Edges)	Header inner padding
content_padding(Edges)	Content inner padding
border_color(Color)	Section border color
spacing(f32)	Gap between sections

---

Collapsible

A single collapsible section with a trigger and content.

Collapsible::new()
    .trigger(Text::new("Click to expand"))
    .content(Text::new("Hidden content"))

---

ButtonGroup

A row of buttons that share borders and form a connected strip.

ButtonGroup::new()
    .button(button!("Cut"))
    .button(button!("Copy"))
    .button(button!("Paste"))

---

InputGroup

A text input with attached prefix or suffix elements.

InputGroup::new()
    .prefix(Text::new("$"))
    .input(TextInput::new().placeholder("Amount"))
    .suffix(button!("Send"))

---

Field

A form field wrapper with label, input, and optional description/error message.

Field::new()
    .label("Email")
    .input(TextInput::new().placeholder("you@example.com"))
    .description("We'll never share your email.")

---

TextArea

A multi-line text input.

TextArea::new()
    .placeholder("Write your message...")
    .rows(5)
    .width(400.0)
    .on_change(|text| println!("Text: {text}"))

Method	Description
placeholder(impl Into<String>)	Placeholder text
text(impl Into<String>)	Initial value
rows(usize)	Visible line count
width(f32) / height(f32)	Fixed dimensions
tab_index(u32)	Tab navigation order
on_change(FnMut(&str))	Fires when text changes
on_submit(FnMut())	Fires on Enter