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

# Chip

Material Design 3 chips for selections, filters, and actions.

## Variants

| Variant | Description | Use Case |
|---------|-------------|----------|
| `Assist` | Help complete tasks | Workflow assistance |
| `Filter` | Filter content | Category selection |
| `Input` | Represent user input | Tags, contacts |
| `Suggestion` | Dynamic suggestions | Search suggestions |

## Basic Usage

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

fn setup(mut commands: Commands, theme: Res<MaterialTheme>) {
    // Assist chip
    MaterialChip::new("Get directions")
        .with_variant(ChipVariant::Assist)
        .with_icon(ICON_DIRECTIONS)
        .spawn(&mut commands, &theme);

    // Filter chip
    MaterialChip::new("Featured")
        .with_variant(ChipVariant::Filter)
        .spawn(&mut commands, &theme);

    // Input chip (with delete button)
    MaterialChip::new("john@example.com")
        .with_variant(ChipVariant::Input)
        .deletable()
        .spawn(&mut commands, &theme);

    // Suggestion chip
    MaterialChip::new("Try this")
        .with_variant(ChipVariant::Suggestion)
        .spawn(&mut commands, &theme);
}
```

## Selected State

```rust
// Pre-selected filter chip
MaterialChip::new("Active")
    .with_variant(ChipVariant::Filter)
    .selected(true)
    .spawn(&mut commands, &theme);
```

## Elevated Chips

```rust
MaterialChip::new("Elevated")
    .with_elevation(ChipElevation::Elevated)
    .spawn(&mut commands, &theme);
```

## With Icons

```rust
// Leading icon
MaterialChip::new("Add filter")
    .with_icon(ICON_ADD)
    .spawn(&mut commands, &theme);

// Avatar (for input chips)
MaterialChip::new("Jane Doe")
    .with_variant(ChipVariant::Input)
    .with_avatar("path/to/avatar.png")
    .spawn(&mut commands, &theme);
```

## Deletable Chips

```rust
MaterialChip::new("Tag")
    .with_variant(ChipVariant::Input)
    .deletable()
    .spawn(&mut commands, &theme);
```

## Handling Events

```rust
use bevy_material_ui::chip::{ChipClickEvent, ChipDeleteEvent};

fn handle_chip_events(
    mut click_reader: EventReader<ChipClickEvent>,
    mut delete_reader: EventReader<ChipDeleteEvent>,
) {
    for event in click_reader.read() {
        println!("Chip clicked: {:?}", event.value);
    }
    
    for event in delete_reader.read() {
        println!("Chip deleted: {:?}", event.value);
    }
}
```

## Properties

| Property | Type | Default | Description |
|----------|------|---------|-------------|
| `variant` | `ChipVariant` | `Assist` | Chip style variant |
| `label` | `String` | Required | Chip text |
| `icon` | `Option<String>` | `None` | Leading icon |
| `selected` | `bool` | `false` | Selected state |
| `disabled` | `bool` | `false` | Disabled state |
| `deletable` | `bool` | `false` | Shows delete button |
| `elevation` | `ChipElevation` | `Flat` | Elevation level |

## State Layers

Chips apply MD3 state layers:
- **Hover**: 8% opacity overlay
- **Pressed**: 12% opacity overlay
- **Selected**: Uses secondary container colors