Struct UiBuilder 

pub struct UiBuilder<T> { /* private fields */ }

The main fluent authoring surface: value.ui().px_2().w_full().into_element(cx).

Implementations

impl<T> UiBuilder<T>

pub fn new(inner: T) -> Self

pub fn semantics(self, decoration: SemanticsDecoration) -> Self

pub fn test_id(self, test_id: impl Into<Arc<str>>) -> Self

pub fn a11y_role(self, role: SemanticsRole) -> Self

pub fn role(self, role: SemanticsRole) -> Self

pub fn a11y_label(self, label: impl Into<Arc<str>>) -> Self

pub fn key_context(self, key_context: impl Into<Arc<str>>) -> Self

pub fn style(self, style: ChromeRefinement) -> Self

where T: UiSupportsChrome,

pub fn layout(self, layout: LayoutRefinement) -> Self

where T: UiSupportsLayout,

pub fn style_with( self, f: impl FnOnce(ChromeRefinement) -> ChromeRefinement, ) -> Self

where T: UiSupportsChrome,

pub fn layout_with( self, f: impl FnOnce(LayoutRefinement) -> LayoutRefinement, ) -> Self

where T: UiSupportsLayout,

impl UiBuilder<TextBox>

pub fn selectable(self, selectable: bool) -> Self

Enables or disables drag-to-select + edit.copy for this text element.

Notes:

• Keep this off by default for most UI labels to avoid gesture conflicts with pressable rows/buttons. Prefer a dedicated copy button in interactive surfaces.

pub fn selectable_on(self) -> Self

Convenience helper for selectable(true).

pub fn selectable_off(self) -> Self

Convenience helper for selectable(false).

pub fn text_xs(self) -> Self

pub fn text_sm(self) -> Self

pub fn text_base(self) -> Self

pub fn text_prose(self) -> Self

pub fn font_weight(self, weight: FontWeight) -> Self

pub fn font(self, font: FontId) -> Self

pub fn font_feature(self, tag: impl Into<String>, value: u32) -> Self

pub fn font_axis(self, tag: impl Into<String>, value: f32) -> Self

pub fn tabular_nums(self) -> Self

Enables OpenType tabular numbers (font-variant-numeric: tabular-nums).

pub fn proportional_nums(self) -> Self

Enables OpenType proportional numbers (font-variant-numeric: proportional-nums).

pub fn lining_nums(self) -> Self

Enables OpenType lining numbers (font-variant-numeric: lining-nums).

pub fn oldstyle_nums(self) -> Self

Enables OpenType oldstyle numbers (font-variant-numeric: oldstyle-nums).

pub fn slashed_zero(self) -> Self

Enables OpenType slashed zero (font-variant-numeric: slashed-zero).

pub fn ordinal(self) -> Self

Enables OpenType ordinal forms (font-variant-numeric: ordinal).

pub fn diagonal_fractions(self) -> Self

Enables OpenType diagonal fractions (font-variant-numeric: diagonal-fractions).

pub fn stacked_fractions(self) -> Self

Enables OpenType stacked fractions (font-variant-numeric: stacked-fractions).

pub fn font_ui(self) -> Self

pub fn font_monospace(self) -> Self

pub fn font_normal(self) -> Self

pub fn font_medium(self) -> Self

pub fn font_semibold(self) -> Self

pub fn font_bold(self) -> Self

pub fn text_color(self, color: ColorRef) -> Self

pub fn text_size_px(self, size: Px) -> Self

pub fn line_height_px(self, height: Px) -> Self

pub fn line_height_em(self, line_height_em: f32) -> Self

pub fn line_height_preset(self, preset: TextLineHeightPreset) -> Self

pub fn line_height_policy(self, policy: TextLineHeightPolicy) -> Self

pub fn control(self) -> Self

pub fn content(self) -> Self

pub fn fixed_line_box_px(self, height: Px) -> Self

Configures a fixed line box by setting both line_height_px(height) and h_px(height).

This is a pragmatic escape hatch for fixed-height controls (tabs, pills, buttons) where centering by glyph bounds can read as slightly bottom-heavy. A fixed line box allows the text widget to apply CSS/GPUI-like “half-leading” baseline placement.

pub fn letter_spacing_em(self, letter_spacing_em: f32) -> Self

pub fn wrap(self, wrap: TextWrap) -> Self

pub fn overflow(self, overflow: TextOverflow) -> Self

pub fn ink_overflow(self, ink_overflow: TextInkOverflow) -> Self

pub fn auto_pad_ink_overflow(self) -> Self

pub fn text_align(self, align: TextAlign) -> Self

pub fn nowrap(self) -> Self

pub fn truncate(self) -> Self

pub fn break_words(self) -> Self

Sets TextWrap::WordBreak and clips overflow.

This matches Tailwind’s break-words intent (prevent horizontal overflow by allowing breaks inside long tokens such as URLs, paths, and identifiers).

pub fn text_balance(self) -> Self

Enables balanced line breaking (Tailwind text-balance).

pub fn line_box_in_bounds(self) -> Self

Opt into “bounds-as-line-box” baseline placement for fixed-height controls.

This is intended for single-line labels that should look vertically centered inside a container whose height is larger than the natural line height.

impl UiBuilder<RawTextBox>

pub fn text_color(self, color: ColorRef) -> Self

pub fn wrap(self, wrap: TextWrap) -> Self

pub fn overflow(self, overflow: TextOverflow) -> Self

pub fn ink_overflow(self, ink_overflow: TextInkOverflow) -> Self

pub fn auto_pad_ink_overflow(self) -> Self

pub fn text_align(self, align: TextAlign) -> Self

pub fn nowrap(self) -> Self

pub fn truncate(self) -> Self

pub fn break_words(self) -> Self

Sets TextWrap::WordBreak and clips overflow.

This matches Tailwind’s break-words intent (prevent horizontal overflow by allowing breaks inside long tokens such as URLs, paths, and identifiers).

pub fn text_balance(self) -> Self

Enables balanced line breaking (Tailwind text-balance).

impl UiBuilder<RichTextBox>

pub fn text_style(self, style: TextStyle) -> Self

pub fn text_color(self, color: ColorRef) -> Self

pub fn wrap(self, wrap: TextWrap) -> Self

pub fn overflow(self, overflow: TextOverflow) -> Self

pub fn ink_overflow(self, ink_overflow: TextInkOverflow) -> Self

pub fn auto_pad_ink_overflow(self) -> Self

pub fn text_align(self, align: TextAlign) -> Self

pub fn nowrap(self) -> Self

pub fn truncate(self) -> Self

pub fn break_words(self) -> Self

pub fn text_balance(self) -> Self

impl<T: UiSupportsChrome> UiBuilder<T>

pub fn paddings(self, paddings: impl Into<Edges4<MetricRef>>) -> Self

pub fn paddings_fraction(self, paddings: impl Into<Edges4<f32>>) -> Self

pub fn paddings_percent(self, paddings: impl Into<Edges4<f32>>) -> Self

pub fn padding(self, padding: impl Into<MetricRef>) -> Self

pub fn padding_fraction(self, fraction: f32) -> Self

pub fn padding_percent(self, percent: f32) -> Self

pub fn padding_px(self, px: Px) -> Self

pub fn padding_space(self, space: Space) -> Self

pub fn focused_border(self) -> Self

pub fn corner_radii(self, radii: impl Into<Corners4<MetricRef>>) -> Self

pub fn rounded_tl(self, radius: Radius) -> Self

pub fn rounded_tr(self, radius: Radius) -> Self

pub fn rounded_br(self, radius: Radius) -> Self

pub fn rounded_bl(self, radius: Radius) -> Self

pub fn shadow_none(self) -> Self

pub fn shadow_xs(self) -> Self

pub fn shadow_sm(self) -> Self

pub fn shadow_md(self) -> Self

pub fn shadow_lg(self) -> Self

pub fn shadow_xl(self) -> Self

pub fn debug_border(self, color: ColorRef) -> Self

pub fn debug_border_primary(self) -> Self

pub fn debug_border_destructive(self) -> Self

pub fn debug_border_ring(self) -> Self

pub fn px(self, space: Space) -> Self

pub fn py(self, space: Space) -> Self

pub fn p(self, space: Space) -> Self

pub fn pt(self, space: Space) -> Self

pub fn pr(self, space: Space) -> Self

pub fn pb(self, space: Space) -> Self

pub fn pl(self, space: Space) -> Self

pub fn rounded(self, radius: Radius) -> Self

pub fn border_width(self, width: impl Into<MetricRef>) -> Self

pub fn radius(self, radius: impl Into<MetricRef>) -> Self

pub fn bg(self, color: ColorRef) -> Self

pub fn border_color(self, color: ColorRef) -> Self

pub fn text_color(self, color: ColorRef) -> Self

pub fn px_0(self) -> Self

pub fn px_1(self) -> Self

pub fn px_0p5(self) -> Self

pub fn px_1p5(self) -> Self

pub fn px_2(self) -> Self

pub fn px_2p5(self) -> Self

pub fn px_3(self) -> Self

pub fn px_4(self) -> Self

pub fn py_0(self) -> Self

pub fn py_1(self) -> Self

pub fn py_0p5(self) -> Self

pub fn py_1p5(self) -> Self

pub fn py_2(self) -> Self

pub fn py_2p5(self) -> Self

pub fn py_3(self) -> Self

pub fn py_4(self) -> Self

pub fn p_0(self) -> Self

pub fn p_1(self) -> Self

pub fn p_0p5(self) -> Self

pub fn p_1p5(self) -> Self

pub fn p_2(self) -> Self

pub fn p_2p5(self) -> Self

pub fn p_3(self) -> Self

pub fn p_4(self) -> Self

pub fn rounded_md(self) -> Self

pub fn border_1(self) -> Self

impl<T: UiSupportsLayout> UiBuilder<T>

pub fn insets(self, insets: impl Into<Edges4<SignedMetricRef>>) -> Self

pub fn margins(self, margins: impl Into<Edges4<MarginEdge>>) -> Self

pub fn aspect_ratio(self, ratio: f32) -> Self

pub fn inset(self, space: Space) -> Self

pub fn inset_px(self, px: Px) -> Self

pub fn top(self, space: Space) -> Self

pub fn top_px(self, px: Px) -> Self

pub fn top_neg(self, space: Space) -> Self

pub fn right(self, space: Space) -> Self

pub fn right_px(self, px: Px) -> Self

pub fn right_neg(self, space: Space) -> Self

pub fn bottom(self, space: Space) -> Self

pub fn bottom_px(self, px: Px) -> Self

pub fn bottom_neg(self, space: Space) -> Self

pub fn left(self, space: Space) -> Self

pub fn left_px(self, px: Px) -> Self

pub fn left_neg(self, space: Space) -> Self

pub fn m(self, space: Space) -> Self

pub fn m_px(self, px: Px) -> Self

pub fn m_neg(self, space: Space) -> Self

pub fn mx(self, space: Space) -> Self

pub fn mx_px(self, px: Px) -> Self

pub fn mx_neg(self, space: Space) -> Self

pub fn my(self, space: Space) -> Self

pub fn my_px(self, px: Px) -> Self

pub fn my_neg(self, space: Space) -> Self

pub fn mt(self, space: Space) -> Self

pub fn mt_px(self, px: Px) -> Self

pub fn mt_neg(self, space: Space) -> Self

pub fn mr(self, space: Space) -> Self

pub fn mr_px(self, px: Px) -> Self

pub fn mr_neg(self, space: Space) -> Self

pub fn mb(self, space: Space) -> Self

pub fn mb_px(self, px: Px) -> Self

pub fn mb_neg(self, space: Space) -> Self

pub fn ml(self, space: Space) -> Self

pub fn ml_px(self, px: Px) -> Self

pub fn ml_neg(self, space: Space) -> Self

pub fn min_w(self, width: impl Into<MetricRef>) -> Self

pub fn min_w_space(self, width: Space) -> Self

pub fn min_h(self, height: impl Into<MetricRef>) -> Self

pub fn min_h_space(self, height: Space) -> Self

pub fn w(self, width: LengthRefinement) -> Self

pub fn h(self, height: LengthRefinement) -> Self

pub fn w_px(self, width: impl Into<MetricRef>) -> Self

pub fn w_space(self, width: Space) -> Self

pub fn h_px(self, height: impl Into<MetricRef>) -> Self

pub fn h_space(self, height: Space) -> Self

pub fn max_w(self, width: impl Into<MetricRef>) -> Self

pub fn max_w_space(self, width: Space) -> Self

pub fn max_h(self, height: impl Into<MetricRef>) -> Self

pub fn max_h_space(self, height: Space) -> Self

pub fn basis(self, basis: LengthRefinement) -> Self

pub fn basis_px(self, basis: impl Into<MetricRef>) -> Self

pub fn flex_grow(self, grow: f32) -> Self

pub fn flex_shrink(self, shrink: f32) -> Self

pub fn align_self(self, align: CrossAlign) -> Self

pub fn justify_self(self, align: CrossAlign) -> Self

pub fn relative(self) -> Self

pub fn absolute(self) -> Self

pub fn overflow_hidden(self) -> Self

pub fn overflow_visible(self) -> Self

pub fn overflow_x_hidden(self) -> Self

pub fn overflow_y_hidden(self) -> Self

pub fn m_auto(self) -> Self

pub fn mx_auto(self) -> Self

pub fn my_auto(self) -> Self

pub fn mt_auto(self) -> Self

pub fn mr_auto(self) -> Self

pub fn mb_auto(self) -> Self

pub fn ml_auto(self) -> Self

pub fn min_w_0(self) -> Self

pub fn w_full(self) -> Self

pub fn h_full(self) -> Self

pub fn size_full(self) -> Self

pub fn basis_0(self) -> Self

pub fn flex_shrink_0(self) -> Self

pub fn flex_1(self) -> Self

pub fn flex_none(self) -> Self

pub fn self_start(self) -> Self

pub fn self_center(self) -> Self

pub fn self_end(self) -> Self

pub fn self_stretch(self) -> Self

pub fn justify_self_start(self) -> Self

pub fn justify_self_center(self) -> Self

pub fn justify_self_end(self) -> Self

pub fn justify_self_stretch(self) -> Self

pub fn w_0(self) -> Self

pub fn h_0(self) -> Self

pub fn min_h_0(self) -> Self

pub fn max_w_0(self) -> Self

pub fn max_h_0(self) -> Self

pub fn w_0p5(self) -> Self

pub fn h_0p5(self) -> Self

pub fn min_w_0p5(self) -> Self

pub fn min_h_0p5(self) -> Self

pub fn max_w_0p5(self) -> Self

pub fn max_h_0p5(self) -> Self

pub fn w_1(self) -> Self

pub fn h_1(self) -> Self

pub fn min_w_1(self) -> Self

pub fn min_h_1(self) -> Self

pub fn max_w_1(self) -> Self

pub fn max_h_1(self) -> Self

pub fn w_1p5(self) -> Self

pub fn h_1p5(self) -> Self

pub fn min_w_1p5(self) -> Self

pub fn min_h_1p5(self) -> Self

pub fn max_w_1p5(self) -> Self

pub fn max_h_1p5(self) -> Self

pub fn w_2(self) -> Self

pub fn h_2(self) -> Self

pub fn min_w_2(self) -> Self

pub fn min_h_2(self) -> Self

pub fn max_w_2(self) -> Self

pub fn max_h_2(self) -> Self

pub fn w_2p5(self) -> Self

pub fn h_2p5(self) -> Self

pub fn min_w_2p5(self) -> Self

pub fn min_h_2p5(self) -> Self

pub fn max_w_2p5(self) -> Self

pub fn max_h_2p5(self) -> Self

pub fn w_3(self) -> Self

pub fn h_3(self) -> Self

pub fn min_w_3(self) -> Self

pub fn min_h_3(self) -> Self

pub fn max_w_3(self) -> Self

pub fn max_h_3(self) -> Self

pub fn w_3p5(self) -> Self

pub fn h_3p5(self) -> Self

pub fn min_w_3p5(self) -> Self

pub fn min_h_3p5(self) -> Self

pub fn max_w_3p5(self) -> Self

pub fn max_h_3p5(self) -> Self

pub fn w_4(self) -> Self

pub fn h_4(self) -> Self

pub fn min_w_4(self) -> Self

pub fn min_h_4(self) -> Self

pub fn max_w_4(self) -> Self

pub fn max_h_4(self) -> Self

pub fn w_5(self) -> Self

pub fn h_5(self) -> Self

pub fn min_w_5(self) -> Self

pub fn min_h_5(self) -> Self

pub fn max_w_5(self) -> Self

pub fn max_h_5(self) -> Self

pub fn w_6(self) -> Self

pub fn h_6(self) -> Self

pub fn min_w_6(self) -> Self

pub fn min_h_6(self) -> Self

pub fn max_w_6(self) -> Self

pub fn max_h_6(self) -> Self

pub fn w_8(self) -> Self

pub fn h_8(self) -> Self

pub fn min_w_8(self) -> Self

pub fn min_h_8(self) -> Self

pub fn max_w_8(self) -> Self

pub fn max_h_8(self) -> Self

pub fn w_10(self) -> Self

pub fn h_10(self) -> Self

pub fn min_w_10(self) -> Self

pub fn min_h_10(self) -> Self

pub fn max_w_10(self) -> Self

pub fn max_h_10(self) -> Self

pub fn w_11(self) -> Self

pub fn h_11(self) -> Self

pub fn min_w_11(self) -> Self

pub fn min_h_11(self) -> Self

pub fn max_w_11(self) -> Self

pub fn max_h_11(self) -> Self

impl<T: UiPatchTarget> UiBuilder<T>

pub fn build(self) -> T

impl<H, F> UiBuilder<FlexBox<H, F>>

pub fn gap(self, gap: impl Into<MetricRef>) -> Self

pub fn gap_px(self, gap: Px) -> Self

pub fn gap_metric(self, gap: MetricRef) -> Self

pub fn gap_fraction(self, fraction: f32) -> Self

pub fn gap_percent(self, percent: f32) -> Self

pub fn gap_full(self) -> Self

pub fn justify(self, justify: Justify) -> Self

pub fn justify_start(self) -> Self

pub fn justify_center(self) -> Self

pub fn justify_end(self) -> Self

pub fn justify_between(self) -> Self

pub fn items(self, items: Items) -> Self

pub fn items_start(self) -> Self

pub fn items_center(self) -> Self

pub fn items_end(self) -> Self

pub fn items_stretch(self) -> Self

pub fn wrap(self) -> Self

pub fn no_wrap(self) -> Self

impl<H, B> UiBuilder<FlexBoxBuild<H, B>>

pub fn gap(self, gap: impl Into<MetricRef>) -> Self

pub fn gap_px(self, gap: Px) -> Self

pub fn gap_metric(self, gap: MetricRef) -> Self

pub fn gap_fraction(self, fraction: f32) -> Self

pub fn gap_percent(self, percent: f32) -> Self

pub fn gap_full(self) -> Self

pub fn justify(self, justify: Justify) -> Self

pub fn justify_start(self) -> Self

pub fn justify_center(self) -> Self

pub fn justify_end(self) -> Self

pub fn justify_between(self) -> Self

pub fn items(self, items: Items) -> Self

pub fn items_start(self) -> Self

pub fn items_center(self) -> Self

pub fn items_end(self) -> Self

pub fn items_stretch(self) -> Self

pub fn wrap(self) -> Self

pub fn no_wrap(self) -> Self

impl<H, F> UiBuilder<ScrollAreaBox<H, F>>

pub fn axis(self, axis: ScrollAxis) -> Self

pub fn show_scrollbar_x(self, show: bool) -> Self

pub fn show_scrollbar_y(self, show: bool) -> Self

pub fn show_scrollbars(self, x: bool, y: bool) -> Self

pub fn handle(self, handle: ScrollHandle) -> Self

impl<H, B> UiBuilder<ScrollAreaBoxBuild<H, B>>

pub fn axis(self, axis: ScrollAxis) -> Self

pub fn show_scrollbar_x(self, show: bool) -> Self

pub fn show_scrollbar_y(self, show: bool) -> Self

pub fn show_scrollbars(self, x: bool, y: bool) -> Self

pub fn handle(self, handle: ScrollHandle) -> Self

impl<T: UiPatchTarget> UiBuilder<T>

pub fn into_element<H: UiHost>( self, cx: &mut ElementContext<'_, H>, ) -> AnyElement

where T: IntoUiElement<H>,

impl<H: UiHost, B> UiBuilder<ContainerPropsBoxBuild<H, B>>

where B: FnOnce(&mut ElementContext<'_, H>, &mut Vec<AnyElement>),

pub fn into_element(self, cx: &mut ElementContext<'_, H>) -> AnyElement

impl<H: UiHost, F, I> UiBuilder<ContainerPropsBox<H, F>>

where F: FnOnce(&mut ElementContext<'_, H>) -> I, I: IntoIterator, I::Item: IntoUiElement<H>,

pub fn into_element(self, cx: &mut ElementContext<'_, H>) -> AnyElement

Trait Implementations

impl<T: Clone> Clone for UiBuilder<T>

fn clone(&self) -> UiBuilder<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for UiBuilder<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<H: UiHost, F, I> IntoUiElement<H> for UiBuilder<ContainerPropsBox<H, F>>

where F: FnOnce(&mut ElementContext<'_, H>) -> I, I: IntoIterator, I::Item: IntoUiElement<H>,

fn into_element(self, cx: &mut ElementContext<'_, H>) -> AnyElement

impl<H: UiHost, B> IntoUiElement<H> for UiBuilder<ContainerPropsBoxBuild<H, B>>

where B: FnOnce(&mut ElementContext<'_, H>, &mut Vec<AnyElement>),

fn into_element(self, cx: &mut ElementContext<'_, H>) -> AnyElement

impl<H: UiHost, T> IntoUiElement<H> for UiBuilder<T>

where T: UiPatchTarget + IntoUiElement<H>,

fn into_element(self, cx: &mut ElementContext<'_, H>) -> AnyElement