Struct TextAreaState 

pub struct TextAreaState { /* private fields */ }

State for a TextArea component.

Implementations

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.

The content is split on newlines into separate lines. The cursor is placed at the end of the content.

Example

use envision::component::TextAreaState;

let state = TextAreaState::with_value("Hello\nWorld");
assert_eq!(state.line_count(), 2);
assert_eq!(state.line(0), Some("Hello"));
assert_eq!(state.line(1), Some("World"));

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

Creates a textarea with placeholder text.

Example

use envision::component::TextAreaState;

let state = TextAreaState::with_placeholder("Enter description...");
assert_eq!(state.placeholder(), "Enter description...");
assert!(state.is_empty());

pub fn value(&self) -> String

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

Example

use envision::component::TextAreaState;

let state = TextAreaState::with_value("Line 1\nLine 2");
assert_eq!(state.value(), "Line 1\nLine 2");

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

Sets the content from a string (splits on \n).

The cursor is moved to the end of the content.

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

Returns the cursor position as (row, char_column).

Example

use envision::component::TextAreaState;

let state = TextAreaState::with_value("Hello\nWorld");
// Cursor is at end of "World" (row 1, char 5)
assert_eq!(state.cursor_position(), (1, 5));

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(&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.

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.