Struct TextArea 

pub struct TextArea { /* private fields */ }

Wrapped, multi-line editable text.

Enter inserts a line and the platform modifier plus enter submits. Motion follows visual rows with a preserved goal column, and the frame grows from rows to max_rows before it scrolls rather than pushing the page around.

Implementations

impl TextArea

pub fn new( ident: impl Into<Ident>, window: &mut Window, cx: &mut Context<'_, Self>, ) -> Self

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

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

Seeds the initial text, with the caret at the end.

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

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

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

Keeps the value focusable and exposed while refusing keyboard, pointer, IME, and accessibility value changes.

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

The rows the area occupies before it has anything longer to show.

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

Grows with the text up to this many rows, then scrolls instead.

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

Truncates input past a length in bytes of UTF-8.

pub fn value(&self) -> &SharedString

pub fn is_empty(&self) -> bool

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

Replaces the text from the host side, for example when a form resets.

pub fn set_disabled(&mut self, disabled: bool, cx: &mut Context<'_, Self>)

pub fn set_read_only(&mut self, read_only: bool, cx: &mut Context<'_, Self>)

pub fn set_invalid(&mut self, invalid: bool, cx: &mut Context<'_, Self>)

pub fn is_disabled(&self) -> bool

pub fn selected_range(&self) -> Range<usize>

pub fn cursor_offset(&self) -> usize

pub fn cursor_row(&self) -> usize

The visual row the caret sits on, counting wrapped rows.

Zero until the area has been laid out once, because a wrapped row only exists once a width is known.

Trait Implementations

impl Debug for TextArea

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

Formats the value using the given formatter.

impl Disableable for TextArea

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

impl EntityInputHandler for TextArea

fn text_for_range( &mut self, range_utf16: Range<usize>, actual_range: &mut Option<Range<usize>>, _window: &mut Window, _cx: &mut Context<'_, Self>, ) -> Option<String>

See InputHandler::text_for_range for details

fn selected_text_range( &mut self, _ignore_disabled_input: bool, _window: &mut Window, _cx: &mut Context<'_, Self>, ) -> Option<UTF16Selection>

See InputHandler::selected_text_range for details

fn marked_text_range( &self, _window: &mut Window, _cx: &mut Context<'_, Self>, ) -> Option<Range<usize>>

See InputHandler::marked_text_range for details

fn unmark_text(&mut self, _window: &mut Window, _cx: &mut Context<'_, Self>)

See InputHandler::unmark_text for details

fn replace_text_in_range( &mut self, range_utf16: Option<Range<usize>>, new_text: &str, _window: &mut Window, cx: &mut Context<'_, Self>, )

See InputHandler::replace_text_in_range for details

fn replace_and_mark_text_in_range( &mut self, range_utf16: Option<Range<usize>>, new_text: &str, new_selected_range_utf16: Option<Range<usize>>, _window: &mut Window, cx: &mut Context<'_, Self>, )

See InputHandler::replace_and_mark_text_in_range for details

fn bounds_for_range( &mut self, range_utf16: Range<usize>, bounds: Bounds<Pixels>, _window: &mut Window, _cx: &mut Context<'_, Self>, ) -> Option<Bounds<Pixels>>

See InputHandler::bounds_for_range for details

fn character_index_for_point( &mut self, point: Point<Pixels>, _window: &mut Window, _cx: &mut Context<'_, Self>, ) -> Option<usize>

See InputHandler::character_index_for_point for details

fn set_selected_text_range( &mut self, _range_utf16: Range<usize>, _window: &mut Window, _cx: &mut Context<'_, Self>, )

See InputHandler::set_selected_text_range for details

fn text_length_utf16( &mut self, _window: &mut Window, _cx: &mut Context<'_, Self>, ) -> Option<usize>

See InputHandler::text_length_utf16 for details

fn accepts_text_input( &self, _window: &mut Window, _cx: &mut Context<'_, Self>, ) -> bool

See InputHandler::accepts_text_input for details

impl EventEmitter<TextAreaEvent> for TextArea

impl Focusable for TextArea

fn focus_handle(&self, _cx: &App) -> FocusHandle

Returns the focus handle associated with this view.

impl Render for TextArea

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

Render this view into an element tree.

impl Sizable for TextArea

fn control_size(self, size: ControlSize) -> Self

fn xs(self) -> Self

fn small(self) -> Self

fn medium(self) -> Self

fn large(self) -> Self