Struct TextInput 

pub struct TextInput<'a> { /* private fields */ }

A styled single-line text input.

let mut email = String::new();
ui.add(TextInput::new(&mut email).label("Email").hint("you@example.com"));

Ids, focus, and flash state

Flash animations, focus, and cursor state are keyed off the widget’s egui id. Without id_salt, the id is derived from egui’s auto-id counter, which is layout-dependent — if a sibling appears or disappears above this input between frames, the id shifts and any in-flight flash, focus, or cursor state is lost. Any input you flash via ResponseFlashExt should pin its id with id_salt.

Implementations

impl<'a> TextInput<'a>

pub fn new(text: &'a mut String) -> Self

Create a text input bound to text.

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

Show a label above the input.

pub fn hint(self, text: &'a str) -> Self

Show placeholder-style hint text when the field is empty.

pub fn dirty(self, dirty: bool) -> Self

Mark the input as having unsaved changes. Shows a sky-coloured accent bar down the left side.

pub fn password(self, password: bool) -> Self

Mask the text as a password field.

pub fn desired_width(self, width: f32) -> Self

Desired width (points) for the editor portion of the widget.

pub fn id_salt(self, id: impl Hash) -> Self

Supply a stable id salt. Useful when two inputs share the same label.

Trait Implementations

impl<'a> Debug for TextInput<'a>

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

Formats the value using the given formatter.

impl<'a> Widget for TextInput<'a>

fn ui(self, ui: &mut Ui) -> Response

Allocate space, interact, paint, and return a Response.