struct Text

Creates a text label.

A text with an onClick gets the theme's hover fill unless it is given one (or a hoverColor).

Where the glyphs sit when the node is wider than they are.

A label that states its own width — .frame(width:), a grid cell, a stack that stretches it — is a box with room left over, and until this existed the text was always jammed against the leading edge of it. The only way to centre one was .frame(width:alignment:), which is a different thing entirely: it wraps the text in a box it does not own, and that box is where the width, the background, the hover fill and the cursor then land, while onClick stays on the text inside. The control ends up hovering at one size and clicking at another.

So this is deliberately not a layout property. It moves the pen inside a node that already exists, and adds no node — which is what keeps a centred label the same click target as a leading one.

Both axes, and the same Alignment the frame takes, so moving a call site across is the same word in a different place. The default is .topLeading rather than .center, because top-leading is where a text's glyphs have always gone and every existing caller is drawn against that.

Colour of the glyphs.

Corner radius of the hover fill, in points.

nil → FontStore.default (global UI face).

Text colour meant for when the pointer is over the text.

Setting it makes the text a hover target and drops the default hover fill a clickable text gets; the glyphs themselves are not yet recoloured.

Row highlight under the pointer. Defaults to the theme's hover surface for clickable text, since an unclickable label highlighting on hover would be lying about being interactive.

Most lines shown before the text is cut off with an ellipsis, or nil for no limit. Values below 1 are treated as 1.

Closures break value equality (SwiftUI wart) — fine until Phase 5 skip-recompute.

Resolved face for measure (explicit or environment default).

The text shown. \n starts a new line.

Limits wrapped rows and truncates the final visible row with an ellipsis when additional content exists.