masonry 0.4.0

Traits and types of the Masonry toolkit.
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

// Copyright 2025 the Xilem Authors
// SPDX-License-Identifier: Apache-2.0

use accesskit::NodeId;
use assert_matches::assert_matches;
use masonry_core::core::{NewWidget, Widget, WidgetTag};
use masonry_testing::{ModularWidget, Record, TestHarness, TestWidgetExt, assert_any, assert_none};

use crate::theme::default_property_set;
use crate::widgets::SizedBox;

#[test]
fn request_accessibility() {
    let target_tag = WidgetTag::new("target");
    let parent_tag = WidgetTag::new("parent");
    let child = NewWidget::new_with_tag(SizedBox::empty().record(), target_tag);
    let parent = NewWidget::new_with_tag(ModularWidget::new_parent(child).record(), parent_tag);
    let grandparent = NewWidget::new(ModularWidget::new_parent(parent));

    let mut harness = TestHarness::create(default_property_set(), grandparent);
    harness.flush_records_of(target_tag);
    harness.flush_records_of(parent_tag);

    harness.edit_widget(target_tag, |mut widget| {
        widget.ctx.request_accessibility_update();
    });
    let _ = harness.render();

    // Check that `Widget::accessibility()` is called for the child (which did request it)
    // but not the parent (which did not).
    let records = harness.take_records_of(target_tag);
    assert_any(records, |r| matches!(r, Record::Accessibility));

    let records = harness.take_records_of(parent_tag);
    assert_none(records, |r| matches!(r, Record::Accessibility));

    // Check that `Widget::accessibility()` is not called: neither node has requested
    // an accessibility update.
    let _ = harness.render();
    assert_matches!(harness.take_records_of(target_tag)[..], []);
    assert_matches!(harness.take_records_of(parent_tag)[..], []);
}

#[test]
fn access_node_children() {
    let parent_tag = WidgetTag::new("parent");

    let child_1 = NewWidget::new(SizedBox::empty());
    let child_2 = NewWidget::new(SizedBox::empty());
    let child_3 = NewWidget::new(SizedBox::empty());

    let parent = NewWidget::new_with_tag(
        ModularWidget::new_multi_parent(vec![child_1, child_2, child_3]),
        parent_tag,
    );
    let grandparent = NewWidget::new(ModularWidget::new_parent(parent));

    let mut harness = TestHarness::create(default_property_set(), grandparent);
    let _ = harness.render();

    let parent_ref = harness.get_widget(parent_tag);
    let parent_node_id = parent_ref.id();
    let [id_1, id_2, id_3] = parent_ref.inner().children_ids()[..] else {
        unreachable!()
    };

    let parent_node = harness.access_node(parent_node_id).unwrap();
    assert_eq!(
        Vec::<NodeId>::from_iter(parent_node.child_ids()),
        vec![id_1, id_2, id_3]
    );

    // We stash a child
    harness.edit_widget(parent_tag, |mut parent| {
        parent.ctx.set_stashed(&mut parent.widget.state[1], true);
        parent.ctx.request_accessibility_update();
    });
    let _ = harness.render();

    // Stash child is not included
    let parent_node = harness.access_node(parent_node_id).unwrap();
    assert_eq!(
        Vec::<NodeId>::from_iter(parent_node.child_ids()),
        vec![id_1, id_3]
    );
}