tui-realm-stdlib icon indicating copy to clipboard operation
tui-realm-stdlib copied to clipboard

๐ŸŽจ Standard components library for tui-realm

tui-realm-stdlib

logo

~ A tui-rs framework inspired by Elm and React ~

tui-realm derive ยท tui-realm ยท Documentation

Developed by @veeso

Current version: 1.3.2 (05/03/2024)

License-MIT Repo stars Downloads counter Latest version Ko-fi

tui ci ratatui ci Docs


  • tui-realm-stdlib
    • About tui-realm-stdlib ๐Ÿ‘‘
    • Get started ๐Ÿ
      • Add tui-realm to your Cargo.toml ๐Ÿฆ€
    • Support the developer โ˜•
    • Components ๐ŸŽจ
      • Utilities
    • Documentation ๐Ÿ“š
    • Contributing and issues ๐Ÿค๐Ÿป
    • Changelog โณ
    • License ๐Ÿ“ƒ

About tui-realm-stdlib ๐Ÿ‘‘

tui-realm-stdlib is the standard component library for tui-realm.

It provides several Mock Components for your tui-realm applications. Probably all the components you need are here ๐Ÿ˜‰


Get started ๐Ÿ

Add tui-realm to your Cargo.toml ๐Ÿฆ€

tui-realm-stdlib = "^1.3.0"

or if you're not using the default crossterm backend, specify another backend in the cargo entry:

tui-realm-stdlib = { version = "^1.3.0", default-features = false, features = [ "ratatui", "termion" ] }

Latest version of tui-realm-stdlib requires tui-realm 1.9.0 or higher

tuirealm = "^1.9.0"

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:

ko-fi PayPal


Components ๐ŸŽจ

All the components implemented in the standard library can be viewed in the components wiki.


Utilities

The standard components library also exports the utils module, which provides these very handy functions:

  • wrap_spans: Creates span lines from text spans, in order to wrap lines
  • use_or_default_styles: use colors and modifiers of the text spans if not Color::Reset or Modifiers::empty(), otherwise use the properties defined the Props.
  • get_block: creates the block for the widget. If focus is true, the colors are applied, otherwise Color::Reset.

Documentation ๐Ÿ“š

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


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-stdlib, feel free to open an issue or a PR.

Please follow our contributing guidelines


Changelog โณ

View tui-realm's changelog HERE


License ๐Ÿ“ƒ

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

You can read the entire license HERE