Skip to main content

xrack_layout/
keyboard.rs

1use crate::{LayoutNode, Target, input::valid};
2use xrack_runtime::{Component, EventResult, KeyEvent, KeyPhase, Node};
3
4/// The focus path for a single keyboard event.
5pub struct KeyRoute {
6    focus: Target,
7    scopes: Vec<Target>,
8}
9
10impl KeyRoute {
11    pub(crate) fn new(focus: Target, scopes: Vec<Target>) -> Option<Self> {
12        (!scopes.is_empty()).then_some(Self { focus, scopes })
13    }
14
15    pub fn focused(&self) -> &Target {
16        &self.focus
17    }
18
19    /// A phase returns None when no scope has a live handler for it.
20    pub fn dispatch(
21        &self,
22        component: &mut impl Component,
23        scene: &Node,
24        layout: &LayoutNode,
25        phase: KeyPhase,
26        event: &KeyEvent,
27    ) -> Option<EventResult> {
28        if !valid(&self.focus, scene, layout) {
29            return None;
30        }
31        let mut result = None;
32        let mut visit = |scope: &Target| {
33            if !valid(scope, scene, layout)
34                || !scene.at_path(&scope.path).is_some_and(|node| {
35                    node.kind == "FocusScope" && node.key_handlers & phase.mask() != 0
36                })
37            {
38                return false;
39            }
40            result = Some(component.key_event_at(scene, &scope.path, phase, event));
41            result == Some(EventResult::Accept)
42        };
43        let _ = match phase {
44            KeyPhase::CapturePressed | KeyPhase::CaptureReleased => {
45                self.scopes.iter().any(&mut visit)
46            }
47            KeyPhase::Pressed | KeyPhase::Released => self.scopes.iter().rev().any(&mut visit),
48        };
49        result
50    }
51}