slate-framework 1.0.1

GPU-accelerated Rust UI framework — umbrella crate
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

//! Div — flexbox container element.
//!
//! Div is the primary container element, supporting:
//! - Flexbox layout via Taffy (using unified Style type)
//! - Background color with corner radius
//! - Padding and margin
//! - Child elements

mod builder;
mod handlers;
mod layout;
mod style;

use crate::element::{AnyElement, IntoElement, Sealed};
use crate::event::{
    ElementKeyHandler, ElementTextInputHandler, MouseHandler, PointerHandler, ScrollHandler,
};
use crate::style::Style;
use crate::types::ElementId;

/// Flexbox container element.
///
/// # Example
///
/// ```ignore
/// Div::new()
///     .background([0.2, 0.2, 0.2, 1.0])
///     .corner_radius(8.0)
///     .style(|s| s.padding_all(16.0).gap(8.0))
///     .child(Text::new("Hello"))
///     .child(Text::new("World"))
/// ```
pub struct Div {
    pub(super) children: Vec<AnyElement>,
    pub(super) layout_style: Style,
    pub(super) visual: DivVisual,
    /// User-provided stability key for dynamic lists (consumed during prepaint).
    pub(super) user_key: Option<String>,
    /// Stable ElementId allocated during prepaint (available after prepaint).
    pub(super) last_id: Option<ElementId>,
    // -------------------------------------------------------------------------
    // Event handlers
    // -------------------------------------------------------------------------
    /// Handler for synthesized click events (down+up on same target).
    pub(crate) on_click: Option<MouseHandler>,
    /// Handler for mouse button down events.
    pub(crate) on_mouse_down: Option<MouseHandler>,
    /// Handler for mouse button up events.
    pub(crate) on_mouse_up: Option<MouseHandler>,
    /// Handler for mouse move events (coalesced, one per frame).
    pub(crate) on_mouse_move: Option<MouseHandler>,
    /// Handler for scroll wheel/trackpad events.
    pub(crate) on_mouse_scrolled: Option<ScrollHandler>,
    /// Handler for raw pointer events (no coalescing).
    pub(crate) on_pointer_event: Option<PointerHandler>,
    /// Handler for pointer enter events.
    pub(crate) on_pointer_enter: Option<PointerHandler>,
    /// Handler for pointer leave events.
    pub(crate) on_pointer_leave: Option<PointerHandler>,
    // -------------------------------------------------------------------------
    // Focus configuration
    // -------------------------------------------------------------------------
    /// True if this element opts in to keyboard focus (registers with `FocusRegistry`).
    pub(crate) focusable: bool,
    /// W3C-style tab index. Negative excludes from Tab cycle but still allows
    /// programmatic focus via `AppContext::set_focus`.
    pub(crate) tab_index: i32,
    /// Whether the framework-provided focus ring is painted when focused.
    pub(crate) focus_ring: bool,
    // -------------------------------------------------------------------------
    // Per-element keyboard handlers
    // -------------------------------------------------------------------------
    /// Handler for KeyDown events while this element is on the focused chain.
    pub(crate) on_key_down: Option<ElementKeyHandler>,
    /// Handler for KeyUp events while this element is on the focused chain.
    pub(crate) on_key_up: Option<ElementKeyHandler>,
    /// Handler for composed text input while this element is on the focused chain.
    pub(crate) on_text_input: Option<ElementTextInputHandler>,
    // -------------------------------------------------------------------------
    // IME configuration + handlers
    // -------------------------------------------------------------------------
    /// True if this element opts in to IME composition. The framework
    /// registers an `ImeState` entry each prepaint when this is set; OS
    /// sync queries answered via the published `CachedImeQuery` snapshot.
    pub(crate) ime_capable: bool,
    /// Handler for IME preedit updates while this element is on the focused
    /// chain.
    pub(crate) on_ime_preedit: Option<crate::event::ElementImePreeditHandler>,
    /// Handler for IME commits while this element is on the focused chain.
    /// Empty commit text is the "clear preedit, no insert" signal.
    pub(crate) on_ime_commit: Option<crate::event::ElementImeCommitHandler>,
}

/// Visual styling for a Div (non-layout properties).
#[derive(Clone, Debug, Default)]
pub struct DivVisual {
    /// Background color (linear, premultiplied RGBA).
    pub background: Option<[f32; 4]>,
    /// Corner radius in logical pixels.
    pub corner_radius: f32,
}

/// Layout state for Div — stores Taffy node ID.
pub struct DivLayoutState {
    pub(super) node_id: taffy::NodeId,
}

/// Paint state for Div — currently empty.
pub struct DivPaintState;

impl Default for Div {
    fn default() -> Self {
        Self::new()
    }
}

impl Sealed for Div {}

impl IntoElement for Div {
    type Element = Self;
    fn into_element(self) -> Self {
        self
    }
}