From 151caacd9d1675174a035731429058eea20ea5c9 Mon Sep 17 00:00:00 2001 From: Philipp Reiter Date: Sun, 13 Oct 2024 10:35:09 +0200 Subject: [PATCH] Update README --- README.md | 18 +++++++++++++++++- src/lib.rs | 18 +++++++++++++++++- 2 files changed, 34 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e4857a1..ce06ce4 100644 --- a/README.md +++ b/README.md @@ -10,8 +10,9 @@ `EdTUI` is a text editor widget for the [Ratatui](https://github.com/ratatui-org/ratatui) ecosystem. It is designed to provide a light-weight user experience inspired by Vim. +Instantiate the state and render the view: ```rust -use edtui::{EditorState, EditorTheme, EditorView}; +use edtui::{EditorEventHandler, EditorState, EditorTheme, EditorView}; use ratatui::widgets::Widget; let mut state = EditorState::default(); @@ -19,6 +20,21 @@ EditorView::new(&mut state) .theme(EditorTheme::default()) .wrap(true) // line wrapping .render(area, buf); + +``` + +Handle events: +```rust +let mut event_handler = EditorEventHandler::default(); + +// or handle only key events +event_handler.on_key_event(key_event, &mut state); + +// has experimental support for mouse events +event_handler.on_mouse_event(mouse_event, &mut state); + +// handles both key and mouse events +event_handler.on_event(event, &mut state); ``` ### Features diff --git a/src/lib.rs b/src/lib.rs index 7f3fb78..de4b36f 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -10,8 +10,9 @@ //! `EdTUI` is a text editor widget for the [Ratatui](https://github.com/ratatui-org/ratatui) ecosystem. //! It is designed to provide a light-weight user experience inspired by Vim. //! +//! Instantiate the state and render the view: //! ```ignore -//! use edtui::{EditorState, EditorTheme, EditorView}; +//! use edtui::{EditorEventHandler, EditorState, EditorTheme, EditorView}; //! use ratatui::widgets::Widget; //! //! let mut state = EditorState::default(); @@ -19,6 +20,21 @@ //! .theme(EditorTheme::default()) //! .wrap(true) // line wrapping //! .render(area, buf); +//! +//! ``` +//! +//! Handle events: +//! ```ignore +//! let mut event_handler = EditorEventHandler::default(); +//! +//! // or handle only key events +//! event_handler.on_key_event(key_event, &mut state); +//! +//! // has experimental support for mouse events +//! event_handler.on_mouse_event(mouse_event, &mut state); +//! +//! // handles both key and mouse events +//! event_handler.on_event(event, &mut state); //! ``` //! //! ## Features