egui_form 0.8.0

Form validation for egui
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

use eframe::NativeOptions;
use egui::CentralPanel;

use egui_form::garde::field_path;
use egui_form::{Form, FormField};
use garde::Validate;

#[derive(Validate, Debug)]
struct Test {
    #[garde(length(min = 3, max = 10))]
    pub user_name: String,
    #[garde(email)]
    pub email: String,
    #[garde(dive)]
    pub nested: Nested,
    #[garde(dive)]
    pub vec: Vec<Nested>,
}

#[derive(Validate, Debug)]
struct Nested {
    #[garde(range(min = 1, max = 10))]
    pub test: u64,
}

fn form_ui(ui: &mut egui::Ui, test: &mut Test) {
    let mut form = Form::new().add_report(egui_form::garde::GardeReport::new(test.validate()));

    FormField::new(&mut form, "user_name")
        .label("User Name")
        .ui(ui, egui::TextEdit::singleline(&mut test.user_name));
    FormField::new(&mut form, "email")
        .label("Email")
        .ui(ui, egui::TextEdit::singleline(&mut test.email));
    FormField::new(&mut form, field_path!("nested", "test"))
        .label("Nested Test")
        .ui(ui, egui::Slider::new(&mut test.nested.test, 0..=11));
    FormField::new(&mut form, field_path!("vec", 0, "test"))
        .label("Vec Test")
        .ui(
            ui,
            egui::DragValue::new(&mut test.vec[0].test).range(0..=11),
        );

    if let Some(Ok(())) = form.handle_submit(&ui.button("Submit"), ui) {
        println!("Form submitted: {test:?}");
    }
}

fn main() -> eframe::Result<()> {
    let mut test = Test {
        user_name: "testfiwuehfwoi".to_string(),
        email: "lefwojwfpke".to_string(),
        nested: Nested { test: 0 },
        vec: vec![Nested { test: 0 }],
    };

    eframe::run_ui_native(
        "Egui Garde Validation",
        NativeOptions::default(),
        move |ui, _frame| {
            CentralPanel::default().show_inside(ui, |ui| {
                form_ui(ui, &mut test);
            });
        },
    )
}

#[cfg(test)]
mod tests {
    use super::*;
    use egui_form::garde::GardeReport;
    use egui_form::{EguiValidationReport, IntoFieldPath};

    #[test]
    fn test() {
        let test = Test {
            user_name: "testfiwuehfwoi".to_string(),
            email: "garbage".to_string(),
            nested: Nested { test: 0 },
            vec: vec![Nested { test: 0 }],
        };

        let report = GardeReport::new(test.validate());

        assert!(report
            .get_field_error("user_name".into_field_path())
            .is_some());
        assert!(report.get_field_error(field_path!("email")).is_some());
        assert!(report
            .get_field_error(field_path!("nested", "test"))
            .is_some());
        assert!(report
            .get_field_error(field_path!("vec", 0, "test"))
            .is_some());

        assert_eq!(report.error_count(), 4);
    }
}