#tui #component #state #widgets #render #user-interface #mutable

tui-react

TUI widgets using a react-like paradigm, allowing mutable component state and render properties

24 releases (15 breaking)

0.23.2 Mar 10, 2024
0.23.0 Feb 3, 2024
0.22.0 Dec 26, 2023
0.20.0 May 11, 2023
0.1.2 Jun 15, 2019

#154 in Command-line interface

Download history 1583/week @ 2023-12-06 1121/week @ 2023-12-13 961/week @ 2023-12-20 903/week @ 2023-12-27 1003/week @ 2024-01-03 484/week @ 2024-01-10 948/week @ 2024-01-17 606/week @ 2024-01-24 449/week @ 2024-01-31 488/week @ 2024-02-07 578/week @ 2024-02-14 492/week @ 2024-02-21 443/week @ 2024-02-28 958/week @ 2024-03-06 698/week @ 2024-03-13 537/week @ 2024-03-20

2,688 downloads per month
Used in 9 crates (3 directly)

MIT license

16KB
349 lines

tui-react is a library to enable components with state, and with properties provided per render

Please note that this crate is early in development and build for the needs of dua.

How it works

It uses the TUI infrastructure Terminal, but alters it to not enforce implementing the Widget trait. It provides only a single, optional, trait called TopLevelComponent, which makes it convenient to draw its implementors with Terminal::render(..). However, since this enforces the absence of refernces in your state, it's probably not suitable for most.

Instead, any struct can implement render methods or functions, and freely write into the terminal. That way, one can leverage everything Rust has to offer, which allows stateful components which work in your favor. Thus, this crate does away with 'one size fits all' render implementations, greatly adding to flexibility.

State that one wants within the component for instance could be the scoll location. Alternatively, one can configure windows by altering their public state.

What's the relation to TUI / Ratatui?

This project couldn't exist without TUI, and is happy to provide an alternative set of components for use in command-line applications. Ratatui is the continuation of the tui project.

Why tui-react?

I kept having a terrible feeling when managing state with tui widgets when writing dua, and after trying many things, I realized what the problem actually was. It took me some time to realize it's not possible to have stateful components in with TUI, and I admire the smarts that went into the API design! After all, it effectively prohibited this! Amazing!

That's why I implemented my own terminal and some key components, based on the ones provided by TUI, which can serve as standard building blocks in a stateful world.

Thus far, the experience was fantastic, and it feels much better than before. Let's see what happens with it.

Changelog

v0.4.1 - Simplify block_width() function

v0.2.1 - add license file to crate

Dependencies

~6.5MB
~115K SLoC