Struct TextArea 

pub struct TextArea { /* private fields */ }

A multi-line text editor widget

Example

use revue::prelude::*;

let mut editor = TextArea::new()
    .content("Hello, World!\nLine 2")
    .line_numbers(true)
    .wrap(true);

// Handle key events
editor.handle_key(&Key::Char('a'));

Keyboard Shortcuts

Key	Action
Char	Insert character at cursor
Enter	Insert newline
Tab	Insert tab (rendered as spaces based on tab_width)
Backspace	Delete character before cursor (or merge with previous line)
Delete	Delete character at cursor (or merge with next line)
Left	Move cursor left (clears selection)
Right	Move cursor right (clears selection)
Up	Move cursor up one line (clears selection)
Down	Move cursor down one line (clears selection)
Home	Move cursor to start of line (clears selection)
End	Move cursor to end of line (clears selection)
PageUp	Move cursor up 10 lines
PageDown	Move cursor down 10 lines

Implementations

impl TextArea

pub fn get_syntax_language(&self) -> Language

Get the current highlighting language

pub fn set_language(&mut self, language: Language)

Set the syntax highlighting language

pub fn get_content(&self) -> String

Get the current text content

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

Set the text content

pub fn line_count(&self) -> usize

Get the number of lines

pub fn cursor_position(&self) -> (usize, usize)

Get the cursor position (primary cursor for backward compatibility)

pub fn cursor_positions(&self) -> Vec<(usize, usize)>

Get all cursor positions

pub fn cursor_count(&self) -> usize

Get the number of cursors

pub fn set_cursor(&mut self, line: usize, col: usize)

Set the cursor position (primary cursor, clears secondary cursors)

pub fn get_selection(&self) -> Option<String>

Get selected text (from primary cursor)

pub fn delete_selection(&mut self)

Delete selected text (from primary cursor)

pub fn has_selection(&self) -> bool

Check if primary cursor has a selection

pub fn start_selection(&mut self)

Start selection at current cursor (primary)

pub fn clear_selection(&mut self)

Clear selection (all cursors)

impl TextArea

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

Insert a character at cursor

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

Insert a string at cursor

pub fn delete_char_before(&mut self)

Delete character before cursor (backspace)

pub fn delete_char_at(&mut self)

Delete character at cursor (delete key)

pub fn delete_line(&mut self)

Delete the current line

pub fn duplicate_line(&mut self)

Duplicate the current line

impl TextArea

pub fn open_find(&mut self)

Open find panel (Ctrl+F)

pub fn open_replace(&mut self)

Open replace panel (Ctrl+H)

pub fn close_find(&mut self)

Close find/replace panel

pub fn is_find_open(&self) -> bool

Check if find panel is open

pub fn find_state(&self) -> Option<&FindReplaceState>

Get find/replace state

pub fn set_find_query(&mut self, query: &str)

Set find query and refresh matches

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

Set replacement text

pub fn find_next(&mut self)

Find next match (F3)

pub fn find_previous(&mut self)

Find previous match (Shift+F3)

pub fn replace_current(&mut self)

Replace current match

pub fn replace_all(&mut self)

Replace all matches (Ctrl+Shift+H)

pub fn toggle_case_sensitive(&mut self)

Toggle case sensitivity

pub fn toggle_whole_word(&mut self)

Toggle whole word matching

pub fn toggle_regex(&mut self)

Toggle regex mode

impl TextArea

pub fn add_cursor_at(&mut self, line: usize, col: usize)

Add cursor at position (Alt+Click)

pub fn add_cursor_above(&mut self)

Add cursor above current (Ctrl+Alt+Up)

pub fn add_cursor_below(&mut self)

Add cursor below current (Ctrl+Alt+Down)

pub fn clear_secondary_cursors(&mut self)

Clear all secondary cursors (Escape)

pub fn select_next_occurrence(&mut self)

Select next occurrence of current word/selection (Ctrl+D)

impl TextArea

pub fn move_left(&mut self)

Move cursor left

pub fn move_right(&mut self)

Move cursor right

pub fn move_up(&mut self)

Move cursor up

pub fn move_down(&mut self)

Move cursor down

pub fn move_home(&mut self)

Move to start of line

pub fn move_end(&mut self)

Move to end of line

pub fn move_document_start(&mut self)

Move to start of document

pub fn move_document_end(&mut self)

Move to end of document

pub fn move_word_left(&mut self)

Move cursor by word to the left

pub fn move_word_right(&mut self)

Move cursor by word to the right

pub fn page_up(&mut self, page_size: usize)

Page up

pub fn page_down(&mut self, page_size: usize)

Page down

pub fn select_all(&mut self)

Select all text

impl TextArea

pub fn undo(&mut self)

Undo the last operation

pub fn redo(&mut self)

Redo the last undone operation

impl TextArea

pub fn new() -> Self

Create a new empty text area

pub fn editor() -> Self

Create a TextArea pre-configured as a code editor with line numbers

pub fn content(self, text: impl Into<String>) -> Self

Set initial content

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

Show/hide line numbers

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

Enable/disable word wrap

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

Set read-only mode

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

Set focused state

pub fn tab_width(self, width: usize) -> Self

Set tab width

pub fn placeholder(self, text: impl Into<String>) -> Self

Set placeholder text

pub fn max_lines(self, max: usize) -> Self

Set maximum lines (0 = unlimited)

pub fn min_height(self, height: u16) -> Self

Set minimum height in rows (0 = no constraint)

Defaults to 3. This prevents the TextArea from collapsing to zero height when used as an auto-sized child in a flex/stack layout.

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

Set text color

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

Set background color

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

Set cursor color

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

Set selection background color

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

Set line number color

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

Set match highlight background color

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

Set current match highlight background color

pub fn syntax(self, language: Language) -> Self

Enable syntax highlighting for a language

pub fn syntax_with_theme(self, language: Language, theme: SyntaxTheme) -> Self

Enable syntax highlighting with a custom theme

pub fn handle_key(&mut self, key: &Key) -> bool

Handle key event

impl TextArea

pub fn element_id(self, id: impl Into<String>) -> Self

Set element ID for CSS selector (#id)

pub fn class(self, class: impl Into<String>) -> Self

Add a CSS class

pub fn classes<I, S>(self, classes: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Add multiple CSS classes

Trait Implementations

impl Default for TextArea

fn default() -> Self

Returns the “default value” for a type.

impl StyledView for TextArea

fn set_id(&mut self, id: impl Into<String>)

Set element ID

fn add_class(&mut self, class: impl Into<String>)

Add a CSS class

fn remove_class(&mut self, class: &str)

Remove a CSS class

fn toggle_class(&mut self, class: &str)

Toggle a CSS class

fn has_class(&self, class: &str) -> bool

Check if has class

impl View for TextArea

fn id(&self) -> Option<&str>

Get element ID (for CSS #id selectors)

fn classes(&self) -> &[String]

Get CSS classes (for CSS .class selectors)

fn meta(&self) -> WidgetMeta

Get widget metadata for DOM

fn render(&self, ctx: &mut RenderContext<'_>)

Render the view to the given context

fn widget_type(&self) -> &'static str

Get widget type name (for CSS type selectors)

fn children(&self) -> &[Box<dyn View>]

Get child views (for container widgets)