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
87
88
89
90
91
92

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

use std::any::TypeId;

use crate::core::{Property, UpdateCtx};
use crate::peniko::color::{AlphaColor, Srgb};

/// The color of a widget's content, often text and text decorations.
///
/// **IMPORTANT:** This property is defined for [`Label`] and [`TextArea`], *not*
/// for widgets embedding them such as [`Button`], [`Checkbox`], [`TextInput`], [`Prose`], etc.
///
/// This property is also defined for [`Spinner`].
///
/// [`Label`]: crate::widgets::Label
/// [`TextArea`]: crate::widgets::TextArea
/// [`Button`]: crate::widgets::Button
/// [`Checkbox`]: crate::widgets::Checkbox
/// [`TextInput`]: crate::widgets::TextInput
/// [`Spinner`]: crate::widgets::Spinner
/// [`Prose`]: crate::widgets::Prose
#[expect(missing_docs, reason = "field names are self-descriptive")]
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct ContentColor {
    pub color: AlphaColor<Srgb>,
}

impl Property for ContentColor {
    fn static_default() -> &'static Self {
        static DEFAULT: ContentColor = ContentColor {
            color: AlphaColor::BLACK,
        };
        &DEFAULT
    }
}

impl ContentColor {
    /// Create new `ContentColor` with given value.
    pub const fn new(color: AlphaColor<Srgb>) -> Self {
        Self { color }
    }
}

/// The color of a widget's content when disabled.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct DisabledContentColor(pub ContentColor);

impl Property for DisabledContentColor {
    fn static_default() -> &'static Self {
        static DEFAULT: DisabledContentColor = DisabledContentColor(ContentColor {
            color: AlphaColor::BLACK,
        });
        &DEFAULT
    }
}

// ---

impl Default for ContentColor {
    fn default() -> Self {
        *Self::static_default()
    }
}

impl ContentColor {
    /// Helper function to be called in [`Widget::property_changed`](crate::core::Widget::property_changed).
    pub fn prop_changed(ctx: &mut UpdateCtx<'_>, property_type: TypeId) {
        if property_type != TypeId::of::<Self>() {
            return;
        }
        ctx.request_paint_only();
    }
}

// ---

impl Default for DisabledContentColor {
    fn default() -> Self {
        *Self::static_default()
    }
}

impl DisabledContentColor {
    /// Helper function to be called in [`Widget::property_changed`](crate::core::Widget::property_changed).
    pub fn prop_changed(ctx: &mut UpdateCtx<'_>, property_type: TypeId) {
        if property_type != TypeId::of::<Self>() {
            return;
        }
        ctx.request_paint_only();
    }
}