Struct TextAreaState 

pub struct TextAreaState { /* private fields */ }

State for a TextArea component.

Implementations

impl TextAreaState

pub fn has_selection(&self) -> bool

Returns true if there is an active text selection.

pub fn selection_positions(&self) -> Option<((usize, usize), (usize, usize))>

Returns the ordered selection positions as ((start_row, start_col), (end_row, end_col)).

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

Returns the selected text, or None if no selection.

pub fn clipboard(&self) -> &str

Returns the internal clipboard contents.

impl TextAreaState

pub fn new() -> Self

Creates a new empty textarea.

Example

use envision::component::TextAreaState;

let state = TextAreaState::new();
assert!(state.is_empty());
assert_eq!(state.line_count(), 1);

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

Creates a textarea with initial content, split on newlines. Cursor is placed at the end of the content.

pub fn with_placeholder(placeholder: impl Into<String>) -> Self

Creates a textarea with placeholder text.

pub fn value(&self) -> String

Returns the full text content (lines joined with \n).

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

Sets the content from a string (splits on \n). Cursor moves to end.

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

Returns the cursor position as (row, char_column).

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

Returns the cursor display position as (row, terminal_column_width).

Unlike cursor_position() which returns the character count for the column, this returns the display width accounting for wide characters (emoji, CJK) that occupy 2 terminal columns.

Example

use envision::component::{TextArea, TextAreaState, TextAreaMessage, Component};

let mut state = TextArea::init();
TextArea::update(&mut state, TextAreaMessage::Insert('A'));
TextArea::update(&mut state, TextAreaMessage::Insert('\u{1F600}')); // emoji

// Character count is 2 (two characters)
assert_eq!(state.cursor_position(), (0, 2));
// Display width is 3 (A=1 + 😀=2)
assert_eq!(state.cursor_display_position(), (0, 3));

pub fn cursor_row(&self) -> usize

Returns the cursor row.

pub fn cursor_col(&self) -> usize

Returns the cursor column (byte offset).

pub fn line_count(&self) -> usize

Returns the number of lines.

pub fn line(&self, index: usize) -> Option<&str>

Returns a specific line by index.

pub fn current_line(&self) -> &str

Returns the current line (at cursor row).

pub fn is_empty(&self) -> bool

Returns true if the textarea is empty.

A textarea is empty if it contains only a single empty line.

pub fn placeholder(&self) -> &str

Returns the placeholder text.

pub fn set_placeholder(&mut self, placeholder: impl Into<String>)

Sets the placeholder text.

pub fn scroll_offset(&self) -> usize

Returns the scroll offset.

pub fn set_cursor_position(&mut self, row: usize, col: usize)

Sets the cursor position (row, char_column).

Both row and column are clamped to valid ranges.

pub fn ensure_cursor_visible(&mut self, visible_lines: usize)

Ensures the cursor is visible within the viewport.

pub fn can_undo(&self) -> bool

Returns true if there are edits that can be undone.

pub fn can_redo(&self) -> bool

Returns true if there are edits that can be redone.

pub fn is_focused(&self) -> bool

Returns true if the textarea is focused.

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

Sets the focus state.

pub fn is_disabled(&self) -> bool

Returns true if the textarea is disabled.

pub fn set_disabled(&mut self, disabled: bool)

Sets the disabled state.

pub fn with_disabled(self, disabled: bool) -> Self

Sets the disabled state using builder pattern.

pub fn handle_event(&self, event: &Event) -> Option<TextAreaMessage>

Maps an input event to a textarea message.

pub fn dispatch_event(&mut self, event: &Event) -> Option<TextAreaOutput>

Dispatches an event, updating state and returning any output.

pub fn update(&mut self, msg: TextAreaMessage) -> Option<TextAreaOutput>

Updates the textarea state with a message, returning any output.

Trait Implementations

impl Clone for TextAreaState

fn clone(&self) -> TextAreaState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TextAreaState

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

Formats the value using the given formatter.

impl Default for TextAreaState

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TextAreaState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TextAreaState

fn eq(&self, other: &TextAreaState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TextAreaState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TextAreaState