Struct SingleLineInput 

pub struct SingleLineInput { /* private fields */ }

Implementations

impl SingleLineInput

pub fn new() -> Self

pub fn with_value(value: impl Into<String>) -> Self

pub fn value(&self) -> &str

pub fn is_empty(&self) -> bool

pub fn cursor_byte(&self) -> usize

Current cursor position as a byte offset.

pub fn last_caret_pos(&self) -> Option<(u16, u16)>

Caret screen position from the last render call, or None if the widget has not been rendered yet (or was rendered unfocused).

pub fn replace_range_bytes( &mut self, range: Range<usize>, new_text: &str, new_cursor_byte: usize, )

Overwrite a byte range of the value with new_text, then place the cursor at byte offset new_cursor_byte in the updated value. Used by the hashtag autocomplete to apply an AcceptAction. All three positions must be on char boundaries; the controller computes them off value so this holds in practice — checked via debug_assert.

pub fn set_value(&mut self, value: impl Into<String>)

Replace the value; cursor jumps to end.

pub fn clear(&mut self)

pub fn cursor_display_col(&self) -> usize

Display column to the left of the cursor — accounts for wide (CJK, emoji) characters via unicode-width. Use this for caret placement.

pub fn display_width(&self) -> usize

Total display width of the value — accounts for wide characters.

pub fn handle_key(&mut self, key: &KeyEvent) -> InputOutcome

pub fn render( &mut self, f: &mut Frame<'_>, rect: Rect, style: Style, value_offset_x: u16, focused: bool, )

Render the value text at rect using style. Caller is responsible for any surrounding chrome (borders, prompt prefix, validation glyphs). Place the terminal cursor when focused. value_offset_x is the display-column offset within rect where the value text starts (e.g. when the caller renders a “Find: “ prefix separately, pass its display width via UnicodeWidthStr::width).

pub fn render_line( &mut self, f: &mut Frame<'_>, rect: Rect, line: Line<'static>, base_style: Style, value_offset_x: u16, focused: bool, )

Like Self::render, but with a pre-styled line (e.g. the query highlighter’s output). The line must render the same text as the input’s value, so caret math stays valid.

Trait Implementations

impl Default for SingleLineInput

fn default() -> SingleLineInput

Returns the “default value” for a type.