Struct TextArea 

pub struct TextArea { /* private fields */ }

A multiline text field. Create with cx.new(|cx| TextArea::new(cx)).

Implementations

impl TextArea

pub fn new(cx: &mut Context<'_, Self>) -> Self

pub fn value(self, value: &str) -> Self

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

pub fn set_placeholder( &mut self, placeholder: impl Into<SharedString>, cx: &mut Context<'_, Self>, )

Replace the placeholder after construction, for a field that is built once and re-labelled later.

pub fn label(self, label: impl Into<SharedString>) -> Self

pub fn description(self, description: impl Into<SharedString>) -> Self

pub fn error(self, error: impl Into<SharedString>) -> Self

pub fn max_rows(self, rows: usize) -> Self

Stop growing past rows and scroll instead. Without this a field that grows with its content has no ceiling, which is wrong for a composer pinned to the bottom of a window.

pub fn submit_on_enter(self, submit: bool) -> Self

Make Enter commit the value (emitting TextAreaSubmit) and Shift+Enter insert the newline — the convention a chat composer uses.

pub fn rows(self, rows: usize) -> Self

Minimum visible rows (sets the field’s minimum height).

pub fn size(self, size: Size) -> Self

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

pub fn focus_handle(&self) -> FocusHandle

The field’s focus handle, so a host can focus it on open.

pub fn text(&self) -> String

pub fn is_blank(&self) -> bool

Whether the field holds nothing but whitespace. Cheaper than text().trim().is_empty(), which builds and throws away a copy of the whole value — and callers ask this every frame to enable a send button.

pub fn set_text(&mut self, value: &str, cx: &mut Context<'_, Self>)

pub fn bind(entity: &Entity<TextArea>, signal: &Signal<String>, cx: &mut App)

Two-way bind this field’s text to a Signal<String>. The signal is the source of truth: the field adopts its value now, edits write back through Signal::set_if_changed, and signal writes replace the text. Equality guards on both directions prevent update loops.

Trait Implementations

impl EventEmitter<TextAreaEvent> for TextArea

impl EventEmitter<TextAreaSubmit> for TextArea

impl Render for TextArea

fn render( &mut self, window: &mut Window, cx: &mut Context<'_, Self>, ) -> impl IntoElement

Render this view into an element tree.