Struct TextArea 

pub struct TextArea {

    pub rect: Rect,
    pub text: String,
    pub text_size: f32,
    pub text_color: ColorLinPremul,
    pub placeholder: Option<String>,
    pub focused: bool,
    pub bg_color: ColorLinPremul,
    pub border_color: ColorLinPremul,
    pub border_width: f32,
    pub corner_radius: f32,
    pub validation_error: Option<String>,
    pub cursor_position: usize,
    pub focus_id: FocusId,
    /* private fields */
}

A multi-line text area with vertical scrolling, cursor, and basic editing.

This is a simplified standalone version that stores text as a String.

Fields

rect: Rect

Bounding rect.

text: String

Current text content.

text_size: f32

Font size.

text_color: ColorLinPremul

Text color.

placeholder: Option<String>

Placeholder text when empty.

focused: bool

Whether this text area is focused.

bg_color: ColorLinPremul

Background color.

border_color: ColorLinPremul

Border color.

border_width: f32

Border width.

corner_radius: f32

Corner radius.

validation_error: Option<String>

Validation error message.

cursor_position: usize

Cursor byte position.

focus_id: FocusId

Focus identifier.

Implementations

impl TextArea

pub fn new(rect: Rect) -> Self

Create a new text area.

pub fn text(&self) -> &str

Get the current text content.

pub fn set_text(&mut self, text: impl Into<String>)

Set the text and move cursor to end.

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

Set the placeholder text.

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

Insert text at the cursor position.

pub fn delete_char_before(&mut self)

Delete one character before the cursor.

pub fn delete_char_after(&mut self)

Delete one character after the cursor.

pub fn move_cursor_left(&mut self)

Move cursor left by one character.

pub fn move_cursor_right(&mut self)

Move cursor right by one character.

pub fn move_cursor_home(&mut self)

Move cursor home (beginning of current line).

pub fn move_cursor_end(&mut self)

Move cursor to end of current line.

pub fn hit_test(&self, x: f32, y: f32) -> bool

Hit-test the text area rect.

Trait Implementations

impl Default for TextArea

fn default() -> Self

Returns the “default value” for a type.

impl Element for TextArea

fn rect(&self) -> Rect

The bounding rectangle of this element in logical coordinates.

fn set_rect(&mut self, rect: Rect)

Update the bounding rectangle (typically called by the layout engine).

fn render(&self, canvas: &mut Canvas, z: i32)

Paint this element onto canvas at the given z-index.

fn focus_id(&self) -> Option<FocusId>

The focus identifier for this element, if it is focusable.

impl EventHandler for TextArea

fn handle_mouse_click(&mut self, event: &MouseClickEvent) -> EventResult

Handle a mouse click event. Returns Handled if the event was consumed.

fn handle_keyboard(&mut self, event: &KeyboardEvent) -> EventResult

Handle a keyboard event. Returns Handled if the event was consumed.

fn handle_mouse_move(&mut self, _event: &MouseMoveEvent) -> EventResult

Handle a mouse-move event.

fn handle_scroll(&mut self, event: &ScrollEvent) -> EventResult

Handle a scroll event.

fn is_focused(&self) -> bool

Whether this element currently has focus.

fn set_focused(&mut self, focused: bool)

Set focus state for this element.

fn contains_point(&self, x: f32, y: f32) -> bool

Hit-test: does this element contain the given logical point?