pub struct Link<A = ()> { /* private fields */ }Expand description
An accessible external HTTP(S) link with a single composable child.
Use Link::with_label for the common text form, or Link::child for
icons and composed content. href always means an external system URL;
this widget deliberately has no generic action callback.
Invalid, empty, non-HTTP(S), or hostless URL text produces an inert link;
parse errors are intentionally not retained by the builder.
§Examples
use ailloli_ui_widgets::controls::Link;
let link: Link<()> = Link::with_label("Documentation").href("https://example.com/docs");
let _ = link;§Future routing gate
Internal navigation is intentionally unavailable until the framework owns a provider-neutral route type, navigation state, history semantics, deep-link policy, focus/accessibility behavior, and consumer tests. The intended future syntax is documentation only:
Link::with_label("Settings").route(Route::Settings)Implementations§
Source§impl<A: 'static> Link<A>
impl<A: 'static> Link<A>
Sourcepub fn height(self, value: impl Into<Length>) -> Self
pub fn height(self, value: impl Into<Length>) -> Self
Sets preferred height from a logical-pixel or length value.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().height(40.0);
let _ = widget;Sourcepub fn min_width(self, value: impl Into<Length>) -> Self
pub fn min_width(self, value: impl Into<Length>) -> Self
Sets the minimum width bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_width(40.0);
let _ = widget;Sourcepub fn max_width(self, value: impl Into<Length>) -> Self
pub fn max_width(self, value: impl Into<Length>) -> Self
Sets the maximum width bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_width(320.0);
let _ = widget;Sourcepub fn min_height(self, value: impl Into<Length>) -> Self
pub fn min_height(self, value: impl Into<Length>) -> Self
Sets the minimum height bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().min_height(24.0);
let _ = widget;Sourcepub fn max_height(self, value: impl Into<Length>) -> Self
pub fn max_height(self, value: impl Into<Length>) -> Self
Sets the maximum height bound.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().max_height(240.0);
let _ = widget;Sourcepub fn fill(self) -> Self
pub fn fill(self) -> Self
Sets both preferred axes to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill();
let _ = widget;Sourcepub fn fill_width(self) -> Self
pub fn fill_width(self) -> Self
Sets preferred width to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_width();
let _ = widget;Sourcepub fn fill_height(self) -> Self
pub fn fill_height(self) -> Self
Sets preferred height to parent fill.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().fill_height();
let _ = widget;Sourcepub fn margin(self, value: f32) -> Self
pub fn margin(self, value: f32) -> Self
Sets uniform outer margin in logical pixels.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().margin(8.0);
let _ = widget;Sourcepub fn padding(self, value: f32) -> Self
pub fn padding(self, value: f32) -> Self
Sets uniform inner padding in logical pixels.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().padding(8.0);
let _ = widget;Sourcepub fn flex_grow(self) -> Self
pub fn flex_grow(self) -> Self
Sets flex-grow weight to one.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow();
let _ = widget;Sourcepub fn flex_grow_by(self, value: f32) -> Self
pub fn flex_grow_by(self, value: f32) -> Self
Sets a dimensionless flex-grow weight.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_grow_by(2.0);
let _ = widget;Sourcepub fn flex_shrink(self, value: f32) -> Self
pub fn flex_shrink(self, value: f32) -> Self
Sets a dimensionless flex-shrink weight.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_shrink(1.0);
let _ = widget;Sourcepub fn flex_basis(self, value: impl Into<Length>) -> Self
pub fn flex_basis(self, value: impl Into<Length>) -> Self
Sets the preferred main-axis flex basis.
§Examples
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().flex_basis(80.0);
let _ = widget;Sourcepub fn align_self(self, value: AlignItems) -> Self
pub fn align_self(self, value: AlignItems) -> Self
Overrides cross-axis alignment for this flex item.
§Examples
use ailloli_ui_core::style::AlignItems;
use ailloli_ui_widgets::layout::Container;
let widget: Container<()> = Container::new().align_self(AlignItems::Center);
let _ = widget;Source§impl<A: 'static> Link<A>
impl<A: 'static> Link<A>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an empty, enabled link with no destination.
Until content with nonzero layout and a valid URL are supplied, the link is not focusable and uses the default cursor.
§Examples
use ailloli_ui_widgets::controls::Link;
let link: Link<()> = Link::new();
let _ = link;Sourcepub fn with_label(label: impl Into<String>) -> Self
pub fn with_label(label: impl Into<String>) -> Self
Creates a link whose sole child is an owned, unwrapped text label.
Empty text is accepted but normally lays out with zero width, leaving the link inert even after a URL is supplied.
§Examples
use ailloli_ui_widgets::controls::Link;
let link: Link<()> = Link::with_label("Website");
let _ = link;Sourcepub fn child(self, child: impl IntoView<A>) -> Self
pub fn child(self, child: impl IntoView<A>) -> Self
Replaces empty or label content with one composed child view.
LinkStyle::text does not affect composed children; the link still
supplies focus-ring and interaction behavior around their layout bounds.
§Examples
use ailloli_ui_widgets::controls::Link;
use ailloli_ui_widgets::text::Text;
let link = Link::<()>::new().child(Text::new("Website"));
let _ = link;Sourcepub fn href(self, href: impl AsRef<str>) -> Self
pub fn href(self, href: impl AsRef<str>) -> Self
Parses and replaces the external HTTP(S) destination.
Validation performs no network request. Invalid input silently clears the destination, so a later invalid call makes a previously valid link inert. The host-opening failure, if any, is non-fatal during activation.
§Examples
use ailloli_ui_widgets::controls::Link;
let valid: Link<()> = Link::with_label("Web").href("https://example.com");
let inert: Link<()> = valid.href("file:///tmp/not-allowed");
let _ = inert;Sourcepub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
pub fn disabled(self, disabled: impl Into<Binding<bool>>) -> Self
Sets a static or reactive disabled binding.
Disabled links do not activate, receive focus, or show a pointer cursor. Label content resolves through the disabled text state.
§Examples
use ailloli_ui_widgets::controls::Link;
let link: Link<()> = Link::with_label("Unavailable").disabled(true);
let _ = link;Sourcepub fn disabled_signal(self, disabled: Memo<bool>) -> Self
pub fn disabled_signal(self, disabled: Memo<bool>) -> Self
Convenience alias for Self::disabled with a reactive memo.
§Examples
use ailloli_ui_runtime::component::Memo;
use ailloli_ui_widgets::controls::Link;
let link: Link<()> = Link::with_label("Website").disabled_signal(Memo::new(|| false));
let _ = link;Sourcepub fn style(self, style: TextStyle) -> Self
pub fn style(self, style: TextStyle) -> Self
Replaces only the normal label text style.
Existing hover, pressed, and disabled overrides remain unchanged. Composed child content ignores this field.
§Examples
use ailloli_ui_core::{Color, FontId, TextStyle};
use ailloli_ui_widgets::controls::Link;
let link: Link<()> = Link::with_label("Docs")
.style(TextStyle::new(FontId::Ui, 16, Color::WHITE));
let _ = link;Sourcepub fn link_style(self, style: LinkStyle) -> Self
pub fn link_style(self, style: LinkStyle) -> Self
Replaces the complete label-state and focus-ring style.
§Examples
use ailloli_ui_widgets::controls::{Link, LinkStyle};
let link: Link<()> = Link::with_label("Docs").link_style(LinkStyle::default());
let _ = link;