bevy_material_ui 0.2.7

Material Design 3 UI components for Bevy game engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# Select

Material Design 3 dropdown select component.

## Variants

| Variant | Description |
|---------|-------------|
| `Filled` | Filled text field style |
| `Outlined` | Outlined text field style |

## Basic Usage

```rust
use bevy_material_ui::prelude::*;

fn setup(mut commands: Commands, theme: Res<MaterialTheme>) {
    let options = vec![
        SelectOption::new("Option 1").value("option1"),
        SelectOption::new("Option 2").value("option2"),
        SelectOption::new("Option 3").value("option3"),
    ];

    commands.spawn(Node::default()).with_children(|ui| {
        ui.spawn_filled_select(&theme, "Choose an option", options);
    });
}
```

## With Default Value

```rust
let options = vec![
    SelectOption::new("United States").value("us"),
    SelectOption::new("United Kingdom").value("uk"),
    SelectOption::new("Canada").value("ca"),
];

commands.spawn(Node::default()).with_children(|ui| {
    ui.spawn_select_with(
        &theme,
        SelectBuilder::new(options)
            .label("Country")
            .selected(0),
    );
});
```

## Outlined Variant

```rust
let options = vec![
    SelectOption::new("Category 1").value("cat1"),
    SelectOption::new("Category 2").value("cat2"),
];

commands.spawn(Node::default()).with_children(|ui| {
    ui.spawn_outlined_select(&theme, "Category", options);
});
```

## With Icons

```rust
let options = vec![
    // Prefer Material icon *names* (these are resolved via `MaterialIcon::from_name`).
    SelectOption::new("Home").value("home").icon("home"),
    SelectOption::new("Settings").value("settings").icon("settings"),
    // You can also pass a literal glyph (e.g. `MaterialIcon::check().as_str()`).
    SelectOption::new("Done").value("done").icon(MaterialIcon::check().as_str()),
];

commands.spawn(Node::default()).with_children(|ui| {
    ui.spawn_filled_select(&theme, "Priority", options);
});
```

Notes:

- The select dropdown arrow is rendered using embedded icon bitmaps.
- Option icons are rendered as embedded bitmaps when you provide a recognized icon name.

## Disabled State

```rust
let options = vec![SelectOption::new("A").value("a")];

commands.spawn(Node::default()).with_children(|ui| {
    ui.spawn_select_with(
        &theme,
        SelectBuilder::new(options)
            .label("Disabled Select")
            .disabled(true),
    );
});
```

## Handling Selection

```rust
use bevy_material_ui::select::SelectChangeEvent;

fn handle_select_changes(
    mut reader: EventReader<SelectChangeEvent>,
) {
    for event in reader.read() {
        let value = event.option.value.as_deref().unwrap_or("");
        println!("Selected: {} ({})", event.option.label, value);
    }
}
```

## Properties

| Property | Type | Default | Description |
|----------|------|---------|-------------|
| `label` | `Option<String>` | `None` | Field label |
| `variant` | `SelectVariant` | `Filled` | Visual style |
| `options` | `Vec<SelectOption>` | Required | Available options |
| `selected_index` | `Option<usize>` | `None` | Selected option index |
| `disabled` | `bool` | `false` | Disabled state |
| `error` | `bool` | `false` | Error state |
| `supporting_text` | `Option<String>` | `None` | Supporting text below |

## SelectChangeEvent

| Field | Type | Description |
|-------|------|-------------|
| `entity` | `Entity` | The select entity |
| `index` | `usize` | Selected option index |
| `option` | `SelectOption` | Selected option data |