Skip to main content

patternfly_yew/components/
label.rs

1//! Label
2use crate::prelude::{AsClasses, Button, ButtonVariant, ExtendClasses, Icon};
3use yew::prelude::*;
4
5use strum_macros::{Display, EnumIter, EnumString};
6
7#[derive(Copy, Clone, Default, Display, Debug, PartialEq, Eq, EnumIter, EnumString)]
8pub enum Color {
9    #[default]
10    Grey,
11    Blue,
12    Green,
13    Orange,
14    Red,
15    Purple,
16    Teal,
17    Yellow,
18}
19
20impl AsClasses for Color {
21    fn extend_classes(&self, classes: &mut Classes) {
22        match self {
23            Color::Grey => {}
24            Color::Blue => classes.push("pf-m-blue"),
25            Color::Green => classes.push("pf-m-green"),
26            Color::Orange => classes.push("pf-m-orange"),
27            Color::Red => classes.push("pf-m-red"),
28            Color::Purple => classes.push("pf-m-purple"),
29            Color::Teal => classes.push("pf-m-teal"),
30            Color::Yellow => classes.push("pf-m-yellow"),
31        }
32    }
33}
34
35/// Properties for [`Label`]
36#[derive(Clone, Debug, PartialEq, Properties)]
37pub struct LabelProperties {
38    #[prop_or_default]
39    pub label: String,
40    #[prop_or_default]
41    pub color: Color,
42    #[prop_or_default]
43    pub outline: bool,
44    #[prop_or_default]
45    pub overflow: bool,
46    #[prop_or_default]
47    pub icon: Option<Icon>,
48    #[prop_or_default]
49    pub onclose: Option<Callback<()>>,
50    #[prop_or_default]
51    pub onclick: Option<Callback<()>>,
52    /// Disables the label if it's clickable (if `onclick` is set) or removable (if `onclose` is set).
53    #[prop_or_default]
54    pub disabled: bool,
55    #[prop_or_default]
56    pub compact: bool,
57}
58
59/// Label component
60///
61/// > The **label** component allows users to add specific element captions for user clarity and convenience.
62///
63/// See: <https://www.patternfly.org/components/label/html>
64///
65/// ## Properties
66///
67/// Defined in [`LabelProperties`].
68#[function_component(Label)]
69pub fn label(props: &LabelProperties) -> Html {
70    let mut classes = Classes::from("pf-v6-c-label");
71
72    classes.extend_from(&props.color);
73
74    if props.outline {
75        classes.push("pf-m-outline");
76    }
77
78    if props.overflow {
79        classes.push("pf-m-overflow");
80    }
81
82    if props.compact {
83        classes.push("pf-m-compact");
84    }
85
86    if props.onclick.is_some() {
87        classes.push("pf-m-clickable");
88    }
89
90    if props.disabled {
91        classes.push("pf-m-disabled");
92    }
93
94    let content = |content: Html| {
95        if let Some(onclick) = props.onclick.clone() {
96            let onclick = Callback::from(move |_| onclick.emit(()));
97
98            html! {<button class="pf-v6-c-label__content pf-m-clickable" {onclick} disabled={props.disabled}>{content}</button>}
99        } else {
100            html! {<span class="pf-v6-c-label__content">{content}</span>}
101        }
102    };
103
104    html! (
105        <span class={classes}>
106            { content (
107                html!(
108                    <>
109                        if let Some(icon) = &props.icon {
110                            <span class="pf-v6-c-label__icon"> { icon.as_html() } </span>
111                        }
112                        <span class="pf-v6-c-label__text">
113                            { &props.label }
114                        </span>
115                        if let Some(onclose) = &props.onclose {
116                            <span class="pf-v6-c-label__actions">
117                                <Button class={"pf-m-no-padding"} variant={ButtonVariant::Plain} icon={Icon::Times} onclick={onclose.reform(|_| {})} disabled={props.disabled}/>
118                            </span>
119                        }
120                    </>
121                )
122            )}
123        </span>
124    )
125}