oxivgl 0.1.2

Safe no_std Rust bindings for LVGL — embedded GUI on ESP32 and host SDL2
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

#![cfg_attr(target_arch = "xtensa", no_std, no_main)]
#![cfg_attr(
    target_arch = "xtensa",
    feature(impl_trait_in_assoc_type, type_alias_impl_trait)
)]
// SPDX-License-Identifier: MIT OR Apache-2.0
//! Gridnav 1 — Grid navigation with keyboard focus
//!
//! Two containers side-by-side. Left container has 10 checkable buttons in a
//! row-wrap flex layout (no rollover). Right container has a textarea,
//! checkbox, and two switches arranged manually (rollover enabled).
//! Arrow keys move focus between children; Tab switches between containers.

use oxivgl::{
    enums::{ObjFlag, ObjState},
    gridnav::{GridnavCtrl, gridnav_add},
    group::{Group, group_remove_obj},
    layout::FlexFlow,
    style::{LV_SIZE_CONTENT, Palette, lv_pct, palette_lighten},
    view::{NavAction, View},
    widgets::{Align, Button, Checkbox, Label, Obj, Switch, Textarea, WidgetError},
};

#[derive(Default)]
struct Gridnav1 {
    _group: Option<Group>,
    _label1: Option<Label<'static>>,
    _buttons: heapless::Vec<Button<'static>, 10>,
    _btn_labels: heapless::Vec<Label<'static>, 10>,
    _label2: Option<Label<'static>>,
    _ta: Option<Textarea<'static>>,
    _cb: Option<Checkbox<'static>>,
    _sw1: Option<Switch<'static>>,
    _sw2: Option<Switch<'static>>,
    // containers kept alive
    _cont1: Option<oxivgl::widgets::Obj<'static>>,
    _cont2: Option<oxivgl::widgets::Obj<'static>>,
}

impl View for Gridnav1 {
    fn create(&mut self, container: &Obj<'static>) -> Result<(), WidgetError> {

        // ── Container 1: buttons, no rollover ──────────────────────────────
        let cont1 = oxivgl::widgets::Obj::new(container)?;
        cont1
            .set_flex_flow(FlexFlow::RowWrap)
            .style_bg_color(
                palette_lighten(Palette::Blue, 5),
                ObjState::FOCUSED,
            )
            .size(lv_pct(50), lv_pct(100));

        gridnav_add(&cont1, GridnavCtrl::NONE);

        let label1 = Label::new(&cont1)?;
        label1.text("No rollover");

        let mut buttons: heapless::Vec<Button<'static>, 10> = heapless::Vec::new();
        let mut btn_labels: heapless::Vec<Label<'static>, 10> = heapless::Vec::new();
        for i in 0u32..10 {
            let btn = Button::new(&cont1)?;
            btn.size(70, LV_SIZE_CONTENT);
            btn.add_flag(ObjFlag::CHECKABLE);
            group_remove_obj(&btn);

            let lbl = Label::new(&btn)?;
            // Format button index as text; heapless label buffer fits small numbers.
            lbl.text(match i {
                0 => "0", 1 => "1", 2 => "2", 3 => "3", 4 => "4",
                5 => "5", 6 => "6", 7 => "7", 8 => "8", _ => "9",
            });
            lbl.center();

            // heapless::Vec::push returns Err if full; capacity is 10 == loop count.
            let _ = buttons.push(btn);
            let _ = btn_labels.push(lbl);
        }

        // ── Container 2: textarea/checkbox/switches, rollover ──────────────
        let cont2 = oxivgl::widgets::Obj::new(container)?;
        cont2
            .style_bg_color(
                palette_lighten(Palette::Blue, 5),
                ObjState::FOCUSED,
            )
            .size(lv_pct(50), lv_pct(100))
            .align(Align::RightMid, 0, 0);

        gridnav_add(&cont2, GridnavCtrl::ROLLOVER);

        let label2 = Label::new(&cont2)?;
        label2.width(lv_pct(100));
        label2.text("Rollover\nUse tab to focus the other container");

        let ta = Textarea::new(&cont2)?;
        ta.size(lv_pct(100), 80).pos(0, 80);
        group_remove_obj(&ta);

        let cb = Checkbox::new(&cont2)?;
        cb.pos(0, 170);
        group_remove_obj(&cb);

        let sw1 = Switch::new(&cont2)?;
        sw1.pos(0, 200);
        group_remove_obj(&sw1);

        let sw2 = Switch::new(&cont2)?;
        sw2.pos(lv_pct(50), 200);
        group_remove_obj(&sw2);

        // ── Group: only containers ─────────────────────────────────────────
        let group = Group::new()?;
        group.set_default();
        group.add_obj(&cont1);
        group.add_obj(&cont2);
        group.assign_to_keyboard_indevs();

        self._group = Some(group);
        self._label1 = Some(label1);
        self._buttons = buttons;
        self._btn_labels = btn_labels;
        self._label2 = Some(label2);
        self._ta = Some(ta);
        self._cb = Some(cb);
        self._sw1 = Some(sw1);
        self._sw2 = Some(sw2);
        self._cont1 = Some(cont1);
        self._cont2 = Some(cont2);
        Ok(())
    }

    fn update(&mut self) -> Result<NavAction, WidgetError> {
        Ok(NavAction::None)
    }
}

oxivgl_examples_common::example_main!(Gridnav1::default());