Update README and tutorial.

This commit is contained in:
ArthurSonzogni 2019-01-27 16:56:37 +01:00
parent 65adb42124
commit cfdb18928d
2 changed files with 48 additions and 17 deletions

View File

@ -1,9 +1,12 @@
# FTXUI # FTXUI
![Demo image](./examples/component/homescreen.gif)
Functional Terminal (X) User interface **Functional Terminal (X) User interface**
A simple C++ library for terminal based user interface. A simple C++ library for terminal based user interface.
## Demo:
![Demo image](./examples/component/homescreen.gif)
## Feature ## Feature
* Functional style. * Functional style.
* Simple and elegant syntax (in my opinion). * Simple and elegant syntax (in my opinion).
@ -70,7 +73,7 @@ int main(int argc, const char *argv[])
text(L"middle") | flex, text(L"middle") | flex,
text(L"right") text(L"right")
), ),
auto screen = Screen::TerminalOutput(document); auto screen = Screen::Create(Dimension::Full, Dimension::Fit(document));
Render(screen, document.get()); Render(screen, document.get());
std::cout << screen.ToString(); std::cout << screen.ToString();

View File

@ -15,8 +15,8 @@
* [Toggle.](#toggle) * [Toggle.](#toggle)
## Introduction ## Introduction
I highly recommand to not take too long on the tutorial, instead you should try I **highly** recommand not to take too much time reading the tutorial. Instead,
to understand the /example/*. you should try to read the examples (in ./example/).
## DOM ## DOM
All the dom element are declared in one header: All the dom element are declared in one header:
@ -30,10 +30,14 @@ It declares the following set of elements:
// --- Widget --- // --- Widget ---
Element text(std::wstring text); Element text(std::wstring text);
Element separator(); Element separator();
Element separator(Pixel);
Element gauge(float ratio); Element gauge(float ratio);
Element border(Element); Element border(Element);
Decorator borderWith(Pixel);
Element window(Element title, Element content); Element window(Element title, Element content);
Element spinner(int charset_index, size_t image_index); Element spinner(int charset_index, size_t image_index);
Elements paragraph(std::wstring text); // Use inside hflow(). Split by space.
Element graph(GraphFunction);
// -- Decorator --- // -- Decorator ---
Element bold(Element); Element bold(Element);
@ -48,16 +52,22 @@ Element bgcolor(Color, Element);
// --- Layout --- // --- Layout ---
// Horizontal, Vertical or stacked set of elements. // Horizontal, Vertical or stacked set of elements.
Element vbox(Elements);
Element hbox(Elements); Element hbox(Elements);
Element vbox(Elements);
Element dbox(Elements); Element dbox(Elements);
Element hflow(Elements);
// -- Flexibility --- // -- Flexibility ---
// Define how to share the remaining space when not all of it is used inside a // Define how to share the remaining space when not all of it is used inside a
// container. // container.
Element filler(); Element filler();
Element flex(Element); Element flex(Element);
Decorator size(size_t width, size_t height); Element notflex(Element);
// -- Size override;
enum Direction { WIDTH, HEIGHT };
enum Constraint { LESS_THAN, EQUAL, GREATER_THAN };
Decorator size(Direction, Constraint, int value);
// --- Frame --- // --- Frame ---
// A frame is a scrollable area. The internal area is potentially larger than // A frame is a scrollable area. The internal area is potentially larger than
@ -86,16 +96,17 @@ Element dim(Element);
Element inverted(Element); Element inverted(Element);
Element underlined(Element); Element underlined(Element);
Element blink(Element); Element blink(Element);
Element color(Color, Element); Decorator color(Color);
Element bgcolor(Color, Element); Decorator bgcolor(Color);
~~~ ~~~
### Layout ### Layout
These layout are similar to the HTML flexbox:
* vbox (Vertical-box) * vbox (Vertical-box)
* hbox (Horizontal-box) * hbox (Horizontal-box)
* dbox (Depth-box) * dbox (Z-axis-box)
are containers. They are used to compose all the elements together. Each They are used to compose all the elements together. Each
children are put side by side. If the container is flexible, the extra space children are put side by side. If the container is flexible, the extra space
available will be shared among the remaining flexible children. available will be shared among the remaining flexible children.
@ -103,6 +114,9 @@ flex(element) can be used to make a non-flexible element flexible. filler() is a
flexible empty element. You can use it align children on one side of the flexible empty element. You can use it align children on one side of the
container. container.
An horizontal flow layout is implemented by:
* hflow (Horizontal flow)
#### Examples #### Examples
~~~cpp ~~~cpp
hbox( hbox(
@ -134,7 +148,7 @@ container.
#### text #### text
The most simple widget. It display a text. The most simple widget. It displays a text.
~~~cpp ~~~cpp
text(L"I am a piece of text"); text(L"I am a piece of text");
~~~ ~~~
@ -143,7 +157,7 @@ I am a piece of text.
~~~ ~~~
#### border #### border
Add a border arround an element Add a border around an element
~~~cpp ~~~cpp
border(text(L"The element")) border(text(L"The element"))
~~~ ~~~
@ -193,6 +207,9 @@ border(gauge(0.5))
└────────────────────────────────────────────────────────────────────────────┘ └────────────────────────────────────────────────────────────────────────────┘
~~~ ~~~
### graph
[![asciicast](https://asciinema.org/a/223726.svg)](https://asciinema.org/a/223726)
### Decorator ### Decorator
Terminal supports displaying text using differet style: bold, dim, underlined, Terminal supports displaying text using differet style: bold, dim, underlined,
@ -210,10 +227,21 @@ text(L"This text is bold")) | bold | underlined
## Components. ## Components.
dom element are stateless. Element are stateless object. On the other side, components are used when an
internal state is needed. Components are used to interact with the user with
its keyboard. They handle keyboard navigation, including component focus.
### Input ### Input
TODO(arthursonzogni): Add Video [![asciicast](https://asciinema.org/a/223719.svg)](https://asciinema.org/a/223719)
### Menu ### Menu
TODO(arthursonzogni): Add Video [![asciicast](https://asciinema.org/a/223720.svg)](https://asciinema.org/a/223720)
### Toggle. ### Toggle.
TODO(arthursonzogni): Add video [![asciicast](https://asciinema.org/a/223722.svg)](https://asciinema.org/a/223722)
### CheckBox
[![asciicast](https://asciinema.org/a/223724.svg)](https://asciinema.org/a/223724)
### RadioBox
[![asciicast](https://asciinema.org/a/223725.svg)](https://asciinema.org/a/223725)