Struct MaterialCheckbox 

pub struct MaterialCheckbox<'a> { /* private fields */ }

Material Design checkbox component following Material Design 3 specifications

Provides a checkbox with three states: checked, unchecked, and indeterminate. Follows Material Design guidelines for colors, sizing, and interaction states.

Usage Examples

let mut checked = false;

// Basic checkbox
ui.add(MaterialCheckbox::new(&mut checked, "Accept terms"));

// Checkbox with indeterminate state
let mut partial_checked = false;
ui.add(MaterialCheckbox::new(&mut partial_checked, "Select all")
    .indeterminate(true));

// Disabled checkbox
let mut disabled_checked = false;  
ui.add(MaterialCheckbox::new(&mut disabled_checked, "Disabled option")
    .enabled(false));

Material Design Spec

• Size: 18x18dp checkbox with 40x40dp touch target
• Colors: Primary color when checked, outline when unchecked
• Animation: 150ms cubic-bezier transition
• States: Normal, hover, focus, pressed, disabled, error

Implementations

impl<'a> MaterialCheckbox<'a>

pub fn new(checked: &'a mut bool, text: impl Into<String>) -> Self

Create a new Material Design checkbox

Parameters

• checked: Mutable reference to boolean state
• text: Label text displayed next to checkbox

Returns

A new MaterialCheckbox instance with default settings

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

Set the indeterminate state of the checkbox

Indeterminate checkboxes are used when the checkbox represents a collection of items where some, but not all, are selected.

Parameters

• indeterminate: True for indeterminate state, false for normal

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

Set whether the checkbox is enabled or disabled

Disabled checkboxes cannot be interacted with and are visually dimmed.

Parameters

• enabled: True for interactive, false for disabled

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

Set whether the checkbox should display in error state

Error state checkboxes use error color from the theme to indicate validation failure or invalid selection.

Parameters

• is_error: True for error state styling

pub fn check_color(self, color: Color32) -> Self

Set custom check mark color

Overrides the default check mark color from the theme.

Parameters

• color: Custom color for the check mark

pub fn fill_color(self, color: Color32) -> Self

Set custom fill color when checked

Overrides the default fill color from the theme.

Parameters

• color: Custom fill color when checkbox is checked

pub fn border_width(self, width: f32) -> Self

Set custom border width

Parameters

• width: Border width in pixels (default: 2.0)

Trait Implementations

impl<'a> Widget for MaterialCheckbox<'a>

fn ui(self, ui: &mut Ui) -> Response

Allocate space, interact, paint, and return a Response.