Struct Form 

pub struct Form {
    pub fields: Vec<Field>,
    pub focus: usize,
    pub kind: FormKind,
    pub entity_id: Option<String>,
}

A generic multi-field input form.

Fields

fields: Vec<Field>

focus: usize

Index of the currently focused field. Always < fields.len().

kind: FormKind

entity_id: Option<String>

Entity id for tag forms; None for all other kinds.

Implementations

impl Form

pub fn config_set(name: Editor, value: Editor) -> Self

Two-field form for the config set command.

pub fn report_params( from: Editor, to: Editor, chart: Editor, kind: ReportKind, ) -> Self

Three-field form for the reports activity/breakdown commands.

pub fn commodity_create(mode: EditMode) -> Self

Two-field form for commodity create (symbol required, name required).

pub fn commodity_convert(mode: EditMode) -> Self

Three-field form for commodity conversion: amount, from-commodity, to-commodity.

The two Select fields are empty on construction; call fetch_commodity_convert_form_options to populate them asynchronously.

pub fn account_create(mode: EditMode, parent_options: Vec<SelectOption>) -> Self

Two-field form for account create (name required, parent Select optional).

parent_options seeds the parent Select; include a leading (none) entry with empty id so “no parent” is the default.

pub fn transaction_create(mode: EditMode) -> Self

Three-field form for transaction create: date, note, splits.

pub fn transaction_edit(mode: EditMode, et: &EditableTransaction) -> Self

Three-field form for editing an existing transaction, pre-filled from et.

Each split row’s Selects start with a single-entry list holding the stored uuid as both id and label; after the async fetch_transaction_form_options reply arrives, set_account_options / set_commodity_options replace the lists while set_options_preserving_id keeps the stored selection.

pub fn account_tag(mode: EditMode, account_id: String) -> Self

Two-field form for set-account-tag: tag name (required) and value.

The account_id is stored in entity_id and used at validation time.

pub fn transaction_tag(mode: EditMode, transaction_id: String) -> Self

Two-field form for set-transaction-tag: tag name (required) and value.

The transaction_id is stored in entity_id and used at validation time.

pub fn cycle(&mut self, forward: bool)

Advance or retreat focus by one step, wrapping around.

pub fn focused_field_mut(&mut self) -> Option<&mut Field>

Mutable reference to the currently focused field, if any.

pub fn focused_editor_mut(&mut self) -> Option<&mut Editor>

Mutable reference to the inner Editor of the focused field.

Returns None when the form is empty or the focused widget is not Text, Amount, or Date (i.e. a Select or Splits).

pub fn focused_widget_kind(&self) -> Option<WidgetKind>

Widget kind of the focused field, or None when the form is empty.

pub fn focused_splits_sub_kind(&self) -> Option<WidgetKind>

When the focused field is a Splits widget, returns the kind of its focused sub-widget (for nested widget-first key routing).

pub fn focused_splits_boundary(&self) -> Option<(bool, bool)>

When the focused field is a Splits widget, returns (at_first_cell, at_last_cell) so the key layer can yield Tab/BackTab to the outer field cycle at the editor’s boundaries.

Trait Implementations

impl Debug for Form

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

Formats the value using the given formatter.