zng-wgt 0.3.0

Part of the zng project.
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

use zng_app::widget::node::Z_INDEX;

use crate::prelude::*;

/// Defines the render order of a widget in a layout panel.
///
/// When set the widget will still update and layout according to their *logical* position in the list but
/// they will render according to the order defined by the [`ZIndex`] value.
///
/// An error is logged on init if the widget is not a direct child of a Z-sorting panel.
///
/// [`ZIndex`]: zng_app::widget::node::ZIndex
#[property(CONTEXT, default(ZIndex::DEFAULT))]
pub fn z_index(child: impl UiNode, index: impl IntoVar<ZIndex>) -> impl UiNode {
    let index = index.into_var();
    let mut valid = false;

    match_node(child, move |_, op| match op {
        UiNodeOp::Init => {
            valid = Z_INDEX.set(index.get());

            if valid {
                WIDGET.sub_var(&index);
            } else {
                tracing::error!(
                    "property `z_index` set for `{}` but it is not the direct child of a Z-sorting panel",
                    WIDGET.trace_id()
                );
            }
        }
        UiNodeOp::Update { .. } => {
            if valid {
                if let Some(i) = index.get_new() {
                    assert!(Z_INDEX.set(i));
                }
            }
        }
        _ => {}
    })
}