waterui-internal 0.3.0

Internal implementation crate for WaterUI
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

//! Link component for `WaterUI`
//!
//! This module provides a Link component that displays clickable text that opens a URL.
//! Link is implemented as a Button with link style, using `robius-open` to open URLs.

use nami::Computed;
use nami::Signal;
use nami::signal::IntoComputed;
use waterui_controls::{
    IntoLabel,
    button::{ButtonStyle, button},
};
use waterui_core::{Environment, Str, View};

/// Opens a URL in the system's default browser/handler.
#[cfg(not(target_os = "espidf"))]
fn open_url(url: &str) {
    if let Err(e) = robius_open::Uri::new(url).open() {
        tracing::error!("Failed to open URL '{}': {:?}", url, e);
    }
}

/// Embedded targets have no default URL handler; opening is a no-op.
#[cfg(target_os = "espidf")]
fn open_url(_url: &str) {}

/// A tappable text link that opens a URL.
///
/// Link displays styled text that navigates to the specified URL when tapped.
/// Internally, Link uses a Button with `ButtonStyle::Link` styling.
///
/// # Layout Behavior
///
/// Link sizes itself to fit its label content and never stretches to fill extra space.
/// In a stack, it takes only the space it needs, just like Text.
///
/// # Examples
///
/// ```
/// use waterui::prelude::*;
///
/// // Create a simple link
/// let my_link = link("Visit website", "https://waterui.dev");
/// ```
#[derive(Debug)]
pub struct Link<Label> {
    label: Label,
    url: Computed<Str>,
}

impl<Label> Link<Label>
where
    Label: IntoLabel + 'static,
{
    /// Creates a new `Link` view with the specified label and URL.
    pub fn new(label: Label, url: impl IntoComputed<Str>) -> Self {
        Self {
            label,
            url: url.into_computed(),
        }
    }
}

impl<Label> View for Link<Label>
where
    Label: IntoLabel + 'static,
{
    fn body(self, _env: &Environment) -> impl View {
        let url = self.url;

        button(self.label).style(ButtonStyle::Link).action(move || {
            let url_str = url.get();
            open_url(&url_str);
        })
    }
}

/// Convenience constructor for building a `Link` view inline.
///
/// # Arguments
///
/// * `label` - The text or view to display as the link
/// * `url` - The URL to navigate to when the link is tapped
pub fn link<Label>(label: Label, url: impl IntoComputed<Str>) -> Link<Label>
where
    Label: IntoLabel + 'static,
{
    Link::new(label, url)
}