Skip to main content

Text

widget.Text displays static text. It word-wraps to fit its render width and supports vertical scrolling for content taller than its allocated region.

Basic usage​

t := widget.NewText("Hello, world!")

Builder options​

MethodDescription
.WithID(id string)Assign a stable ID for Canvas.GetValue lookup
.WithStyle(s latte.Style)Override the theme-supplied text style
.WithWordWrap(bool)Enable or disable word-wrap (default: off)
.WithScrollable(bool)Enable vertical scrolling (default: off)

Updating content​

t.SetText("New content here")
current := t.GetText()

Styling​

Style can be set at construction time or after:

// At construction:
t := widget.NewText("Centered heading").
    WithStyle(latte.Style{TextAlign: latte.AlignCenter, Bold: true})

// Or via the zero-value default and theme override:
t := widget.NewText("Body text")   // theme fills in latte.Text style

Word-wrap and scroll​

scrollable := widget.NewText(longContent).
    WithWordWrap(true).
    WithScrollable(true)

In a layout​

Text is a non-focusable display component. Wrap it in a flex child to let it fill available space:

vbox.AddFlexChild(widget.NewText(longContent), 1)

Title widget​

For a prominent heading with an optional horizontal rule beneath it, use widget.NewTitle instead:

heading := widget.NewTitle("My Application")

Title uses the theme's Accent token by default. To override:

heading := widget.NewTitle("My Application").
    WithStyle(latte.Style{FG: latte.ColorBrightCyan, Bold: true}).
    WithSeparator(true)

Title builder options​

MethodDescription
.WithStyle(s latte.Style)Override the default accent style
.WithSeparator(bool)Show/hide the horizontal rule below (default: on)
.WithID(id string)Assign a stable ID