Struct TextArea 

pub struct TextArea {
    pub buffer: TextBuffer,
    pub cursor: CursorState,
    pub undo_stack: UndoStack,
    pub scroll_offset: usize,
    pub show_line_numbers: bool,
    pub style: Style,
    pub cursor_style: Style,
    pub selection_style: Style,
    pub line_number_style: Style,
    /* private fields */
}

A multi-line text editing widget.

Supports cursor movement, text selection, undo/redo, soft wrapping, optional line numbers, and pluggable syntax highlighting.

Fields

buffer: TextBuffer

The text content.

cursor: CursorState

Cursor and selection state.

undo_stack: UndoStack

Undo/redo history.

scroll_offset: usize

Index of the first visible logical line.

show_line_numbers: bool

Whether to show line numbers in the left gutter.

style: Style

Base text style.

cursor_style: Style

Style for the cursor cell.

selection_style: Style

Style for selected text.

line_number_style: Style

Style for line numbers.

Implementations

impl TextArea

pub fn new() -> Self

Create a new empty text area.

pub fn from_text(text: &str) -> Self

Create a text area pre-filled with text.

pub fn with_highlighter(self, h: Box<dyn Highlighter>) -> Self

Set a custom syntax highlighter.

pub fn with_style(self, s: Style) -> Self

Set the base text style.

pub fn with_line_numbers(self, show: bool) -> Self

Enable or disable line numbers.

pub fn with_cursor_style(self, s: Style) -> Self

Set the cursor display style.

pub fn with_selection_style(self, s: Style) -> Self

Set the selection display style.

pub fn text(&self) -> String

Get the current text content as a string.

pub fn insert_char(&mut self, ch: char)

Insert a character at the cursor position.

pub fn insert_str(&mut self, text: &str)

Insert a string at the cursor position.

pub fn delete_backward(&mut self)

Delete the character before the cursor (backspace).

pub fn delete_forward(&mut self)

Delete the character at the cursor position (delete key).

pub fn delete_selection(&mut self) -> bool

Delete the currently selected text, if any.

Returns true if a selection was deleted.

pub fn new_line(&mut self)

Insert a newline at the cursor position.

pub fn undo(&mut self)

Undo the last operation.

pub fn redo(&mut self)

Redo the last undone operation.

pub fn ensure_cursor_visible(&mut self, area_height: u16)

Ensure the cursor is within the visible area, adjusting scroll.

Trait Implementations

impl Default for TextArea

fn default() -> Self

Returns the “default value” for a type.

impl InteractiveWidget for TextArea

fn handle_event(&mut self, event: &Event) -> EventResult

Handle an input event. Returns whether the event was consumed.

impl Widget for TextArea

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

Render this widget into the given area of the buffer.