Struct TextInputOpts 

pub struct TextInputOpts<'a> {
    pub placeholder: Option<&'a str>,
    pub max_length: Option<usize>,
    pub mask: MaskMode,
}

Optional configuration for text_input_with / apply_event_with. The defaults reproduce text_input / apply_event verbatim, so callers only set the fields they need.

Fields mirror the corresponding HTML <input> attributes: placeholder, maxlength, type=password. The same value is expected to be available both at build-time (so the placeholder renders, the mask is applied) and at event-time (so max_length can clip a paste, and Copy / Cut can be suppressed on a masked field) — that joint availability is why this is a struct the app holds onto rather than chained modifiers on the returned El.

Fields

placeholder: Option<&'a str>

Muted hint text shown only while value is empty. Visible even while the field is focused (matches HTML <input placeholder>).

max_length: Option<usize>

Cap on the character count of value after an edit. Inserts (typing, paste, IME commit) are truncated so the post-edit length doesn’t exceed this. Existing values longer than the cap are left alone — the cap only constrains future inserts.

mask: MaskMode

Visual masking of the rendered value. See MaskMode.

Implementations

impl<'a> TextInputOpts<'a>

pub fn placeholder(self, p: &'a str) -> Self

Set the muted hint shown while the value is empty (see TextInputOpts::placeholder).

Examples found in repository

examples/dashboard_01_calibration.rs (line 204)

fn dashboard_header() -> El {
    row([
        icon_button("menu").ghost(),
        divider().width(Size::Fixed(1.0)).height(Size::Fixed(22.0)),
        h3("Documents").key("metric:page.title"),
        spacer(),
        text_input_with(
            "dashboard-search",
            "",
            &Selection::default(),
            TextInputOpts::default().placeholder("Search..."),
        )
        .key("metric:command.input")
        .width(Size::Fixed(260.0)),
        icon_button("plus").ghost(),
        icon_button("bell").ghost(),
    ])
    .key("metric:header")
    .gap(tokens::SPACE_3)
    .height(Size::Fixed(56.0))
    .padding(Sides::xy(tokens::SPACE_4, 0.0))
    .align(Align::Center)
    .stroke(tokens::BORDER)
}

pub fn max_length(self, n: usize) -> Self

Cap the character count of future edits (see TextInputOpts::max_length).

pub fn password(self) -> Self

Mask the rendered value as a password field (MaskMode::Password).

Trait Implementations

impl<'a> Clone for TextInputOpts<'a>

fn clone(&self) -> TextInputOpts<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for TextInputOpts<'a>

impl<'a> Debug for TextInputOpts<'a>

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

Formats the value using the given formatter.

impl<'a> Default for TextInputOpts<'a>

fn default() -> TextInputOpts<'a>

Returns the “default value” for a type.