radix_leptos_primitives/components/

label.rs

use crate::utils::{merge_classes, generate_id};
use leptos::callback::Callback;
use leptos::children::Children;
use leptos::prelude::*;

/// Label component - Form labels with accessibility features
#[component]
pub fn Label(
    #[prop(optional)] class: Option<String>,
    #[prop(optional)] style: Option<String>,
    #[prop(optional)] children: Option<Children>,
    #[prop(optional)] for_id: Option<String>,
    #[prop(optional)] required: Option<bool>,
    #[prop(optional)] disabled: Option<bool>,
    #[prop(optional)] size: Option<LabelSize>,
    #[prop(optional)] variant: Option<LabelVariant>,
    #[prop(optional)] on_click: Option<Callback<()>>,
) -> impl IntoView {
    let for_id = for_id.unwrap_or_default();
    let required = required.unwrap_or(false);
    let disabled = disabled.unwrap_or(false);
    let size = size.unwrap_or_default();
    let variant = variant.unwrap_or_default();

    let class = merge_classes(vec![
        "label",
        &size.to_class(),
        &variant.to_class(),
        class.as_deref().unwrap_or(""),
    ]);

    let handle_click = move |_| {
        if !disabled {
            if let Some(callback) = on_click {
                callback.run(());
            }
        }
    };

    view! {
        <label
            class=class
            style=style
            for=for_id
            aria-required=required
            aria-disabled=disabled
            on:click=handle_click
        >
            {children.map(|c| c())}
        </label>
    }
}

/// Label Text component
#[component]
pub fn LabelText(
    #[prop(optional)] class: Option<String>,
    #[prop(optional)] style: Option<String>,
    #[prop(optional)] children: Option<Children>,
    #[prop(optional)] text: Option<String>,
    #[prop(optional)] required: Option<bool>,
) -> impl IntoView {
    let text = text.unwrap_or_default();
    let required = required.unwrap_or(false);

    let class = merge_classes(vec!["label-text"]);

    view! {
        <span class=class style=style>
            {text}
            {if required { "*" } else { "" }}
            {children.map(|c| c())}
        </span>
    }
}

/// Label Description component
#[component]
pub fn LabelDescription(
    #[prop(optional)] class: Option<String>,
    #[prop(optional)] style: Option<String>,
    #[prop(optional)] children: Option<Children>,
    #[prop(optional)] description: Option<String>,
) -> impl IntoView {
    let description = description.unwrap_or_default();

    let class = merge_classes(vec!["label-description", class.as_deref().unwrap_or("")]);

    view! {
        <div
            class=class
            style=style
            role="text"
            aria-label="Label description"
        >
            {children.map(|c| c())}
        </div>
    }
}

/// Label Error component
#[component]
pub fn LabelError(
    #[prop(optional)] class: Option<String>,
    #[prop(optional)] style: Option<String>,
    #[prop(optional)] children: Option<Children>,
    #[prop(optional)] error: Option<String>,
    #[prop(optional)] visible: Option<bool>,
) -> impl IntoView {
    let error = error.unwrap_or_default();
    let visible = visible.unwrap_or(false);

    let class = merge_classes(vec!["label-error"]);

    view! {
        <div class=class style=style aria-live="polite">
            {if visible { error } else { "".to_string() }}
            {children.map(|c| c())}
        </div>
    }
}

/// Label Group component
#[component]
pub fn LabelGroup(
    #[prop(optional)] class: Option<String>,
    #[prop(optional)] style: Option<String>,
    #[prop(optional)] children: Option<Children>,
    #[prop(optional)] orientation: Option<LabelOrientation>,
    #[prop(optional)] spacing: Option<LabelSpacing>,
) -> impl IntoView {
    let orientation = orientation.unwrap_or_default();
    let spacing = spacing.unwrap_or_default();

    let class = merge_classes(vec![
        "label-group",
        &orientation.to_class(),
        &spacing.to_class(),
        class.as_deref().unwrap_or(""),
    ]);

    view! {
        <div
            class=class
            style=style
            role="group"
            aria-label="Label group"
            data-orientation=orientation.to_string()
            data-spacing=spacing.to_string()
        >
            {children.map(|c| c())}
        </div>
    }
}

/// Label Size enum
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum LabelSize {
    #[default]
    Small,
    Medium,
    Large,
}

impl LabelSize {
    pub fn to_class(&self) -> &'static str {
        match self {
            LabelSize::Small => "size-small",
            LabelSize::Medium => "size-medium",
            LabelSize::Large => "size-large",
        }
    }

    pub fn to_string(&self) -> &'static str {
        match self {
            LabelSize::Small => "small",
            LabelSize::Medium => "medium",
            LabelSize::Large => "large",
        }
    }
}

/// Label Variant enum
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum LabelVariant {
    #[default]
    Default,
    Primary,
    Secondary,
    Success,
    Warning,
    Error,
}

impl LabelVariant {
    pub fn to_class(&self) -> &'static str {
        match self {
            LabelVariant::Default => "variant-default",
            LabelVariant::Primary => "variant-primary",
            LabelVariant::Secondary => "variant-secondary",
            LabelVariant::Success => "variant-success",
            LabelVariant::Warning => "variant-warning",
            LabelVariant::Error => "variant-error",
        }
    }

    pub fn to_string(&self) -> &'static str {
        match self {
            LabelVariant::Default => "default",
            LabelVariant::Primary => "primary",
            LabelVariant::Secondary => "secondary",
            LabelVariant::Success => "success",
            LabelVariant::Warning => "warning",
            LabelVariant::Error => "error",
        }
    }
}

/// Label Orientation enum
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum LabelOrientation {
    #[default]
    Horizontal,
    Vertical,
}

impl LabelOrientation {
    pub fn to_class(&self) -> &'static str {
        match self {
            LabelOrientation::Horizontal => "orientation-horizontal",
            LabelOrientation::Vertical => "orientation-vertical",
        }
    }

    pub fn to_string(&self) -> &'static str {
        match self {
            LabelOrientation::Horizontal => "horizontal",
            LabelOrientation::Vertical => "vertical",
        }
    }
}

/// Label Spacing enum
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum LabelSpacing {
    #[default]
    Tight,
    Normal,
    Loose,
}

impl LabelSpacing {
    pub fn to_class(&self) -> &'static str {
        match self {
            LabelSpacing::Tight => "spacing-tight",
            LabelSpacing::Normal => "spacing-normal",
            LabelSpacing::Loose => "spacing-loose",
        }
    }

    pub fn to_string(&self) -> &'static str {
        match self {
            LabelSpacing::Tight => "tight",
            LabelSpacing::Normal => "normal",
            LabelSpacing::Loose => "loose",
        }
    }
}

#[cfg(test)]
mod tests {
    use proptest::prelude::*;
    use wasm_bindgen_test::*;

    wasm_bindgen_test_configure!(run_in_browser);

    // Unit Tests
    #[test]
    fn test_label_creation() {}
    #[test]
    fn test_label_with_class() {}
    #[test]
    fn test_label_with_style() {}
    #[test]
    fn test_label_for_id() {}
    #[test]
    fn test_labelrequired() {}
    #[test]
    fn test_labeldisabled() {}
    #[test]
    fn test_label_size() {}
    #[test]
    fn test_label_variant() {}
    #[test]
    fn test_label_on_click() {}

    // Label Text tests
    #[test]
    fn test_label_text_creation() {}
    #[test]
    fn test_label_text_with_class() {}
    #[test]
    fn test_label_text_text() {}
    #[test]
    fn test_label_textrequired() {}

    // Label Description tests
    #[test]
    fn test_label_description_creation() {}
    #[test]
    fn test_label_description_with_class() {}
    #[test]
    fn test_label_description_description() {}

    // Label Error tests
    #[test]
    fn test_label_error_creation() {}
    #[test]
    fn test_label_error_with_class() {}
    #[test]
    fn test_label_error_error() {}
    #[test]
    fn test_label_errorvisible() {}

    // Label Group tests
    #[test]
    fn test_label_group_creation() {}
    #[test]
    fn test_label_group_with_class() {}
    #[test]
    fn test_label_group_orientation() {}
    #[test]
    fn test_label_group_spacing() {}

    // Label Size tests
    #[test]
    fn test_label_size_default() {}
    #[test]
    fn test_label_size_small() {}
    #[test]
    fn test_label_size_medium() {}
    #[test]
    fn test_label_size_large() {}

    // Label Variant tests
    #[test]
    fn test_label_variant_default() {}
    #[test]
    fn test_label_variant_primary() {}
    #[test]
    fn test_label_variant_secondary() {}
    #[test]
    fn test_label_variant_success() {}
    #[test]
    fn test_label_variant_warning() {}
    #[test]
    fn test_label_variant_error() {}

    // Label Orientation tests
    #[test]
    fn test_label_orientation_default() {}
    #[test]
    fn test_label_orientation_horizontal() {}
    #[test]
    fn test_label_orientation_vertical() {}

    // Label Spacing tests
    #[test]
    fn test_label_spacing_default() {}
    #[test]
    fn test_label_spacing_tight() {}
    #[test]
    fn test_label_spacing_normal() {}
    #[test]
    fn test_label_spacing_loose() {}

    // Helper function tests
    #[test]
    fn test_merge_classes_empty() {}
    #[test]
    fn test_merge_classes_single() {}
    #[test]
    fn test_merge_classes_multiple() {}
    #[test]
    fn test_merge_classes_with_empty() {}

    // Property-based Tests
    #[test]
    fn test_label_property_based() {
        proptest!(|(____class in ".*", __style in ".*")| {

        });
    }

    #[test]
    fn test_label_accessibility_validation() {
        proptest!(|(__for_id in ".*", _required: bool, _disabled: bool)| {

        });
    }

    #[test]
    fn test_label_variant_validation() {
        proptest!(|(____variant in ".*")| {

        });
    }

    // Integration Tests
    #[test]
    fn test_label_accessibility() {}
    #[test]
    fn test_label_form_integration() {}
    #[test]
    fn test_label_validation_workflow() {}
    #[test]
    fn test_label_error_display() {}
    #[test]
    fn test_label_responsive_behavior() {}

    // Performance Tests
    #[test]
    fn test_label_large_forms() {}
    #[test]
    fn test_label_render_performance() {}
    #[test]
    fn test_label_memory_usage() {}
    #[test]
    fn test_label_validation_performance() {}
}