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

# Dialog

Material Design 3 dialog component for modal interactions.

## Types

| Type | Description |
|------|-------------|
| `Basic` | Standard modal dialog |
| `FullScreen` | Full-screen dialog for complex content |

## Basic Usage

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

fn setup(mut commands: Commands, theme: Res<MaterialTheme>) {
    // Create a dialog (starts closed by default)
    MaterialDialog::new()
        .title("Confirm Action")
        .spawn_with_children(&mut commands, &theme, |parent| {
            parent.spawn(Text::new("Are you sure you want to proceed?"));
        });
}
```

## Opening Dialogs

```rust
// Use the DialogOpenEvent to open a dialog
fn open_dialog(
    mut writer: EventWriter<DialogOpenEvent>,
    dialog_query: Query<Entity, With<MaterialDialog>>,
) {
    if let Ok(dialog_entity) = dialog_query.get_single() {
        writer.send(DialogOpenEvent { entity: dialog_entity });
    }
}
```

## With Icon

```rust
MaterialDialog::new()
    .title("Warning")
    .icon(ICON_WARNING)
    .spawn_with_children(&mut commands, &theme, |parent| {
        parent.spawn(Text::new("This action cannot be undone."));
    });
```

## Full-Screen Dialog

```rust
MaterialDialog::new()
    .with_type(DialogType::FullScreen)
    .title("Edit Profile")
    .spawn_with_children(&mut commands, &theme, |parent| {
        // Full-screen content
    });
```

## Dismiss Behavior

```rust
// Prevent scrim click dismissal
MaterialDialog::new()
    .title("Important")
    .no_scrim_dismiss()
    .spawn_with_children(&mut commands, &theme, |parent| {
        // Content
    });

// Prevent escape key dismissal
MaterialDialog::new()
    .title("Confirmation Required")
    .no_escape_dismiss()
    .spawn_with_children(&mut commands, &theme, |parent| {
        // Content
    });
```

## Handling Events

```rust
use bevy_material_ui::dialog::{DialogOpenEvent, DialogCloseEvent, DialogConfirmEvent};

fn handle_dialog_events(
    mut open_reader: EventReader<DialogOpenEvent>,
    mut close_reader: EventReader<DialogCloseEvent>,
    mut confirm_reader: EventReader<DialogConfirmEvent>,
) {
    for event in open_reader.read() {
        println!("Dialog opened: {:?}", event.entity);
    }
    
    for event in close_reader.read() {
        println!("Dialog closed: {:?}", event.entity);
    }
    
    for event in confirm_reader.read() {
        println!("Dialog confirmed: {:?}", event.entity);
    }
}
```

## Properties

| Property | Type | Default | Description |
|----------|------|---------|-------------|
| `dialog_type` | `DialogType` | `Basic` | Dialog style |
| `open` | `bool` | `false` | Visibility state |
| `title` | `Option<String>` | `None` | Dialog title |
| `icon` | `Option<String>` | `None` | Header icon |
| `dismiss_on_scrim_click` | `bool` | `true` | Close when clicking outside |
| `dismiss_on_escape` | `bool` | `true` | Close on Escape key |

## Elevation

Dialogs use Level 3 elevation with appropriate shadow.