FTXUI  5.0.0
C++ functional terminal UI.
examples/component/composition.cpp
// Copyright 2021 Arthur Sonzogni. All rights reserved.
// Use of this source code is governed by the MIT license that can be found in
// the LICENSE file.
#include <memory> // for allocator, shared_ptr, __shared_ptr_access
#include <string> // for operator+, to_string
#include "ftxui/component/captured_mouse.hpp" // for ftxui
#include "ftxui/component/component.hpp" // for Button, Horizontal, Renderer
#include "ftxui/component/component_base.hpp" // for ComponentBase
#include "ftxui/component/screen_interactive.hpp" // for ScreenInteractive
#include "ftxui/dom/elements.hpp" // for text, separator, Element, operator|, vbox, border
using namespace ftxui;
// An example of how to compose multiple components into one and maintain their
// interactiveness.
int main() {
auto left_count = 0;
auto right_count = 0;
auto left_buttons = Container::Horizontal({
Button("Decrease", [&] { left_count--; }),
Button("Increase", [&] { left_count++; }),
});
auto right_buttons = Container::Horizontal({
Button("Decrease", [&] { right_count--; }),
Button("Increase", [&] { right_count++; }),
});
// Renderer decorates its child with a new rendering function. The way the
// children reacts to events is maintained.
auto leftpane = Renderer(left_buttons, [&] {
return vbox({
text("This is the left control"),
text("Left button count: " + std::to_string(left_count)),
left_buttons->Render(),
}) |
});
auto rightpane = Renderer(right_buttons, [&] {
return vbox({
text("This is the right control"),
text("Right button count: " + std::to_string(right_count)),
right_buttons->Render(),
}) |
});
// Container groups components togethers. To render a Container::Horizontal,
// it render its children side by side. It maintains their interactiveness and
// provide the logic to navigate from one to the other using the arrow keys.
auto composition = Container::Horizontal({leftpane, rightpane});
auto screen = ScreenInteractive::FitComponent();
screen.Loop(composition);
return 0;
}
// Thanks to Chris Morgan for this example!
Component Horizontal(Components children)
A list of components, drawn one by one horizontally and navigated horizontally using left/right arrow...
Definition: container.cpp:360
Component Button(ButtonOption options)
Draw a button. Execute a function when clicked.
Definition: button.cpp:175
Component Renderer(Component child, std::function< Element()>)
Return a new Component, similar to |child|, but using |render| as the Component::Render() event.
Definition: renderer.cpp:63
std::string to_string(const std::wstring &s)
Convert a UTF8 std::string into a std::wstring.
Definition: string.cpp:1565
Element text(std::wstring text)
Display a piece of unicode text.
Definition: text.cpp:120
Element separator()
Draw a vertical or horizontal separation in between two other elements.
Definition: separator.cpp:132
Element border(Element)
Draw a border around the element.
Definition: border.cpp:227
Element vbox(Elements)
A container displaying elements vertically one by one.
Definition: vbox.cpp:83