Link

Link preview

Link — a clickable text label rendered as underlined inline text.

Public functions

`Link`

Returns	Function
	Constructors
`Self`	`new(text: impl Into<LocalizedString>)`
	Builder methods
`Self`	`visited(visited: impl Into<Prop<bool>>)`
`Self`	`style(style: impl teksilo_core::styles::LinkStyle)`
`Self`	`on_activate_fn(f: impl Fn(&mut EventContext) + 'static)`
`Self`	`url(url: impl Into<String>)`
`Self`	`tooltip(text: impl Into<LocalizedString>)`
`Self`	`rich_tooltip(key: impl Into<String>)`
`Self`	`rich_tooltip_content(content: crate::tooltip::TooltipContent)`
`Self`	`composite_tooltip(content: impl teksilo_core::widget::Widget + 'static)`
`Self`	`enabled(enabled: impl Into<Prop<bool>>)`
	Methods
`Option<&str>`	`get_url()`

Link is Teksilo's hyperlink control: it responds to tap, Enter, and Space like a Button, but renders as styled underlined text rather than a bordered box. It supports an optional url field (informational — the app decides whether and how to open it), a reactive visited state that shifts the text colour, and all three tooltip tiers (plain / rich / composite).

Keyboard behaviour follows the platform link convention: Space and Enter activate; a bare KeyUp with no preceding KeyDown is ignored (lone-KeyUp guard). The focus ring appears only after keyboard navigation (focus_visible), not after a mouse click.

Accessibility

Role::Link with the label as the AT name. When url is set it is forwarded to set_url so screen readers can announce the destination. Exposes Action::Click and Action::Focus.

#![allow(unused)]
fn main() {
use teksilo_widgets::Link;
use teksilo_i18n::lit;
let _w = Link::new(lit!("Open documentation"))
    .url("https://example.com/docs");
}

Touch and pen

The pressed state is the framework's (docs/touch-and-pen.md §7.1), so it survives a slide-off and comes back on re-entry, and a pan claimant winning the press clears it with no release. Following the link lands on the release, as it always did.

A link is text-height, so it can fall under the 24 dp target floor. What carries it is WCAG 2.2 SC 2.5.8's inline exception — the target's size is constrained by the line height of the text it is set in — and not the miss-only slop pass, which this module used to claim as well. The pass re-attributes a near miss only where the exact hit's whole bubble path carries no eligible handler, so it is denied wherever the link sits inside a row that takes presses: a link in a list row, a link in an archived notification. Measured by the target-conformance gate (the teksilo-target-conformance crate): 112 × 17 dp beside a tappable row label and 32 × 17 dp as a notification's replay action both reach exactly their own 17 dp on the short axis, at all three densities.

Density

The picture above is the widget at TargetDensity::Compact, the mouse-and-keyboard ladder. Below is the same subject on the same canvas with only the ladder changed, so what moves is the density and nothing else — where the subject no longer fits, that is what the denser targets cost it at that size. See docs/density-and-targets.md.

Touch

Link at Touch density

API reference

📖 Full rustdoc API for this module

`pub struct Link`

Import: use teksilo::widgets::Link;

A clickable text link that renders as underlined inline text.

#![allow(unused)]
fn main() {
pub struct Link { /* fields */ }
}

Methods

`pub fn new(text: impl Into<LocalizedString>) -> Self`

Create a link with the given display text.

`pub fn visited(mut self, visited: impl Into<Prop<bool>>) -> Self`

Mark the link's target as visited. Drives TextRole::LinkVisited when no transient interaction (hover / press) is active. Visited is overridden by hover/press, following the web convention. The app owns the signal (typically backed by URL-history state).

`pub fn style(mut self, style: impl teksilo_core::styles::LinkStyle) -> Self`

Per-call style override for the link chrome.

`pub fn on_activate_fn(mut self, f: impl Fn(&mut EventContext) + 'static) -> Self`

Closure invoked on activation.

`pub fn url(mut self, url: impl Into<String>) -> Self`

Set a URL for the link (informational — not automatically opened).

`pub fn tooltip(mut self, text: impl Into<LocalizedString>) -> Self`

Attach a plain single-line tooltip shown after a hover delay. Mutually exclusive with rich_tooltip / composite_tooltip — last call wins.

`pub fn rich_tooltip(mut self, key: impl Into<String>) -> Self`

Attach a rich tooltip resolved from the app-wide tooltip registry. See Button::rich_tooltip.

Attach a rich tooltip driven by inline TooltipContent.

Attach a composite tooltip — third tier, hosting an arbitrary widget tree. See Button::composite_tooltip.

`pub fn get_url(&self) -> Option<&str>`

Return the URL previously set via url, if any.

`pub fn enabled(mut self, enabled: impl Into<Prop<bool>>) -> Self`

Set the enabled state, statically or reactively. Forwarded to the arena at build time — a bound Signal<bool> updates live as it changes.

Teksilo Documentation