Struct Text

pub struct Text {
    pub content: String,
    pub size: Length,
    pub color: Color,
    pub align: TextAlign,
    pub wrap: bool,
    pub truncate: bool,
    pub font: Option<(String, u16, FontStyle)>,
}

Fields

content: String

size: Length

Font size as a Length. Resolved against the surface’s logical viewport at layout time, so a Length::Vmin( 5.0 ) heading scales with the screen instead of being frozen at a px constant.

color: Color

align: TextAlign

wrap: bool

truncate: bool

When true (default), overflowing single-line text is truncated with an ellipsis. When false, the full string is painted even if it extends past the layout rect — useful for very short labels (calendar day numbers, day-of-week stubs) where a couple of pixels of overflow is invisible but “…” is noisy.

font: Option<(String, u16, FontStyle)>

Optional (family, weight, style) override resolved through the active theme’s font registry on every draw. None keeps the canvas default font (Sora Regular in ltk-theme-default).

Implementations

impl Text

pub fn new(content: impl Into<String>) -> Self

pub fn no_truncate(self) -> Self

pub fn font( self, family: impl Into<String>, weight: u16, style: FontStyle, ) -> Self

Set a (family, weight, style) override for this text node. The triple is resolved through Canvas::font_for at draw time, so missing weights fall through the registry’s nearest- match precedence.

pub fn weight(self, weight: u16) -> Self

Shorthand for Self::font when the desired override is just a weight on the default Sora family (the family ltk-theme- default declares).

pub fn size(self, s: impl Into<Length>) -> Self

pub fn color(self, c: Color) -> Self

pub fn align(self, a: TextAlign) -> Self

pub fn align_center(self) -> Self

pub fn wrap(self, w: bool) -> Self

Enable word-wrapping. With wrap = true the text breaks on whitespace at max_width and the widget reports the natural height of all the resulting lines. With wrap = false (the default) the text stays on one line and is truncated with an ellipsis when it overflows.

pub fn preferred_size(&self, max_width: f32, canvas: &Canvas) -> (f32, f32)

pub fn draw(&self, canvas: &mut Canvas, rect: Rect, _focused: bool)

Trait Implementations

impl<Msg: Clone + 'static> From<Text> for Element<Msg>

fn from(t: Text) -> Self

Converts to this type from the input type.