ArthurSonzogni/FTXUI
GitHub: ArthurSonzogni/FTXUI
一个用于构建跨平台终端用户界面的现代化 C++ 库，函数式风格驱动高效开发。
Stars: 9945 | Forks: 578
文档 ·
报告错误 ·
示例 .
请求功能 ·
提交拉取请求
文档：
English |
Français |
Español |
繁體中文 |
简体中文 |
日本語 |
# FTXUI
Functional Terminal (X) User interface
一个用于基于终端用户界面的简单跨平台 C++ 库！
## 功能
* 函数式风格。灵感来自
[1](https://hackernoon.com/building-reactive-terminal-interfaces-in-c-d392ce34e649?gi=d9fb9ce35901)
和 [React](https://reactjs.org/)
* 简单优雅的语法（在我看来）
* 键盘与鼠标导航。
* 支持 [UTF8](https://en.wikipedia.org/wiki/UTF-8) 和 [全宽字符](https://en.wikipedia.org/wiki/Halfwidth_and_fullwidth_forms)（→ 测试）
* 支持动画。[演示 1](https://arthursonzogni.github.io/FTXUI/examples/?file=component/menu_underline_animated_gallery), [演示 2](https://arthursonzogni.github.io/FTXUI/examples/?file=component/button_style)
* 支持绘制。[演示](https://arthursonzogni.github.io/FTXUI/examples/?file=component/canvas_animated)
* 无依赖。
* [C++20 模块支持](https://arthursonzogni.github.io/FTXUI/cpp20-modules.html)
* **跨平台**：Linux/MacOS（主要目标）、WebAssembly、Windows（感谢贡献者！）。
* 通过 [示例](#documentation) 和 [教程](#documentation) 学习
* 多个软件包：
- CMake [FetchContent]([https://bewagner.net/programming/2020/05/02/cmake-fetchcontent/](https://cmake.org/cmake/help/latest/module/FetchContent.html))（首选）
- [Bazel](https://registry.bazel.build/modules/ftxui)
- [vcpkg](https://vcpkg.link/ports/ftxui)
- [Conan](https://conan.io/center/recipes/ftxui) [Debian 包](https://tracker.debian.org/pkg/ftxui)
- [Ubuntu 包](https://launchpad.net/ubuntu/+source/ftxui)
- [Arch Linux](https://aur.archlinux.org/packages/ftxui/)
- [OpenSUSE](https://build.opensuse.org/package/show/devel:libraries:c_c++/ftxui)
- [XMake](https://xmake.io) 仓库 [软件包](https://github.com/xmake-io/xmake-repo/blob/dev/packages/f/ftxui/xmake.lua)
- [Nix](https://github.com/ArthurSonzogni/FTXUI/blob/main/flake.nix)
* 良好实践：文档、测试、模糊测试、性能测试、自动化 CI、自动化打包等...
## 文档
- [CMake 入门](https://github.com/ArthurSonzogni/ftxui-starter)
- [Bazel 入门](https://github.com/ArthurSonzogni/ftxui-bazel)
- [文档](https://arthursonzogni.github.io/FTXUI/)
- [示例（WebAssembly）](https://arthursonzogni.github.io/FTXUI/examples/)
- [使用 CMake 构建](https://arthursonzogni.github.io/FTXUI/#build-cmake)
- [使用 Bazel 构建](https://arthursonzogni.github.io/FTXUI/#build-bazel)
## 示例
```
vbox({
hbox({
text("one") | border,
text("two") | border | flex,
text("three") | border | flex,
}),
gauge(0.25) | color(Color::Red),
gauge(0.50) | color(Color::White),
gauge(0.75) | color(Color::Blue),
});
```
## 简要画廊
#### DOM
该模块定义了一组层次化的 Element。一个 Element 管理布局并能响应终端尺寸变化。
它们在 [
](https://arthursonzogni.github.io/FTXUI/elements_8hpp_source.html
) 中声明
布局
Element 可以组合在一起：
- 水平排列使用 `hbox`
- 垂直排列使用 `vbox`
- 在网格中使用 `gridbox`
- 使用 `flexbox` 沿一个方向自动换行
Element 可以通过 `flex` 修饰器变为弹性布局。
[示例](https://arthursonzogni.github.io/FTXUI/examples_2dom_2vbox_hbox_8cpp-example.html) 使用 `hbox`、`vbox` 和 `filler`。
[示例](https://arthursonzogni.github.io/FTXUI/examples_2dom_2gridbox_8cpp-example.html) 使用 gridbox：
[示例](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/dom/hflow.cpp) 使用 flexbox：
[查看](https://arthursonzogni.github.io/FTXUI/examples_2dom_2hflow_8cpp-example.html) 以及这个 [演示](https://arthursonzogni.github.io/FTXUI/examples/?file=component/flexbox)。
样式
Element 可以使用以下函数进行装饰：
- `bold`
- `italic`
- `dim`
- `inverted`
- `underlined`
- `underlinedDouble`
- `blink`
- `strikethrough`
- `color`
- `bgcolor`
- `hyperlink`
[示例](https://arthursonzogni.github.io/FTXUI/examples_2dom_2style_gallery_8cpp-example.html)
FTXUI 支持管道操作符。这意味着：`decorator1(decorator2(element))` 和 `element | decorator1 | decorator2` 可以混用。
颜色
FTXUI 支持所有颜色调色板：
颜色 [画廊](https://arthursonzogni.github.io/FTXUI/examples_2dom_2color_gallery_8cpp-example.html)：
边框与分隔线
使用修饰器 `border` 和元素分隔函数 `separator()` 来划分界面：
```
auto document = vbox({
text("top"),
separator(),
text("bottom"),
}) | border;
```
[演示](https://arthursonzogni.github.io/FTXUI/examples_2dom_2separator_8cpp-example.html):
文本与段落
一段简单的文本使用 `text("内容")` 表示。
要支持文本自动换行，提供以下函数：
```
Element paragraph(std::string text);
Element paragraphAlignLeft(std::string text);
Element paragraphAlignRight(std::string text);
Element paragraphAlignCenter(std::string text);
Element paragraphAlignJustify(std::string text);
```
[段落示例](https://arthursonzogni.github.io/FTXUI/examples_2dom_2paragraph_8cpp-example.html)
表格
一个用于轻松美化表格数据的类。
[示例](https://arthursonzogni.github.io/FTXUI/examples_2dom_2table_8cpp-example.html):
画布
绘图可以使用画布完成，支持点阵、块状或简单字符：
简单 [示例](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/dom/canvas.cpp):
复杂 [示例](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/component/canvas_animated.cpp):
画廊
[组件画廊](https://arthursonzogni.github.io/FTXUI/examples_2component_2gallery_8cpp-example.html)（[演示](https://arthursonzogni.github.io/FTXUI/examples/?file=component/gallery)）
单选框
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2radiobox_8cpp-example.html):
复选框
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2checkbox_8cpp-example.html):
输入框
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2input_8cpp-example.html):
切换
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2toggle_8cpp-example.html):
滑块
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2slider_8cpp-example.html):
菜单
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2menu_8cpp-example.html):
可调整分割
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2resizable_split_8cpp-example.html):
下拉菜单
[示例](https://arthursonzogni.github.io/FTXUI/examples_2component_2dropdown_8cpp-example.html):
标签页
[垂直](https://arthursonzogni.github.io/FTXUI/examples_2component_2tab_vertical_8cpp-example.html):
[水平](https://arthursonzogni.github.io/FTXUI/examples_2component_2tab_horizontal_8cpp-example.html):
标签：AI工具, Bash脚本, C++, C++库, FTXUI, Functional Terminal UI, GitHub热门, GUI库, HTTP 参数枚举, TTY, 代码示例, 命令行界面, 威胁情报, 开发者工具, 开源库, 控制台UI, 搜索引擎爬虫, 数据分析, 数据擦除, 文本界面, 文档齐全, 终端工具, 终端用户界面