Baseline alignment

Text in a row sits on its baseline (the line the letters stand on) rather than in the middle of whatever box happens to contain it.

Baseline alignment keeps labels and controls aligned when their font sizes or internal padding differ. Use it for a value beside a unit, or a label beside an input.

// Baseline-aligned by default: the label meets the field's inset text.
labeled(res::str::quantity(), text_field(qty))

// The explicit opt-in for an ordinary row.
row((label(res::str::total()), label(res::str::sample_total()).font(Font::Title2), label(res::str::usd()).font(Font::Caption)))
    .align(VAlign::FirstBaseline)

The UI snippets use generated res::str accessors from an app’s Fluent catalog; see the example messages and catalog setup.

Alignment behavior

Day uses each child’s first text baseline. A child without a text baseline, such as an image or slider, is centered vertically instead. The measurement accounts for the child’s allocated height, including controls that center their text within a larger frame.

Toolkit implementations

toolkitsourceCap::BaselineAlignment
AppKitthe control’s font, centered in its alignmentRectInsets boxNative
GTKgtk_widget_measure’s natural-baseline out-paramNative
AndroidView.getBaseline()Native
UIKitderived: the view’s font ascent, centered in its heightEmulated
Qtderived: QFontMetricsF::ascent(), centered in its heightEmulated
Webderived: canvas TextMetrics.fontBoundingBoxAscent, offset by the element’s border and paddingEmulated
WinUITextBlock.BaselineOffset; font-derived for templated controlsEmulated
ArkUIderived from NODE_FONT_SIZEEmulated

Native and Emulated describe how the toolkit obtains the measurement. Derived baselines can be less accurate for custom controls with unusual internal text placement. Unsupported controls fall back to vertical centering.

Containers and decorators

A container answers on behalf of its content, through Layout::baseline:

  • a row reports the line its children were aligned to;
  • a column reports its first baseline-bearing child’s, offset by where that child sits;
  • a labeled row reports the line its label and control now share, so a form row nested in another baseline-aligned row joins the same line;
  • every single-child wrapper (.width(), .frame(), .padding(), .grow(), .max_width(), .min_width(), .background()) forwards its child’s, offset by where it places it.

Grid cells are not baseline-aligned; grid_row(..).align(VAlign::FirstBaseline) reads as Center. See docs/grid.

Row height

A baseline-aligned row is as tall as the deepest baseline plus the deepest descent below one, which can exceed the height of its tallest child. Shifting a child down to meet the line can push it past where the tallest child ends, and a row measured at the tallest child’s height would clip it.