Struct Form 

pub struct Form<Msg> { /* private fields */ }

A column of Fields that share one label layout, with an optional summary of problems above them.

Enter in a field whose control does not use it (a text input without on_submit) moves focus to the next field, and from the last field on to whatever follows the form, usually its submit button. The form does not validate: the application checks its values into FormErrors, passes each message to its field and, on submit, returns FormErrors::focus_first.

Style keys: form-summary (bg, padding), form-summary-title (fg, bold), form-summary-marker and form-summary-item (fg). The summary title is quvyta.form.summary with n problems; its marker is the error icon.

Implementations

impl<Msg: 'static> Form<Msg>

pub fn new() -> Self

A form with labels above controls and a row between fields.

pub fn label_width(self, cells: u16) -> Self

Puts every field’s label in a column cells wide beside its control while the form is wide enough; on narrow screens labels move above controls.

pub fn gap(self, rows: u16) -> Self

Rows between fields; 1 by default.

pub fn summary(self, errors: &FormErrors) -> Self

Lists every problem of errors above the fields. Nothing is shown while there are none.

pub fn show<'v>( self, ui: &'v mut View<'_, Msg>, build: impl FnOnce(&mut FormFields<'_, '_, Msg>), ) -> NodeMut<'v, Msg>

Adds the form to ui with the fields build adds.

Trait Implementations

impl<Msg: 'static> Default for Form<Msg>

fn default() -> Self

Returns the “default value” for a type.

impl<Msg: 'static> Widget<Msg> for Form<Msg>

fn measure(&self, cx: &mut MeasureCx<'_>, available: Size) -> Size

The size the widget wants when it may use up to available.

fn paint(&self, cx: &mut PaintCx<'_>, area: Rect)

Draws the widget into area.

fn event(&self, cx: &mut EventCx<'_, Msg>, event: &Event) -> bool

Handles input. Returns true when the event was used; unused key and scroll events bubble to the parent widget.

fn children(&self) -> &[Node<Msg>]

Child nodes, for widgets that contain other widgets.

fn children_mut(&mut self) -> &mut [Node<Msg>]

Mutable child nodes, used to assign ids.

fn paint_overlay(&self, _cx: &mut PaintCx<'_>, _anchor: Rect)

Draws the widget’s overlay after the whole view was painted, when it asked for one with PaintCx::request_overlay. anchor is the area the widget was painted in.

fn focusable(&self) -> bool

Whether the widget can take keyboard focus.