Struct TextInputState 

pub struct TextInputState {
    pub value: String,
    pub cursor: usize,
    pub placeholder: String,
    pub max_length: Option<usize>,
    pub validation_error: Option<String>,
    pub masked: bool,
}

State for a single-line text input widget.

Pass a mutable reference to Context::text_input each frame. The widget handles all keyboard events when focused.

Example

let mut input = TextInputState::with_placeholder("Type here...");
ui.text_input(&mut input);
println!("{}", input.value);

Fields

value: String

The current input text.

cursor: usize

Cursor position as a character index into value.

placeholder: String

Placeholder text shown when value is empty.

max_length: Option<usize>

Maximum character count. Input is rejected beyond this limit.

validation_error: Option<String>

The most recent validation error message, if any.

masked: bool

When true, input is displayed as • characters (for passwords).

Implementations

impl TextInputState

pub fn new() -> Self

Create an empty text input state.

pub fn with_placeholder(p: impl Into<String>) -> Self

Create a text input with placeholder text shown when the value is empty.

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

Set the maximum allowed character count.

pub fn validate(&mut self, validator: impl Fn(&str) -> Result<(), String>)

Validate the current value and store the latest error message.

Sets TextInputState::validation_error to None when validation succeeds, or to Some(error) when validation fails.

Trait Implementations

impl Default for TextInputState

fn default() -> Self

Returns the “default value” for a type.