Struct TextInput 

pub struct TextInput {
    pub value: String,
    pub cursor: usize,
    pub history_id: Option<String>,
    pub history: Vec<String>,
    pub history_index: Option<usize>,
    pub history_temp: Option<String>,
    pub history_limit: usize,
    pub history_loaded: bool,
    /* private fields */
}

Single-line text input widget wrapping tui-textarea with history support

Fields

value: String

cursor: usize

history_id: Option<String>

history: Vec<String>

history_index: Option<usize>

history_temp: Option<String>

history_limit: usize

history_loaded: bool

Implementations

impl TextInput

pub fn new() -> Self

Create a new TextInput widget

pub fn with_style( self, text_color: Color, cursor_bg: Color, cursor_fg: Color, ) -> Self

Set all colors at once Note: cursor_bg and cursor_fg are deprecated - cursor colors are now automatically reversed

pub fn with_text_color(self, color: Color) -> Self

Set text color only

pub fn with_cursor_colors(self, bg: Color, fg: Color) -> Self

👎Deprecated: Cursor colors are now automatically reversed from text/background colors

Set cursor colors only (deprecated: cursor colors are now automatically reversed)

pub fn with_background(self, color: Color) -> Self

Set optional background color for input area

pub fn with_theme(self, theme: &Theme) -> Self

Convenience method to set colors from theme Cursor colors come from theme cursor_focused setting If cursor_focused is “default” (Color::Reset), uses REVERSED modifier (tui-textarea default)

pub fn with_history(self, history_id: String) -> Self

Enable history with the given ID

pub fn with_history_limit(self, limit: usize) -> Self

Set history limit

pub fn set_focused(&mut self, focused: bool)

Set focused state

pub fn value(&self) -> &str

Get the current value (single line)

pub fn set_value(&mut self, value: String)

Set the value

pub fn cursor(&self) -> usize

Get cursor position

pub fn set_cursor(&mut self, cursor: usize)

Set cursor position

pub fn load_history(&mut self, cache: &CacheManager) -> Result<()>

Load history from cache (lazy loading)

pub fn save_to_history(&mut self, cache: &CacheManager) -> Result<()>

Save current value to history

pub fn clear(&mut self)

Clear the input

pub fn is_empty(&self) -> bool

Check if input is empty

pub fn navigate_history_up(&mut self, cache: Option<&CacheManager>)

Navigate history up (older entries)

pub fn navigate_history_down(&mut self)

Navigate history down (newer entries)

pub fn handle_key( &mut self, event: &KeyEvent, cache: Option<&CacheManager>, ) -> TextInputEvent

Handle a key event

Trait Implementations

impl Default for TextInput

fn default() -> Self

Returns the “default value” for a type.

impl Widget for &TextInput

fn render(self, area: Rect, buf: &mut Buffer)

Draws the current state of the widget in the given buffer. That is the only method required to implement a custom widget.