Struct FormField 

pub struct FormField { /* private fields */ }

A label + input + help/error/success/warning wrapper for form layouts.

Note: FormField renders label/help/validation text around an opaque AnyElement child; it cannot retroactively restyle that child’s internal focus ring. When .error(...)/.success(...)/.warning(...) is set, pass a child that already reflects that state itself (e.g. TextInput::invalid(true), which already routes to focus_ring_error colors) — this is the caller’s responsibility, matching how TextInput’s own validation flags work.

Implementations

impl FormField

pub fn new(content: impl IntoElement) -> Self

pub fn label(self, label: impl Into<SharedString>) -> Self

pub fn help(self, help: impl Into<SharedString>) -> Self

pub fn error(self, error: impl Into<SharedString>) -> Self

pub fn success(self, success: impl Into<SharedString>) -> Self

Shows a success message with a check-circle icon below the field. Takes precedence over .help(...) but not .error(...)/.warning(...).

pub fn warning(self, warning: impl Into<SharedString>) -> Self

Shows a warning message with a warning icon below the field. Takes precedence over .help(...)/.success(...) but not .error(...).

Trait Implementations

impl Component for FormField

fn scope() -> ComponentScope

Returns the scope of the component.

fn description() -> Option<&'static str>

An optional description of the component.

fn preview(_window: &mut Window, _cx: &mut App) -> Option<AnyElement>

The component’s preview.

fn id() -> ComponentId

The component’s unique identifier.

fn status() -> ComponentStatus

The ready status of this component.

fn name() -> &'static str

The name of the component.

fn sort_name() -> &'static str

Returns a name that the component should be sorted by.

impl IntoElement for FormField

type Element = Component<FormField>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements Element.

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed AnyElement.

impl RenderOnce for FormField

fn render(self, _window: &mut Window, _cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to Render::render() method which takes a mutable reference.