Label

Label is the default control for read-only text. It participates in measurement, supports Dynamic Type, and can render either one plain string or a list of styled spans.

var heading = new Label
{
    Text = "Recent projects",
    TextStyle = TextStyle.Title2,
    FontWeight = FontWeight.Bold,
    MaxLines = 2
};

Set TextStyle when the text should follow a platform typography role. Set FontSize for a fixed point size; an explicit size overrides TextStyle. FontWeight and FontDesign adjust the system font, while the Bold property is a bindable shorthand for bold versus regular weight.

MaxFontSize places an upper bound on Dynamic Type scaling. Leave it unset unless the surrounding layout truly cannot accommodate the largest accessibility sizes.

Wrapping and fitting

MaxLines is zero by default, allowing the label to wrap freely. Positive values limit the line count. Truncation controls where overflowing text is shortened, and AutoShrink sets the smallest permitted scale factor for a single constrained line:

new Label
{
    Text = account.DisplayName,
    MaxLines = 1,
    Truncation = Truncation.Middle,
    AutoShrink = 0.8
};

Prefer wrapping over shrinking for body copy. Shrinking is most useful for compact identifiers, counters, and other short text that must remain on one line.

TextAlignment, LineSpacing, and LetterSpacing control paragraph appearance. Underline and Strikethrough apply to the whole plain string.

Styled spans

Set Spans when a sentence needs mixed emphasis. Spans override Text while the list contains items:

new Label
{
    TextStyle = TextStyle.Body,
    Spans =
    [
        new Span("Storage: "),
        new Span("12.4 GB")
        {
            FontWeight = FontWeight.Semibold,
            TextColor = Colors.Blue
        },
        new Span(" used") { TextColor = Colors.SecondaryLabel }
    ]
};

Use TextView instead when spans need selectable text or tappable links. The TextView guide covers link commands, selection, and live span collections.