mirror of
https://github.com/ArthurSonzogni/FTXUI.git
synced 2025-12-16 01:48:56 +08:00
Compare commits
6 Commits
copilot/fi
...
252ce67830
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
252ce67830 | ||
|
|
e858bf9809 | ||
|
|
e5652f11ec | ||
|
|
412d8c14e4 | ||
|
|
a3103f5cd4 | ||
|
|
8249fcb41e |
212
.github/copilot-instructions.md
vendored
Normal file
212
.github/copilot-instructions.md
vendored
Normal file
@@ -0,0 +1,212 @@
|
|||||||
|
# FTXUI - Functional Terminal (X) User Interface
|
||||||
|
|
||||||
|
FTXUI is a cross-platform C++ library for terminal-based user interfaces with a functional programming approach, inspired by React.
|
||||||
|
|
||||||
|
**ALWAYS reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the information here.**
|
||||||
|
|
||||||
|
## Working Effectively
|
||||||
|
|
||||||
|
### Build System Setup and Commands
|
||||||
|
- Bootstrap and build the repository:
|
||||||
|
```bash
|
||||||
|
# Basic build (library only) - fast
|
||||||
|
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
|
||||||
|
cmake --build build --parallel $(nproc)
|
||||||
|
# Build time: ~30 seconds. NEVER CANCEL. Set timeout to 120+ seconds.
|
||||||
|
|
||||||
|
# Build with examples
|
||||||
|
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DFTXUI_BUILD_EXAMPLES=ON
|
||||||
|
cmake --build build --parallel $(nproc)
|
||||||
|
# Build time: ~70 seconds. NEVER CANCEL. Set timeout to 180+ seconds.
|
||||||
|
|
||||||
|
# Build with examples and tests
|
||||||
|
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DFTXUI_BUILD_EXAMPLES=ON -DFTXUI_BUILD_TESTS=ON
|
||||||
|
cmake --build build --parallel $(nproc)
|
||||||
|
# Build time: ~113 seconds (includes GoogleTest download). NEVER CANCEL. Set timeout to 300+ seconds.
|
||||||
|
```
|
||||||
|
|
||||||
|
- Alternative build with Ninja (faster):
|
||||||
|
```bash
|
||||||
|
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DFTXUI_BUILD_EXAMPLES=ON
|
||||||
|
ninja -C build
|
||||||
|
# Build time: ~62 seconds. NEVER CANCEL. Set timeout to 180+ seconds.
|
||||||
|
```
|
||||||
|
|
||||||
|
- Run unit tests:
|
||||||
|
```bash
|
||||||
|
# Configure with tests enabled first, then:
|
||||||
|
cd build && ctest --output-on-failure
|
||||||
|
# Test time: ~4 seconds (302 tests). NEVER CANCEL. Set timeout to 60+ seconds.
|
||||||
|
```
|
||||||
|
|
||||||
|
### Bazel Support
|
||||||
|
- FTXUI also supports Bazel build system
|
||||||
|
- **WARNING**: Bazel may fail due to network connectivity issues in sandboxed environments
|
||||||
|
- If Bazel is available:
|
||||||
|
```bash
|
||||||
|
bazel build //... # Build everything
|
||||||
|
bazel test //... # Run tests
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation
|
||||||
|
|
||||||
|
### Manual Testing After Changes
|
||||||
|
- **ALWAYS manually validate changes by building and running examples after making code modifications**
|
||||||
|
- Run example applications to verify functionality:
|
||||||
|
```bash
|
||||||
|
# Build an example first
|
||||||
|
cmake --build build --target ftxui_example_border
|
||||||
|
|
||||||
|
# Run examples (they are interactive, use timeout to terminate)
|
||||||
|
timeout 2s build/examples/dom/ftxui_example_border
|
||||||
|
timeout 2s build/examples/dom/ftxui_example_color_gallery
|
||||||
|
timeout 2s build/examples/component/ftxui_example_button
|
||||||
|
```
|
||||||
|
- Examples should produce visual terminal output with borders, colors, and UI components
|
||||||
|
- **CRITICAL**: Always run at least one DOM example and one Component example to verify both modules work
|
||||||
|
|
||||||
|
### Code Quality and Formatting
|
||||||
|
- Always run formatting before committing:
|
||||||
|
```bash
|
||||||
|
./tools/format.sh
|
||||||
|
# Format time: ~7 seconds. NEVER CANCEL. Set timeout to 60+ seconds.
|
||||||
|
```
|
||||||
|
- The format script adds license headers and runs clang-format on all source files
|
||||||
|
- **Required**: Run formatting or the CI (.github/workflows/build.yaml) will fail
|
||||||
|
|
||||||
|
### Build Validation Requirements
|
||||||
|
- ALWAYS build with both `-DFTXUI_BUILD_EXAMPLES=ON` and `-DFTXUI_BUILD_TESTS=ON` when making changes
|
||||||
|
- Run the complete test suite with `ctest --output-on-failure`
|
||||||
|
- All 302 tests must pass
|
||||||
|
- **Scenario Testing**: Run at least these validation scenarios:
|
||||||
|
1. Build library only (basic validation)
|
||||||
|
2. Build with examples and run 2-3 different examples
|
||||||
|
3. Build with tests and run complete test suite
|
||||||
|
4. Run formatting tool to ensure code style compliance
|
||||||
|
|
||||||
|
## Project Structure
|
||||||
|
|
||||||
|
### Key Directories
|
||||||
|
```
|
||||||
|
/home/runner/work/FTXUI/FTXUI/
|
||||||
|
├── include/ftxui/ # Public header files
|
||||||
|
│ ├── component/ # Interactive component headers
|
||||||
|
│ ├── dom/ # DOM element headers
|
||||||
|
│ ├── screen/ # Screen and rendering headers
|
||||||
|
│ └── util/ # Utility headers
|
||||||
|
├── src/ftxui/ # Implementation files
|
||||||
|
│ ├── component/ # Interactive components (buttons, menus, etc.)
|
||||||
|
│ ├── dom/ # DOM elements (layout, styling, text)
|
||||||
|
│ ├── screen/ # Screen rendering and terminal handling
|
||||||
|
│ └── util/ # Utilities
|
||||||
|
├── examples/ # Example applications
|
||||||
|
│ ├── component/ # Interactive component examples
|
||||||
|
│ └── dom/ # DOM element examples
|
||||||
|
├── cmake/ # CMake configuration files
|
||||||
|
├── tools/ # Development tools (formatting, etc.)
|
||||||
|
└── .github/workflows/ # CI/CD configuration
|
||||||
|
```
|
||||||
|
|
||||||
|
### Core Library Modules
|
||||||
|
FTXUI is organized into three main modules that depend on each other:
|
||||||
|
```
|
||||||
|
┌component──┐ (Interactive UI components)
|
||||||
|
│┌dom──────┐│ (Layout and styling elements)
|
||||||
|
││┌screen─┐││ (Terminal rendering and input)
|
||||||
|
└┴┴───────┴┴┘
|
||||||
|
```
|
||||||
|
|
||||||
|
1. **screen**: Low-level terminal handling, colors, pixels, input
|
||||||
|
2. **dom**: Layout elements (hbox, vbox, text, borders, etc.)
|
||||||
|
3. **component**: Interactive components (buttons, menus, input fields)
|
||||||
|
|
||||||
|
### CMake Build Options
|
||||||
|
| Option | Description | Default |
|
||||||
|
|-----------------------------------|----------------------------------|---------|
|
||||||
|
| FTXUI_BUILD_EXAMPLES | Build example applications | OFF |
|
||||||
|
| FTXUI_BUILD_DOCS | Build documentation | OFF |
|
||||||
|
| FTXUI_BUILD_TESTS | Build and enable tests | OFF |
|
||||||
|
| FTXUI_BUILD_MODULES | Build C++20 modules | OFF |
|
||||||
|
| FTXUI_ENABLE_INSTALL | Generate install targets | ON |
|
||||||
|
| FTXUI_MICROSOFT_TERMINAL_FALLBACK | Windows terminal compatibility | ON/OFF |
|
||||||
|
|
||||||
|
## Common Tasks
|
||||||
|
|
||||||
|
### Building Examples
|
||||||
|
```bash
|
||||||
|
# Build specific examples
|
||||||
|
cmake --build build --target ftxui_example_border
|
||||||
|
cmake --build build --target ftxui_example_button
|
||||||
|
cmake --build build --target ftxui_example_menu
|
||||||
|
|
||||||
|
# List all available examples
|
||||||
|
find build -name "ftxui_example_*" -type f
|
||||||
|
```
|
||||||
|
|
||||||
|
### Running Tests
|
||||||
|
```bash
|
||||||
|
# Run all tests
|
||||||
|
cd build && ctest
|
||||||
|
|
||||||
|
# Run tests with verbose output
|
||||||
|
cd build && ctest --verbose
|
||||||
|
|
||||||
|
# Run specific test pattern
|
||||||
|
cd build && ctest -R "Button" --verbose
|
||||||
|
```
|
||||||
|
|
||||||
|
### Working with Source Code
|
||||||
|
- **Component Development**: Modify files in `src/ftxui/component/` for interactive elements
|
||||||
|
- **DOM Development**: Modify files in `src/ftxui/dom/` for layout and styling
|
||||||
|
- **Screen Development**: Modify files in `src/ftxui/screen/` for terminal rendering
|
||||||
|
- **Adding Examples**: Add new `.cpp` files in `examples/component/` or `examples/dom/`
|
||||||
|
- **Header Files**: Public APIs are in `include/ftxui/[module]/`
|
||||||
|
|
||||||
|
### Integration Patterns
|
||||||
|
When adding FTXUI to a project, use CMake FetchContent (recommended):
|
||||||
|
```cmake
|
||||||
|
include(FetchContent)
|
||||||
|
FetchContent_Declare(ftxui
|
||||||
|
GIT_REPOSITORY https://github.com/ArthurSonzogni/ftxui
|
||||||
|
GIT_TAG v6.1.9
|
||||||
|
)
|
||||||
|
FetchContent_MakeAvailable(ftxui)
|
||||||
|
|
||||||
|
target_link_libraries(your_target PRIVATE
|
||||||
|
ftxui::component # For interactive components
|
||||||
|
ftxui::dom # For layout elements
|
||||||
|
ftxui::screen # For basic rendering
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Build Issues
|
||||||
|
- If CMake configuration fails, ensure C++20 support: `cmake --version` (need 3.12+)
|
||||||
|
- If Ninja build fails, fall back to Make: `cmake -S . -B build` (without `-G Ninja`)
|
||||||
|
- If tests fail to build, GoogleTest download might have failed - check network connectivity
|
||||||
|
- Build artifacts are in `build/` directory - delete with `rm -rf build` to clean
|
||||||
|
|
||||||
|
### Example Issues
|
||||||
|
- Examples are interactive terminal applications - use `timeout` to terminate them
|
||||||
|
- If examples don't display correctly, terminal might not support colors/Unicode
|
||||||
|
- Examples require terminal size of at least 80x24 for proper display
|
||||||
|
|
||||||
|
### Formatting Issues
|
||||||
|
- Format script requires clang-format to be installed
|
||||||
|
- If format script fails, check that source files are not read-only
|
||||||
|
- Format script modifies files in-place - commit changes afterwards
|
||||||
|
|
||||||
|
## Critical Reminders
|
||||||
|
|
||||||
|
- **NEVER CANCEL long-running builds** - they may take 2-3 minutes
|
||||||
|
- **ALWAYS run the formatting tool** before committing changes
|
||||||
|
- **ALWAYS build and test examples** when making component/dom changes
|
||||||
|
- **SET APPROPRIATE TIMEOUTS**: 300+ seconds for builds, 60+ seconds for tests
|
||||||
|
- **BUILD TIMING EXPECTATIONS**:
|
||||||
|
- Basic library: ~30 seconds
|
||||||
|
- With examples: ~70 seconds
|
||||||
|
- With examples + tests: ~113 seconds (first time, includes GoogleTest download)
|
||||||
|
- Subsequent builds: ~60-70 seconds
|
||||||
|
- Tests execution: ~4 seconds
|
||||||
|
- Formatting: ~7 seconds
|
||||||
2
.gitignore
vendored
2
.gitignore
vendored
@@ -28,6 +28,7 @@ out/
|
|||||||
# .github directory:
|
# .github directory:
|
||||||
!.github/**/*.yaml
|
!.github/**/*.yaml
|
||||||
!.github/**/*.yml
|
!.github/**/*.yml
|
||||||
|
!.github/**/*.md
|
||||||
|
|
||||||
# cmake directory:
|
# cmake directory:
|
||||||
!cmake/**/*.in
|
!cmake/**/*.in
|
||||||
@@ -70,3 +71,4 @@ out/
|
|||||||
# tools directory:
|
# tools directory:
|
||||||
!tools/**/*.sh
|
!tools/**/*.sh
|
||||||
!tools/**/*.cpp
|
!tools/**/*.cpp
|
||||||
|
build/
|
||||||
|
|||||||
@@ -365,6 +365,7 @@ Feel free to add your projects here:
|
|||||||
- [SHOOT!](https://github.com/ShingZhanho/ENGG1340-Project-25Spring)
|
- [SHOOT!](https://github.com/ShingZhanho/ENGG1340-Project-25Spring)
|
||||||
- [VerifySN (Fast Hash Tool)](https://github.com/d06i/verifySN)
|
- [VerifySN (Fast Hash Tool)](https://github.com/d06i/verifySN)
|
||||||
- [tic-tac-toe](https://github.com/birland/tic-tac-toe)
|
- [tic-tac-toe](https://github.com/birland/tic-tac-toe)
|
||||||
|
- [typing-speed-test](https://github.com/ymcx/typing-speed-test)
|
||||||
|
|
||||||
### [cpp-best-practices/game_jam](https://github.com/cpp-best-practices/game_jam)
|
### [cpp-best-practices/game_jam](https://github.com/cpp-best-practices/game_jam)
|
||||||
|
|
||||||
@@ -416,9 +417,9 @@ cc_binary(
|
|||||||
name = "your_target",
|
name = "your_target",
|
||||||
srcs = ["your_source.cc"],
|
srcs = ["your_source.cc"],
|
||||||
deps = [
|
deps = [
|
||||||
"@ftxui//:ftxui_component",
|
"@ftxui//:component",
|
||||||
"@ftxui//:ftxui_dom",
|
"@ftxui//:dom",
|
||||||
"@ftxui//:ftxui_screen",
|
"@ftxui//:screen",
|
||||||
],
|
],
|
||||||
)
|
)
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -11,6 +11,9 @@ include(CMakePackageConfigHelpers)
|
|||||||
install(
|
install(
|
||||||
TARGETS screen dom component
|
TARGETS screen dom component
|
||||||
EXPORT ftxui-targets
|
EXPORT ftxui-targets
|
||||||
|
ARCHIVE DESTINATION "${CMAKE_INSTALL_LIBDIR}"
|
||||||
|
LIBRARY DESTINATION "${CMAKE_INSTALL_LIBDIR}"
|
||||||
|
RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}"
|
||||||
)
|
)
|
||||||
|
|
||||||
install(
|
install(
|
||||||
|
|||||||
@@ -39,6 +39,7 @@ example(radiobox)
|
|||||||
example(radiobox_in_frame)
|
example(radiobox_in_frame)
|
||||||
example(renderer)
|
example(renderer)
|
||||||
example(resizable_split)
|
example(resizable_split)
|
||||||
|
example(resizable_split_clamp)
|
||||||
example(scrollbar)
|
example(scrollbar)
|
||||||
example(selection)
|
example(selection)
|
||||||
example(slider)
|
example(slider)
|
||||||
|
|||||||
@@ -3,7 +3,6 @@
|
|||||||
// the LICENSE file.
|
// the LICENSE file.
|
||||||
#include <memory> // for shared_ptr, allocator, __shared_ptr_access
|
#include <memory> // for shared_ptr, allocator, __shared_ptr_access
|
||||||
|
|
||||||
#include "ftxui/component/captured_mouse.hpp" // for ftxui
|
|
||||||
#include "ftxui/component/component.hpp" // for Renderer, ResizableSplitBottom, ResizableSplitLeft, ResizableSplitRight, ResizableSplitTop
|
#include "ftxui/component/component.hpp" // for Renderer, ResizableSplitBottom, ResizableSplitLeft, ResizableSplitRight, ResizableSplitTop
|
||||||
#include "ftxui/component/component_base.hpp" // for ComponentBase
|
#include "ftxui/component/component_base.hpp" // for ComponentBase
|
||||||
#include "ftxui/component/screen_interactive.hpp" // for ScreenInteractive
|
#include "ftxui/component/screen_interactive.hpp" // for ScreenInteractive
|
||||||
@@ -14,17 +13,24 @@ using namespace ftxui;
|
|||||||
int main() {
|
int main() {
|
||||||
auto screen = ScreenInteractive::Fullscreen();
|
auto screen = ScreenInteractive::Fullscreen();
|
||||||
|
|
||||||
auto middle = Renderer([] { return text("middle") | center; });
|
// State:
|
||||||
auto left = Renderer([] { return text("Left") | center; });
|
|
||||||
auto right = Renderer([] { return text("right") | center; });
|
|
||||||
auto top = Renderer([] { return text("top") | center; });
|
|
||||||
auto bottom = Renderer([] { return text("bottom") | center; });
|
|
||||||
|
|
||||||
int left_size = 20;
|
int left_size = 20;
|
||||||
int right_size = 20;
|
int right_size = 20;
|
||||||
int top_size = 10;
|
int top_size = 10;
|
||||||
int bottom_size = 10;
|
int bottom_size = 10;
|
||||||
|
|
||||||
|
// Renderers:
|
||||||
|
auto RendererInfo = [](const std::string& name, int* size) {
|
||||||
|
return Renderer([name, size] {
|
||||||
|
return text(name + ": " + std::to_string(*size)) | center;
|
||||||
|
});
|
||||||
|
};
|
||||||
|
auto middle = Renderer([] { return text("Middle") | center; });
|
||||||
|
auto left = RendererInfo("Left", &left_size);
|
||||||
|
auto right = RendererInfo("Right", &right_size);
|
||||||
|
auto top = RendererInfo("Top", &top_size);
|
||||||
|
auto bottom = RendererInfo("Bottom", &bottom_size);
|
||||||
|
|
||||||
auto container = middle;
|
auto container = middle;
|
||||||
container = ResizableSplitLeft(left, container, &left_size);
|
container = ResizableSplitLeft(left, container, &left_size);
|
||||||
container = ResizableSplitRight(right, container, &right_size);
|
container = ResizableSplitRight(right, container, &right_size);
|
||||||
|
|||||||
43
examples/component/resizable_split_clamp.cpp
Normal file
43
examples/component/resizable_split_clamp.cpp
Normal file
@@ -0,0 +1,43 @@
|
|||||||
|
// Copyright 2025 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 shared_ptr, allocator, __shared_ptr_access
|
||||||
|
|
||||||
|
#include "ftxui/component/component.hpp" // for Renderer, ResizableSplitBottom, ResizableSplitLeft, ResizableSplitRight, ResizableSplitTop
|
||||||
|
#include "ftxui/component/component_base.hpp" // for ComponentBase
|
||||||
|
#include "ftxui/component/screen_interactive.hpp" // for ScreenInteractive
|
||||||
|
#include "ftxui/dom/elements.hpp" // for Element, operator|, text, center, border
|
||||||
|
|
||||||
|
using namespace ftxui;
|
||||||
|
|
||||||
|
int main() {
|
||||||
|
auto screen = ScreenInteractive::Fullscreen();
|
||||||
|
|
||||||
|
// State:
|
||||||
|
int size = 40;
|
||||||
|
int size_min = 10;
|
||||||
|
int size_max = 80;
|
||||||
|
|
||||||
|
// Renderers:
|
||||||
|
auto split = ResizableSplit({
|
||||||
|
.main = Renderer([] { return text("Left") | center; }),
|
||||||
|
.back = Renderer([] { return text("Right") | center; }),
|
||||||
|
.direction = Direction::Left,
|
||||||
|
.main_size = &size,
|
||||||
|
.min = &size_min,
|
||||||
|
.max = &size_max,
|
||||||
|
});
|
||||||
|
|
||||||
|
auto renderer = Renderer(split, [&] {
|
||||||
|
return window(text("Drag the separator with the mouse"),
|
||||||
|
vbox({
|
||||||
|
text("Min: " + std::to_string(size_min)),
|
||||||
|
text("Max: " + std::to_string(size_max)),
|
||||||
|
text("Size: " + std::to_string(size)),
|
||||||
|
separator(),
|
||||||
|
split->Render() | flex,
|
||||||
|
}));
|
||||||
|
});
|
||||||
|
|
||||||
|
screen.Loop(renderer);
|
||||||
|
}
|
||||||
@@ -11,6 +11,7 @@
|
|||||||
#include <ftxui/util/ref.hpp> // for Ref, ConstRef, StringRef
|
#include <ftxui/util/ref.hpp> // for Ref, ConstRef, StringRef
|
||||||
#include <ftxui/util/warn_windows_macro.hpp>
|
#include <ftxui/util/warn_windows_macro.hpp>
|
||||||
#include <functional> // for function
|
#include <functional> // for function
|
||||||
|
#include <limits> // for numeric_limits
|
||||||
#include <string> // for string
|
#include <string> // for string
|
||||||
|
|
||||||
#include "ftxui/component/component_base.hpp" // for Component
|
#include "ftxui/component/component_base.hpp" // for Component
|
||||||
@@ -217,6 +218,10 @@ struct ResizableSplitOption {
|
|||||||
(direction() == Direction::Left || direction() == Direction::Right) ? 20
|
(direction() == Direction::Left || direction() == Direction::Right) ? 20
|
||||||
: 10;
|
: 10;
|
||||||
std::function<Element()> separator_func = [] { return ::ftxui::separator(); };
|
std::function<Element()> separator_func = [] { return ::ftxui::separator(); };
|
||||||
|
|
||||||
|
// Constraints on main_size:
|
||||||
|
Ref<int> min = 0;
|
||||||
|
Ref<int> max = std::numeric_limits<int>::max();
|
||||||
};
|
};
|
||||||
|
|
||||||
// @brief Option for the `Slider` component.
|
// @brief Option for the `Slider` component.
|
||||||
|
|||||||
@@ -4,10 +4,10 @@
|
|||||||
#ifndef FTXUI_COMPONENT_RECEIVER_HPP_
|
#ifndef FTXUI_COMPONENT_RECEIVER_HPP_
|
||||||
#define FTXUI_COMPONENT_RECEIVER_HPP_
|
#define FTXUI_COMPONENT_RECEIVER_HPP_
|
||||||
|
|
||||||
#include <ftxui/util/warn_windows_macro.hpp>
|
|
||||||
#include <algorithm> // for copy, max
|
#include <algorithm> // for copy, max
|
||||||
#include <atomic> // for atomic, __atomic_base
|
#include <atomic> // for atomic, __atomic_base
|
||||||
#include <condition_variable> // for condition_variable
|
#include <condition_variable> // for condition_variable
|
||||||
|
#include <ftxui/util/warn_windows_macro.hpp>
|
||||||
#include <memory> // for unique_ptr, make_unique
|
#include <memory> // for unique_ptr, make_unique
|
||||||
#include <mutex> // for mutex, unique_lock
|
#include <mutex> // for mutex, unique_lock
|
||||||
#include <queue> // for queue
|
#include <queue> // for queue
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
// Copyright 2021 Arthur Sonzogni. All rights reserved.
|
// Copyright 2021 Arthur Sonzogni. All rights reserved.
|
||||||
// Use of this source code is governed by the MIT license that can be found in
|
// Use of this source code is governed by the MIT license that can be found in
|
||||||
// the LICENSE file.
|
// the LICENSE file.
|
||||||
|
#include <algorithm> // for max
|
||||||
#include <ftxui/component/component_options.hpp> // for ResizableSplitOption
|
#include <ftxui/component/component_options.hpp> // for ResizableSplitOption
|
||||||
#include <ftxui/dom/direction.hpp> // for Direction, Direction::Down, Direction::Left, Direction::Right, Direction::Up
|
#include <ftxui/dom/direction.hpp> // for Direction, Direction::Down, Direction::Left, Direction::Right, Direction::Up
|
||||||
#include <ftxui/util/ref.hpp> // for Ref
|
#include <ftxui/util/ref.hpp> // for Ref
|
||||||
@@ -18,34 +19,22 @@
|
|||||||
namespace ftxui {
|
namespace ftxui {
|
||||||
namespace {
|
namespace {
|
||||||
|
|
||||||
class ResizableSplitBase : public ComponentBase {
|
class ResizableSplitBase : public ComponentBase, public ResizableSplitOption {
|
||||||
public:
|
public:
|
||||||
explicit ResizableSplitBase(ResizableSplitOption options)
|
explicit ResizableSplitBase(ResizableSplitOption options)
|
||||||
: options_(std::move(options)) {
|
: ResizableSplitOption(std::move(options)) {
|
||||||
switch (options_->direction()) {
|
switch (direction()) {
|
||||||
case Direction::Left:
|
case Direction::Left:
|
||||||
Add(Container::Horizontal({
|
Add(Container::Horizontal({main, back}));
|
||||||
options_->main,
|
|
||||||
options_->back,
|
|
||||||
}));
|
|
||||||
break;
|
break;
|
||||||
case Direction::Right:
|
case Direction::Right:
|
||||||
Add(Container::Horizontal({
|
Add(Container::Horizontal({back, main}));
|
||||||
options_->back,
|
|
||||||
options_->main,
|
|
||||||
}));
|
|
||||||
break;
|
break;
|
||||||
case Direction::Up:
|
case Direction::Up:
|
||||||
Add(Container::Vertical({
|
Add(Container::Vertical({main, back}));
|
||||||
options_->main,
|
|
||||||
options_->back,
|
|
||||||
}));
|
|
||||||
break;
|
break;
|
||||||
case Direction::Down:
|
case Direction::Down:
|
||||||
Add(Container::Vertical({
|
Add(Container::Vertical({back, main}));
|
||||||
options_->back,
|
|
||||||
options_->main,
|
|
||||||
}));
|
|
||||||
break;
|
break;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -75,27 +64,27 @@ class ResizableSplitBase : public ComponentBase {
|
|||||||
return ComponentBase::OnEvent(event);
|
return ComponentBase::OnEvent(event);
|
||||||
}
|
}
|
||||||
|
|
||||||
switch (options_->direction()) {
|
switch (direction()) {
|
||||||
case Direction::Left:
|
case Direction::Left:
|
||||||
options_->main_size() = std::max(0, event.mouse().x - box_.x_min);
|
main_size() = std::max(0, event.mouse().x - box_.x_min);
|
||||||
return true;
|
break;
|
||||||
case Direction::Right:
|
case Direction::Right:
|
||||||
options_->main_size() = std::max(0, box_.x_max - event.mouse().x);
|
main_size() = std::max(0, box_.x_max - event.mouse().x);
|
||||||
return true;
|
break;
|
||||||
case Direction::Up:
|
case Direction::Up:
|
||||||
options_->main_size() = std::max(0, event.mouse().y - box_.y_min);
|
main_size() = std::max(0, event.mouse().y - box_.y_min);
|
||||||
return true;
|
break;
|
||||||
case Direction::Down:
|
case Direction::Down:
|
||||||
options_->main_size() = std::max(0, box_.y_max - event.mouse().y);
|
main_size() = std::max(0, box_.y_max - event.mouse().y);
|
||||||
return true;
|
break;
|
||||||
}
|
}
|
||||||
|
|
||||||
// NOTREACHED()
|
main_size() = std::clamp(main_size(), min(), max());
|
||||||
return false;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
Element OnRender() final {
|
Element OnRender() final {
|
||||||
switch (options_->direction()) {
|
switch (direction()) {
|
||||||
case Direction::Left:
|
case Direction::Left:
|
||||||
return RenderLeft();
|
return RenderLeft();
|
||||||
case Direction::Right:
|
case Direction::Right:
|
||||||
@@ -111,46 +100,41 @@ class ResizableSplitBase : public ComponentBase {
|
|||||||
|
|
||||||
Element RenderLeft() {
|
Element RenderLeft() {
|
||||||
return hbox({
|
return hbox({
|
||||||
options_->main->Render() |
|
main->Render() | size(WIDTH, EQUAL, main_size()),
|
||||||
size(WIDTH, EQUAL, options_->main_size()),
|
separator_func() | reflect(separator_box_),
|
||||||
options_->separator_func() | reflect(separator_box_),
|
back->Render() | xflex,
|
||||||
options_->back->Render() | xflex,
|
|
||||||
}) |
|
}) |
|
||||||
reflect(box_);
|
reflect(box_);
|
||||||
}
|
}
|
||||||
|
|
||||||
Element RenderRight() {
|
Element RenderRight() {
|
||||||
return hbox({
|
return hbox({
|
||||||
options_->back->Render() | xflex,
|
back->Render() | xflex,
|
||||||
options_->separator_func() | reflect(separator_box_),
|
separator_func() | reflect(separator_box_),
|
||||||
options_->main->Render() |
|
main->Render() | size(WIDTH, EQUAL, main_size()),
|
||||||
size(WIDTH, EQUAL, options_->main_size()),
|
|
||||||
}) |
|
}) |
|
||||||
reflect(box_);
|
reflect(box_);
|
||||||
}
|
}
|
||||||
|
|
||||||
Element RenderTop() {
|
Element RenderTop() {
|
||||||
return vbox({
|
return vbox({
|
||||||
options_->main->Render() |
|
main->Render() | size(HEIGHT, EQUAL, main_size()),
|
||||||
size(HEIGHT, EQUAL, options_->main_size()),
|
separator_func() | reflect(separator_box_),
|
||||||
options_->separator_func() | reflect(separator_box_),
|
back->Render() | yflex,
|
||||||
options_->back->Render() | yflex,
|
|
||||||
}) |
|
}) |
|
||||||
reflect(box_);
|
reflect(box_);
|
||||||
}
|
}
|
||||||
|
|
||||||
Element RenderBottom() {
|
Element RenderBottom() {
|
||||||
return vbox({
|
return vbox({
|
||||||
options_->back->Render() | yflex,
|
back->Render() | yflex,
|
||||||
options_->separator_func() | reflect(separator_box_),
|
separator_func() | reflect(separator_box_),
|
||||||
options_->main->Render() |
|
main->Render() | size(HEIGHT, EQUAL, main_size()),
|
||||||
size(HEIGHT, EQUAL, options_->main_size()),
|
|
||||||
}) |
|
}) |
|
||||||
reflect(box_);
|
reflect(box_);
|
||||||
}
|
}
|
||||||
|
|
||||||
private:
|
private:
|
||||||
Ref<ResizableSplitOption> options_;
|
|
||||||
CapturedMouse captured_mouse_;
|
CapturedMouse captured_mouse_;
|
||||||
Box separator_box_;
|
Box separator_box_;
|
||||||
Box box_;
|
Box box_;
|
||||||
|
|||||||
@@ -233,5 +233,105 @@ TEST(ResizableSplit, NavigationVertical) {
|
|||||||
EXPECT_FALSE(component_bottom->Active());
|
EXPECT_FALSE(component_bottom->Active());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
TEST(ResizableSplit, MinMaxSizeLeft) {
|
||||||
|
int position = 5;
|
||||||
|
auto component = ResizableSplit({
|
||||||
|
.main = BasicComponent(),
|
||||||
|
.back = BasicComponent(),
|
||||||
|
.direction = Direction::Left,
|
||||||
|
.main_size = &position,
|
||||||
|
.separator_func = [] { return separatorDouble(); },
|
||||||
|
.min = 3,
|
||||||
|
.max = 8,
|
||||||
|
});
|
||||||
|
auto screen = Screen(20, 20);
|
||||||
|
Render(screen, component->Render());
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(5, 1)));
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
// Try to resize below min
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(2, 1)));
|
||||||
|
EXPECT_EQ(position, 3); // Clamped to min
|
||||||
|
// Try to resize above max
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(10, 1)));
|
||||||
|
EXPECT_EQ(position, 8); // Clamped to max
|
||||||
|
EXPECT_TRUE(component->OnEvent(MouseReleased(10, 1)));
|
||||||
|
EXPECT_EQ(position, 8);
|
||||||
|
}
|
||||||
|
|
||||||
|
TEST(ResizableSplit, MinMaxSizeRight) {
|
||||||
|
int position = 5;
|
||||||
|
auto component = ResizableSplit({
|
||||||
|
.main = BasicComponent(),
|
||||||
|
.back = BasicComponent(),
|
||||||
|
.direction = Direction::Right,
|
||||||
|
.main_size = &position,
|
||||||
|
.separator_func = [] { return separatorDouble(); },
|
||||||
|
.min = 3,
|
||||||
|
.max = 8,
|
||||||
|
});
|
||||||
|
auto screen = Screen(20, 20);
|
||||||
|
Render(screen, component->Render());
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(14, 1)));
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
// Try to resize below min
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(18, 1)));
|
||||||
|
EXPECT_EQ(position, 3); // Clamped to min
|
||||||
|
// Try to resize above max
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(10, 1)));
|
||||||
|
EXPECT_EQ(position, 8); // Clamped to max
|
||||||
|
EXPECT_TRUE(component->OnEvent(MouseReleased(10, 1)));
|
||||||
|
EXPECT_EQ(position, 8);
|
||||||
|
}
|
||||||
|
|
||||||
|
TEST(ResizableSplit, MinMaxSizeTop) {
|
||||||
|
int position = 5;
|
||||||
|
auto component = ResizableSplit({
|
||||||
|
.main = BasicComponent(),
|
||||||
|
.back = BasicComponent(),
|
||||||
|
.direction = Direction::Up,
|
||||||
|
.main_size = &position,
|
||||||
|
.separator_func = [] { return separatorDouble(); },
|
||||||
|
.min = 2,
|
||||||
|
.max = 10,
|
||||||
|
});
|
||||||
|
auto screen = Screen(20, 20);
|
||||||
|
Render(screen, component->Render());
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(1, 5)));
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
// Try to resize below min
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(1, 1)));
|
||||||
|
EXPECT_EQ(position, 2); // Clamped to min
|
||||||
|
// Try to resize above max
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(1, 15)));
|
||||||
|
EXPECT_EQ(position, 10); // Clamped to max
|
||||||
|
}
|
||||||
|
|
||||||
|
TEST(ResizableSplit, MinMaxSizeBottom) {
|
||||||
|
int position = 5;
|
||||||
|
auto component = ResizableSplit({
|
||||||
|
.main = BasicComponent(),
|
||||||
|
.back = BasicComponent(),
|
||||||
|
.direction = Direction::Down,
|
||||||
|
.main_size = &position,
|
||||||
|
.separator_func = [] { return separatorDouble(); },
|
||||||
|
.min = 3,
|
||||||
|
.max = 12,
|
||||||
|
});
|
||||||
|
auto screen = Screen(20, 20);
|
||||||
|
Render(screen, component->Render());
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(1, 14)));
|
||||||
|
EXPECT_EQ(position, 5);
|
||||||
|
// Try to resize below min
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(1, 18)));
|
||||||
|
EXPECT_EQ(position, 3); // Clamped to min
|
||||||
|
// Try to resize above max
|
||||||
|
EXPECT_TRUE(component->OnEvent(MousePressed(1, 5)));
|
||||||
|
EXPECT_EQ(position, 12); // Clamped to max
|
||||||
|
}
|
||||||
|
|
||||||
} // namespace ftxui
|
} // namespace ftxui
|
||||||
// NOLINTEND
|
// NOLINTEND
|
||||||
|
|||||||
@@ -21,8 +21,8 @@ class TaskRunner {
|
|||||||
auto PostTask(Task task) -> void;
|
auto PostTask(Task task) -> void;
|
||||||
|
|
||||||
/// Schedules a task to be executed after a certain duration.
|
/// Schedules a task to be executed after a certain duration.
|
||||||
auto PostDelayedTask(Task task, std::chrono::steady_clock::duration duration)
|
auto PostDelayedTask(Task task,
|
||||||
-> void;
|
std::chrono::steady_clock::duration duration) -> void;
|
||||||
|
|
||||||
/// Runs the tasks in the queue, return the delay until the next delayed task
|
/// Runs the tasks in the queue, return the delay until the next delayed task
|
||||||
/// can be executed.
|
/// can be executed.
|
||||||
|
|||||||
Reference in New Issue
Block a user