Struct Text 

pub struct Text(/* private fields */);

A view that displays one or more lines of read-only text.

Text sizes itself to fit its content and never stretches to fill extra space. When the available width is limited, it wraps to multiple lines automatically. If both width and height are constrained, it truncates with “…” at the end.

Layout Behavior

• Sizing: Fits its content naturally, like a label
• In stacks: Takes only the space it needs, leaving room for siblings
• Wrapping: Automatically wraps when width is constrained via .frame()

Examples

// Simple text
text("Hello, World!")

// Styled text
text("Important").bold().title()

// Enable wrapping with fixed width
text("Long paragraph...").frame().width(200.0)

// Push text apart in a row
hstack((text("Name"), spacer(), text("Value")))

Implementations

impl Text

pub fn new(content: impl IntoComputed<StyledStr>) -> Self

Creates a new text component.

pub fn display<T: Display>(source: impl Signal<Output = T>) -> Self

Creates a text component from any type implementing Display.

This is a convenience method for creating text from values like numbers, booleans, or other displayable types.

pub fn format<T>( value: impl IntoComputed<T>, formatter: impl Formatter<T> + 'static, ) -> Self

Creates a text component using a custom formatter.

This allows for specialized formatting of values, such as locale-specific number or date formatting.

pub fn content(&self) -> Computed<StyledStr>

Returns the computed content of this text component.

This provides access to the reactive text content that will automatically update when the underlying data changes.

pub fn font(self, font: impl IntoSignal<Font>) -> Self

Sets the font for this text component.

This allows customizing the typography, including size, weight, style, and other font properties.

pub fn size(self, size: impl IntoSignal<f64>) -> Self

Sets the font size.

pub fn weight(self, weight: impl IntoSignal<FontWeight>) -> Self

Sets the font weight.

pub fn underline(self, underline: impl IntoSignal<bool>) -> Self

Applies an underline to the text.

pub fn foreground(self, color: impl Into<Color>) -> Self

Sets the foreground (text) color.

pub fn background_color(self, color: impl Into<Color>) -> Self

Sets the background color for the text.

pub fn bold(self) -> Self

Sets the font to bold.

pub fn italic(self, is_italic: impl Signal<Output = bool>) -> Self

Sets the italic style.

impl Text

pub fn body(self) -> Self

Sets the font to body style.

impl Text

pub fn title(self) -> Self

Sets the font to title style.

impl Text

pub fn headline(self) -> Self

Sets the font to headline style.

impl Text

pub fn subheadline(self) -> Self

Sets the font to subheadline style.

impl Text

pub fn caption(self) -> Self

Sets the font to caption style.

impl Text

pub fn footnote(self) -> Self

Sets the font to footnote style.

Trait Implementations

impl Clone for Text

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConfigurableView for Text

type Config = TextConfig

The configuration type associated with this view.

fn config(self) -> Self::Config

Returns the configuration for this view.

impl Debug for Text

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Text

fn default() -> Self

Returns the “default value” for a type.

impl<T> From<T> for Text

where T: IntoComputed<StyledStr>,

fn from(value: T) -> Self

Converts to this type from the input type.

impl From<TextConfig> for Text

fn from(value: TextConfig) -> Self

Converts to this type from the input type.

impl PartialEq for Text

fn eq(&self, _other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Text

fn partial_cmp(&self, _other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Signal for Text

type Output = Text

The type of value produced by this computation.

type Guard = ()

The guard type returned by the watch method that manages watcher lifecycle.

fn get(&self) -> Self::Output

Execute the computation and return the current value.

fn watch(&self, _watcher: impl Fn(Context<Self::Output>) + 'static)

Register a watcher to be notified when the computed value changes.

impl View for Text

fn body(self, env: &Environment) -> impl View

Build this view and return the content.