pub struct Tooltip<A = ()> { /* private fields */ }Expand description
A non-interactive text tooltip attached to one trigger view.
Text is mounted in the host’s retained popup overlay through
[PopupContent]. The trigger remains fully composable through
Tooltip::child. Tooltip content is hit-tested by the popup host for
correct z-order, but its non-interactive semantics never consume pointer
input or enter focus traversal.
Hover opens after 500 ms and closes after a 100 ms grace period. Keyboard
focus opens immediately; blur and Escape close immediately. Delays can be
customized with Tooltip::open_delay and Tooltip::close_delay.
Empty content, missing/zero-sized triggers, and disabled state make the
tooltip unavailable and close any mounted popup.
§Examples
use ailloli_ui_widgets::controls::{Button, Tooltip};
let tooltip = Tooltip::with_label("Save changes")
.child(Button::<()>::with_label("Save"));
let _ = tooltip;Implementations§
Source§impl<A: 'static> Tooltip<A>
impl<A: 'static> Tooltip<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> Tooltip<A>
impl<A: 'static> Tooltip<A>
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an empty tooltip. Add text with Self::content and a trigger
with Self::child.
Defaults are top/center placement, 500 ms hover-open delay, 100 ms hover-close grace, and a 6-logical-pixel gap.
§Examples
use ailloli_ui_widgets::controls::Tooltip;
let tooltip: Tooltip<()> = Tooltip::new();
let _ = tooltip;Sourcepub fn with_label(content: impl Into<Binding<String>>) -> Self
pub fn with_label(content: impl Into<Binding<String>>) -> Self
Creates a tooltip with retained text content.
A trigger must still be supplied with Self::child. Empty current
content makes the tooltip unavailable.
§Examples
use ailloli_ui_widgets::controls::Tooltip;
let tooltip: Tooltip<()> = Tooltip::with_label("Keyboard shortcut");
let _ = tooltip;Sourcepub fn content(self, content: impl Into<Binding<String>>) -> Self
pub fn content(self, content: impl Into<Binding<String>>) -> Self
Sets the text rendered in the retained popup bubble.
Static strings, Signal<String>, State<String>, and Memo<String> are
accepted through [Binding]. Arbitrary public view content remains
intentionally deferred while the shared portal already mounts this
specialized text subtree in the top-level overlay.
A later call replaces the previous binding. "" does not mount an empty
bubble; it disables and closes the tooltip until the binding is nonempty.
§Examples
use ailloli_ui_runtime::component::Memo;
use ailloli_ui_widgets::controls::Tooltip;
let tooltip: Tooltip<()> = Tooltip::new().content(Memo::new(|| "Help".to_string()));
let _ = tooltip;Sourcepub fn child(self, child: impl IntoView<A>) -> Self
pub fn child(self, child: impl IntoView<A>) -> Self
Sets or replaces the trigger view.
A trigger must resolve to nonzero width and height. Focusable children keep normal focus routing; the tooltip shell is only a fallback focus target for a non-focusable trigger.
§Examples
use ailloli_ui_widgets::controls::{Button, Tooltip};
let tooltip = Tooltip::with_label("Create").child(Button::<()>::with_label("New"));
let _ = tooltip;Sourcepub fn placement(self, placement: PopupPlacement) -> Self
pub fn placement(self, placement: PopupPlacement) -> Self
Sets the preferred side of the popup relative to its trigger.
When a window viewport is available, placement may flip and clamps to remain visible; headless fallback uses the requested placement directly.
§Examples
use ailloli_ui_widgets::controls::{PopupPlacement, Tooltip};
let tooltip: Tooltip<()> = Tooltip::with_label("Details").placement(PopupPlacement::Bottom);
let _ = tooltip;Sourcepub fn alignment(self, alignment: PopupAlignment) -> Self
pub fn alignment(self, alignment: PopupAlignment) -> Self
Sets popup alignment along the side selected by Self::placement.
§Examples
use ailloli_ui_widgets::controls::{PopupAlignment, Tooltip};
let tooltip: Tooltip<()> = Tooltip::with_label("Details").alignment(PopupAlignment::Start);
let _ = tooltip;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 state closes the popup, cancels pending phases, and removes the tooltip shell from focus traversal; it does not disable the child itself.
§Examples
use ailloli_ui_widgets::controls::Tooltip;
let tooltip: Tooltip<()> = Tooltip::with_label("Unavailable").disabled(true);
let _ = tooltip;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::Tooltip;
let tooltip: Tooltip<()> = Tooltip::with_label("Help").disabled_signal(Memo::new(|| false));
let _ = tooltip;Sourcepub fn open_delay(self, delay: Duration) -> Self
pub fn open_delay(self, delay: Duration) -> Self
Sets the hover-open delay.
Duration::ZERO opens on the same phase resolution without scheduling
a timer. Keyboard focus still opens immediately regardless of this value.
§Examples
use std::time::Duration;
use ailloli_ui_widgets::controls::Tooltip;
let tooltip: Tooltip<()> = Tooltip::with_label("Instant").open_delay(Duration::ZERO);
let _ = tooltip;Sourcepub fn close_delay(self, delay: Duration) -> Self
pub fn close_delay(self, delay: Duration) -> Self
Sets the grace period after hover leaves an already painted tooltip.
This delay does not apply to blur, Escape, disabling, empty content, or leaving during the opening phase. Zero closes on the same phase update.
§Examples
use std::time::Duration;
use ailloli_ui_widgets::controls::Tooltip;
let tooltip: Tooltip<()> =
Tooltip::with_label("Help").close_delay(Duration::from_millis(250));
let _ = tooltip;Sourcepub fn gap(self, gap: f32) -> Self
pub fn gap(self, gap: f32) -> Self
Sets trigger-to-popup separation in logical pixels, clamped to zero.
NaN is treated as zero.
§Examples
use ailloli_ui_widgets::controls::Tooltip;
let tooltip: Tooltip<()> = Tooltip::with_label("Help").gap(8.0);
let _ = tooltip;Sourcepub fn tooltip_style(self, style: TooltipStyle) -> Self
pub fn tooltip_style(self, style: TooltipStyle) -> Self
Replaces bubble colors, typography, padding, radius, and wrap width.
The maximum text width is clamped to zero when measured; padding and radius are otherwise accepted as-is.
§Examples
use ailloli_ui_widgets::controls::{Tooltip, TooltipStyle};
let tooltip: Tooltip<()> =
Tooltip::with_label("Help").tooltip_style(TooltipStyle::default());
let _ = tooltip;