PropertyRow

Layer: cell · Path: src/cells/property_row.rs · Exports: property_row::PropertyRow

An aligned inspector row in the Unity-style two-column layout: a fixed-width muted label on the left and an arbitrary control on the right. The control is supplied as a closure at show time, so any widget (numeric field, color field, switch, …) can sit in the value column while labels stay vertically aligned across rows.

Design

• Purpose / when to use — Inspector / property panels where many heterogeneous controls must share a single aligned label gutter.
• Anatomy — A horizontal layout: a label slot of fixed label_width × core::CONTROL_MD holding a muted Text, followed by the consumer-provided control.
• Variants / states — None of its own; visual state lives in the control closure.
• Tokens / layout consumed — layout::PROPERTY_LABEL_WIDTH (default label column = 120px), core::CONTROL_MD (32px label slot height, matching the standard control height). See layout tokens and tokens.
• Accessibility — Label and control are separate widgets; the alignment is purely visual.

API

Usage

#![allow(unused)]
fn main() {
use ouroboros_ui::cells::PropertyRow;
use ouroboros_ui::atoms::NumericField;

let mut mass = 1.0_f32;
PropertyRow::new("Mass").show(ui, |ui| NumericField::new(&mut mass).speed(0.05).show(ui));
}

#![allow(unused)]
fn main() {
// realistic — a column of aligned inspector rows
let mut vals = [1.0_f32, 0.05, 0.6];
for (i, name) in ["Mass", "Drag", "Bounce"].iter().enumerate() {
    PropertyRow::new(*name).show(ui, |ui| {
        NumericField::new(&mut vals[i]).speed(0.05).show(ui)
    });
}
}

Composition

Composes the Text atom for the label; the value column is whatever the caller’s closure adds. No painting of its own — it only allocates the label slot and delegates. Enforced by tests/no_painter_in_molecules.rs.

Notes

• The control closure must return a Response (e.g. the inner widget’s show(ui) result); PropertyRow::show forwards it.
• The label slot height is fixed at core::CONTROL_MD (32px), so controls taller than that will not vertically center against the label.
• Keep label_width consistent across rows in the same panel (use the default) so labels line up.