bevy_pages 0.1.0

A lightweight and elegant framework to upgrade your Bevy UI experience.
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

use crate::element::ElementId;
use bevy::prelude::{Changed, Commands, Entity, Event, Query};
use bevy::ui::Interaction;

pub(crate) fn interactions(
    mut commands: Commands,
    entities: Query<(Entity, &Interaction, Option<&ElementId>), Changed<Interaction>>,
) {
    for (e, i, id) in entities {
        if matches!(i, Interaction::Pressed) {
            commands.trigger(ElementClick {
                entity: e,
                id: id.cloned(),
            });
        } else if matches!(i, Interaction::Hovered) {
            commands.trigger(ElementHover {
                entity: e,
                id: id.cloned(),
            });
        }
    }
}

/// An event triggered when a clickable element like a button is clicked.
#[derive(Clone, PartialEq, Eq, Debug, Hash, Event)]
pub struct ElementClick {
    /// The entity behind the target element.
    pub entity: Entity,
    /// The element ID of the target element.
    pub id: Option<ElementId>,
}

impl ElementClick {
    /// Returns [true] if the target element ID matches the given ID.
    pub fn matches_id(&self, id: impl Into<ElementId>) -> bool {
        self.id.as_ref().map(|i| *i == id.into()).unwrap_or(false)
    }
}

/// An event triggered when the mouse hovers over an interactable element like a button.
#[derive(Clone, PartialEq, Eq, Debug, Hash, Event)]
pub struct ElementHover {
    /// The entity behind the target element.
    pub entity: Entity,
    /// The element ID of the target element.
    pub id: Option<ElementId>,
}

impl ElementHover {
    /// Returns [true] if the target element ID matches the given ID.
    pub fn matches_id(&self, id: impl Into<ElementId>) -> bool {
        self.id.as_ref().map(|i| *i == id.into()).unwrap_or(false)
    }
}

/// An event triggered when an element is spawned.
#[derive(Clone, PartialEq, Eq, Debug, Hash, Event)]
pub struct ElementSpawn {
    /// The entity behind the target element.
    pub entity: Entity,
    /// The element ID of the target element.
    pub id: Option<ElementId>,
}

impl ElementSpawn {
    /// Returns [true] if the target element ID matches the given ID.
    pub fn matches_id(&self, id: impl Into<ElementId>) -> bool {
        self.id.as_ref().map(|i| *i == id.into()).unwrap_or(false)
    }
}