Lib.rs

EdTUI

Overview

EdTUI is a text editor widget for the Ratatui ecosystem. It is designed to provide a user experience inspired by Vim. Edtui is developed to be used as an editor in ratatui apps. It is not supposed to be a stand-alone code editor.

Instantiate the state and render the view:

use edtui::{EditorState, EditorTheme, EditorView};
use ratatui::widgets::Widget;

let mut state = EditorState::default();
EditorView::new(&mut state)
        .theme(EditorTheme::default())
        .wrap(true) // line wrapping
        .render(area, buf);

Handle events:

use edtui::EditorEventHandler;

let mut event_handler = EditorEventHandler::default();
event_handler.on_key_event(key_event, &mut state);

Features

• Vim-like keybindings and editing modes for efficient text manipulation.
• Copy paste using the systems clipboard.
• Line wrapping.
• Syntax highlighting (experimental).
• Mouse support (experimental).

Demo

Keybindings

EdTUI offers a set of keybindings similar to Vim. Here are some of the most common keybindings:

Normal Mode:

Insert Mode:

For more keybindings and customization options, refer to the code.

Experimental Mouse Support

Edtui includes experimental mouse support:

let event_handler = EditorEvent::default();
event_handler.on_mouse_event(mouse_event, &mut state);
// or handle both key and mouse event
event_handler.on_event(event, &mut state);

Syntax highlighting

Syntax highlighting was added in version 0.8.4. It is experimental, so expect breaking changes.

Edtui offers a number of custom themes, see SyntaxHighlighter::theme for a complete list. If you want to use a custom theme, see SyntaxHighlighter::custom_theme. Check syntect for more details about themes and extensions.

use edtui::EditorState;
use edtui::EditorView;
use edtui::SyntaxHighlighter;

let theme_name = "dracula";
let extension = "rs";
let syntax_highlighter = SyntaxHighlighter::new(theme_name, extension);
EditorView::new(&mut EditorState::default())
        .syntax_highlighter(Some(syntax_highlighter))
        .render(area, buf);

Roadmap

• Support termwiz and termion
• Display line numbers
• Remap keybindings

License: MIT