Struct TextEditor 

pub struct TextEditor<'a, Parser, Message, Theme = Theme, Renderer = Renderer>
where
    Parser: Parser,
    Theme: Catalog,
    Renderer: Renderer,
{ /* private fields */ }

A multi-line text input.

Example

use iced::widget::text_editor;

struct State {
   content: text_editor::Content,
}

#[derive(Debug, Clone)]
enum Message {
    Edit(text_editor::Action)
}

fn view(state: &State) -> impl Widget<Message> {
    text_editor(&state.content)
        .placeholder("Type something here...")
        .on_action(Message::Edit)
}

fn update(state: &mut State, message: Message) {
    match message {
        Message::Edit(action) => {
            state.content.perform(action);
        }
    }
}

Implementations

impl<'a, Message, Theme, Renderer> TextEditor<'a, PlainText, Message, Theme, Renderer>

where Theme: Catalog, Renderer: Renderer,

pub fn new(content: &'a Content<Renderer>) -> Self

Creates new TextEditor with the given Content.

impl<'a, Message, Renderer> TextEditor<'a, PlainText, Message, Theme, Renderer>

where Renderer: Renderer,

pub fn highlight( self, syntax: &str, ) -> TextEditor<'a, Parser, Message, Theme, Renderer>

where Renderer: Renderer,

Available on crate feature highlighter only.

Highlights the TextEditor using the given syntax.

use iced::color;
use iced::widget::text;
use iced::widget::text_editor;
use iced::Theme;

struct State {
   content: text_editor::Content,
}

fn view(state: &State) -> impl Widget<()> {
    text_editor(&state.content)
        .highlight("rust")
}

impl<'a, Parser, Message, Theme, Renderer> TextEditor<'a, Parser, Message, Theme, Renderer>

where Parser: Parser, Theme: Catalog, Renderer: Renderer,

pub fn id(self, id: impl Into<Id>) -> Self

Sets the Id of the TextEditor.

pub fn placeholder(self, placeholder: impl IntoFragment<'a>) -> Self

Sets the placeholder of the TextEditor.

pub fn width(self, width: impl Into<Pixels>) -> Self

Sets the width of the TextEditor.

pub fn height(self, height: impl Into<Length>) -> Self

Sets the height of the TextEditor.

pub fn on_action(self, on_edit: impl Fn(Action) -> Message + 'a) -> Self

Sets the message that should be produced when some action is performed in the TextEditor.

If this method is not called, the TextEditor will be disabled.

pub fn font(self, font: impl Into<Font>) -> Self

Sets the Font of the TextEditor.

pub fn size(self, size: impl Into<Pixels>) -> Self

Sets the text size of the TextEditor.

pub fn line_height(self, line_height: impl Into<LineHeight>) -> Self

Sets the text::LineHeight of the TextEditor.

pub fn padding(self, padding: impl Into<Padding>) -> Self

Sets the [Padding] of the TextEditor.

pub fn wrapping(self, wrapping: Wrapping) -> Self

Sets the Wrapping strategy of the TextEditor.

pub fn highlight_with<P: Parser>( self, settings: P::Settings, highlighter: impl Highlighter<P::Output, Theme> + 'a, ) -> TextEditor<'a, P, Message, Theme, Renderer>

Highlights the TextEditor with the given text::Parser and text::Highlighter.

pub fn key_binding( self, key_binding: impl Fn(KeyPress) -> Option<Binding<Message>> + 'a, ) -> Self

Sets the closure to produce key bindings on key presses.

See Binding for the list of available bindings.

pub fn style(self, style: impl Fn(&Theme, Status) -> Style + 'a) -> Self

where Theme::Class<'a>: From<StyleFn<'a, Theme>>,

Sets the style of the TextEditor.

pub fn class(self, class: impl Into<Theme::Class<'a>>) -> Self

Available on crate feature advanced only.

Sets the style class of the TextEditor.

Trait Implementations

impl<Parser, Message, Theme, Renderer> Meta for TextEditor<'_, Parser, Message, Theme, Renderer>

where Parser: Parser, Theme: Catalog, Renderer: Renderer,

fn is_void(&self) -> bool

Returns whether the [Widget] is Void.

impl<Parser, Message, Theme, Renderer> Widget<Message, Theme, Renderer> for TextEditor<'_, Parser, Message, Theme, Renderer>

where Parser: Parser, Theme: Catalog, Renderer: Renderer,

fn tag(&self) -> Tag

Returns the Tag of the [Widget].

fn state(&self) -> State

Returns the State of the [Widget].

fn size(&self) -> Size<Length>

Returns the [Size] of the [Widget] in lengths.

fn layout(&mut self, tree: &mut Tree, renderer: &Renderer, limits: &Limits)

Lays out the [Widget].

fn update( &mut self, tree: &mut Tree, event: &Event, layout: Layout, cursor: Cursor, _renderer: &Renderer, shell: &mut Shell<'_, Message>, _viewport: &Rectangle, )

Processes a runtime Event.

fn draw( &self, tree: &Tree, renderer: &mut Renderer, theme: &Theme, _defaults: &Style, layout: Layout, _cursor: Cursor, viewport: &Rectangle, )

Draws the [Widget] using the associated Renderer.

fn mouse_interaction( &self, _tree: &Tree, layout: Layout, cursor: Cursor, _viewport: &Rectangle, _renderer: &Renderer, ) -> Interaction

Returns the current [mouse::Interaction] of the [Widget].

fn operate( &mut self, tree: &mut Tree, layout: Layout, _viewport: &Rectangle, _renderer: &Renderer, operation: &mut dyn Operation, )

Applies an [Operation] to the [Widget].

fn diff(&mut self, tree: &mut Tree)

Reconciles the [Widget] with the provided [Tree].

fn overlay<'a>( &'a mut self, _tree: &'a mut Tree, _layout: Layout, _renderer: &Renderer, _viewport: &Rectangle, _translation: Vector, _window: Size, ) -> Vec<Element<'a, Message, Theme, Renderer>>

Returns the overlays of the [Widget].

fn _map<F, B>(self, f: F) -> Map<Self, F, Message>

where Self: Sized, F: Fn(Message) -> B,

Applies a transformation to the produced message of this [Widget], returning a [Map].

fn _boxed<'a>(self) -> Element<'a, Message, Theme, Renderer>

where Self: Sized + 'a,

Boxes this [Widget], turning it into a generic [Element].