tui-realm-textarea

~ Textarea component for tui-realm ~

tui-textarea · tui-realm · Documentation

Developed by @veeso

Current version: 2.1.0 (23/03/2025)

• tui-realm-textarea
  • About tui-realm-textarea ✏️
  • Get started 🏁
    • Add tui-realm-textarea to your Cargo.toml 🦀
      • Features ⚙️
    • Examples 📋
  • Component API
    • Footer and status format
  • Documentation 📚
  • Contributing and issues 🤝🏻
  • Changelog ⏳
  • Support the developer ☕
  • License 📃

About tui-realm-textarea ✏️

tui-realm-textarea is an implementation of a textarea component for tui-realm. It is based on the tui-textarea component by rhysd.

Get started 🏁

Add tui-realm-textarea to your Cargo.toml 🦀

tui-realm-textarea = "2"

Or if you don't use Crossterm, define the backend as you do with tui-realm:

tui-realm-textarea = { version = "2", default-features = false, features = [ "termion" ] }

Features ⚙️

These features can be enabled in tui-realm-textarea:

• clipboard enables system clipboard support
• search enables the string search in the textarea

Examples 📋

View how to use the textarea component in the example. The example contains a simple text editor.

cargo run --example demo --features clipboard,search

Press ESC to quit

Component API

Commands:

❗ Paste command is supported only if the clipboard feature is enabled

State: the state returned is a Vec(String) containing the lines in the text area.

Properties:

• Borders(Borders): set borders properties for component
• Custom($TREE_IDENT_SIZE, Size): Set space to render for each each depth level
• Custom($TEXTAREA_MAX_HISTORY, Payload(One(Usize))): Set the history steps to record
• Custom($TEXTAREA_CURSOR_STYLE, Style): Set the cursor style
• Custom($TEXTAREA_CURSOR_LINE_STYLE, Style): Set the current line style
• Custom($TEXTAREA_FOOTER_FMT, Payload(Tup2(Str, Style))): Set the format and the style for the footer bar
• Custom($TEXTAREA_LINE_NUMBER_STYLE, Style): set the style for the line number
• Custom($TEXTAREA_STATUS_FMT, Payload(Tup2(Str, Style))): Set the format and the style for the status bar
• Custom($TEXTAREA_SEARCH_PATTERN, String: Set search pattern
• Custom($TEXTAREA_SEARCH_STYLE, Style: Set search style
• Style(Style): Set the general style for the textarea
• Custom($TEXTAREA_TAB_SIZE, Size): Set the tab size to display
• FocusStyle(Style): inactive style
• ScrollStep(Length): Defines the maximum amount of rows to scroll
• Title(Title): Set box title
• Custom($TEXTAREA_LAYOUT_MARGIN, Size): Set margin of layout

Footer and status format

The status and footer bars support a special syntax. The following keys can be inserted into the string:

• {ROW}: current row
• {COL}: current column

Documentation 📚

The developer documentation can be found on Rust Docs at https://docs.rs/tui-realm-textarea

Contributing and issues 🤝🏻

Contributions, bug reports, new features and questions are welcome! 😉 If you have any question or concern, or you want to suggest a new feature, or you want just want to improve tui-realm, feel free to open an issue or a PR.

Please follow our contributing guidelines

Changelog ⏳

View tui-realm-textarea's changelog HERE

Support the developer ☕

If you like tui-realm and you're grateful for the work I've done, please consider a little donation 🥳

You can make a donation with one of these platforms:

License 📃

tui-realm-textarea is licensed under the MIT license.

You can read the entire license HERE