xuanchi/XCEngine
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(xcui): add tab strip and workspace compose foundations

Browse Source
This commit is contained in:
ssdfasd
2026-04-06 04:27:54 +08:00
parent 3540dbc94d
commit b14a4fb7bb
27 changed files with 2075 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
tests/UI/Runtime/unit/CMakeLists.txt
View File

@@ -1,12 +1,14 @@
set(RUNTIME_UI_TEST_SOURCES
${CMAKE_SOURCE_DIR}/tests/UI/Runtime/unit/test_ui_runtime_shortcut_scope.cpp
${CMAKE_SOURCE_DIR}/tests/UI/Runtime/unit/test_ui_runtime_splitter_validation.cpp
${CMAKE_SOURCE_DIR}/tests/UI/Runtime/unit/test_ui_runtime_tab_strip.cpp
${CMAKE_SOURCE_DIR}/tests/Core/UI/test_ui_runtime.cpp
)
add_executable(runtime_ui_tests ${RUNTIME_UI_TEST_SOURCES})
if(MSVC)
target_compile_options(runtime_ui_tests PRIVATE /FS)
set_target_properties(runtime_ui_tests PROPERTIES
LINK_FLAGS "/NODEFAULTLIB:libcpmt.lib /NODEFAULTLIB:libcmt.lib"
)

245
tests/UI/Runtime/unit/test_ui_runtime_tab_strip.cpp Normal file
View File

@@ -0,0 +1,245 @@
#include <gtest/gtest.h>
#include <XCEngine/Input/InputTypes.h>
#include <XCEngine/UI/Runtime/UIScreenDocumentHost.h>
#include <XCEngine/UI/Runtime/UIScreenPlayer.h>
#include <chrono>
#include <filesystem>
#include <fstream>
#include <string>
namespace {
using XCEngine::Input::KeyCode;
using XCEngine::UI::UIPoint;
using XCEngine::UI::UIRect;
using XCEngine::UI::UIInputEvent;
using XCEngine::UI::UIInputEventType;
using XCEngine::UI::UIPointerButton;
using XCEngine::UI::UIDrawCommand;
using XCEngine::UI::UIDrawCommandType;
using XCEngine::UI::UIDrawData;
using XCEngine::UI::UIDrawList;
using XCEngine::UI::Runtime::UIScreenAsset;
using XCEngine::UI::Runtime::UIScreenFrameInput;
using XCEngine::UI::Runtime::UIScreenPlayer;
using XCEngine::UI::Runtime::UIDocumentScreenHost;
namespace fs = std::filesystem;
class TempFileScope {
public:
TempFileScope(std::string stem, std::string extension, std::string contents) {
const auto uniqueId = std::to_string(
std::chrono::steady_clock::now().time_since_epoch().count());
m_path = fs::temp_directory_path() / (std::move(stem) + "_" + uniqueId + std::move(extension));
std::ofstream output(m_path, std::ios::binary | std::ios::trunc);
output << contents;
}
~TempFileScope() {
std::error_code ec;
fs::remove(m_path, ec);
}
const fs::path& Path() const {
return m_path;
}
private:
fs::path m_path = {};
};
UIScreenAsset BuildScreenAsset(const fs::path& viewPath, const char* screenId) {
UIScreenAsset screen = {};
screen.screenId = screenId;
screen.documentPath = viewPath.string();
return screen;
}
UIScreenFrameInput BuildInputState(std::uint64_t frameIndex) {
UIScreenFrameInput input = {};
input.viewportRect = UIRect(0.0f, 0.0f, 960.0f, 640.0f);
input.frameIndex = frameIndex;
input.focused = true;
return input;
}
std::string BuildTabStripMarkup() {
return
"<View name=\"Runtime TabStrip Test\">\n"
" <Column padding=\"18\" gap=\"10\">\n"
" <TabStrip id=\"workspace-tabs\" tabHeaderHeight=\"34\" tabMinWidth=\"84\">\n"
" <Tab id=\"tab-inspector\" label=\"Inspector\" selected=\"true\">\n"
" <Card title=\"Inspector Content\">\n"
" <Text text=\"Selected: Inspector\" />\n"
" </Card>\n"
" </Tab>\n"
" <Tab id=\"tab-console\" label=\"Console\">\n"
" <Card title=\"Console Content\">\n"
" <Text text=\"Selected: Console\" />\n"
" </Card>\n"
" </Tab>\n"
" <Tab id=\"tab-profiler\" label=\"Profiler\">\n"
" <Card title=\"Profiler Content\">\n"
" <Text text=\"Selected: Profiler\" />\n"
" </Card>\n"
" </Tab>\n"
" </TabStrip>\n"
" </Column>\n"
"</View>\n";
}
bool DrawDataContainsText(
const UIDrawData& drawData,
const std::string& text) {
for (const UIDrawList& drawList : drawData.GetDrawLists()) {
for (const UIDrawCommand& command : drawList.GetCommands()) {
if (command.type == UIDrawCommandType::Text && command.text == text) {
return true;
}
}
}
return false;
}
const UIDrawCommand* FindTextCommand(
const UIDrawData& drawData,
const std::string& text) {
for (const UIDrawList& drawList : drawData.GetDrawLists()) {
for (const UIDrawCommand& command : drawList.GetCommands()) {
if (command.type == UIDrawCommandType::Text && command.text == text) {
return &command;
}
}
}
return nullptr;
}
UIInputEvent MakePointerButtonEvent(
UIInputEventType type,
const UIPoint& position) {
UIInputEvent event = {};
event.type = type;
event.pointerButton = UIPointerButton::Left;
event.position = position;
return event;
}
UIInputEvent MakeKeyDownEvent(KeyCode keyCode) {
UIInputEvent event = {};
event.type = UIInputEventType::KeyDown;
event.keyCode = static_cast<std::int32_t>(keyCode);
return event;
}
} // namespace
TEST(UIRuntimeTabStripValidationTest, EmptyTabStripProducesExplicitFrameError) {
TempFileScope viewFile(
"xcui_runtime_invalid_tab_strip",
".xcui",
"<View name=\"Invalid TabStrip Test\">\n"
" <Column padding=\"16\" gap=\"10\">\n"
" <TabStrip id=\"broken-tabs\" />\n"
" </Column>\n"
"</View>\n");
UIDocumentScreenHost host = {};
UIScreenPlayer player(host);
ASSERT_TRUE(player.Load(BuildScreenAsset(viewFile.Path(), "runtime.invalid_tab_strip")));
const auto& frame = player.Update(BuildInputState(1u));
EXPECT_NE(frame.errorMessage.find("broken-tabs"), std::string::npos);
EXPECT_NE(frame.errorMessage.find("at least 1 Tab child"), std::string::npos);
}
TEST(UIRuntimeTabStripTest, PointerSelectingTabSwitchesVisibleContentAndPersists) {
TempFileScope viewFile("xcui_runtime_tab_strip_pointer", ".xcui", BuildTabStripMarkup());
UIDocumentScreenHost host = {};
UIScreenPlayer player(host);
ASSERT_TRUE(player.Load(BuildScreenAsset(viewFile.Path(), "runtime.tab_strip.pointer")));
const auto& initialFrame = player.Update(BuildInputState(1u));
EXPECT_TRUE(DrawDataContainsText(initialFrame.drawData, "Inspector Content"));
EXPECT_FALSE(DrawDataContainsText(initialFrame.drawData, "Console Content"));
const UIDrawCommand* consoleTab = FindTextCommand(initialFrame.drawData, "Console");
ASSERT_NE(consoleTab, nullptr);
UIScreenFrameInput selectInput = BuildInputState(2u);
selectInput.events.push_back(MakePointerButtonEvent(UIInputEventType::PointerButtonDown, consoleTab->position));
selectInput.events.push_back(MakePointerButtonEvent(UIInputEventType::PointerButtonUp, consoleTab->position));
const auto& selectedFrame = player.Update(selectInput);
EXPECT_FALSE(DrawDataContainsText(selectedFrame.drawData, "Inspector Content"));
EXPECT_TRUE(DrawDataContainsText(selectedFrame.drawData, "Console Content"));
const auto& debugAfterSelect = host.GetInputDebugSnapshot();
EXPECT_EQ(debugAfterSelect.lastResult, "Tab selected");
EXPECT_NE(debugAfterSelect.focusedStateKey.find("/workspace-tabs/tab-console"), std::string::npos);
const auto& persistedFrame = player.Update(BuildInputState(3u));
EXPECT_TRUE(DrawDataContainsText(persistedFrame.drawData, "Console Content"));
EXPECT_FALSE(DrawDataContainsText(persistedFrame.drawData, "Inspector Content"));
}
TEST(UIRuntimeTabStripTest, KeyboardNavigationUpdatesSelectionAndFocus) {
TempFileScope viewFile("xcui_runtime_tab_strip_keyboard", ".xcui", BuildTabStripMarkup());
UIDocumentScreenHost host = {};
UIScreenPlayer player(host);
ASSERT_TRUE(player.Load(BuildScreenAsset(viewFile.Path(), "runtime.tab_strip.keyboard")));
const auto& initialFrame = player.Update(BuildInputState(1u));
const UIDrawCommand* inspectorTab = FindTextCommand(initialFrame.drawData, "Inspector");
ASSERT_NE(inspectorTab, nullptr);
UIScreenFrameInput focusInput = BuildInputState(2u);
focusInput.events.push_back(MakePointerButtonEvent(UIInputEventType::PointerButtonDown, inspectorTab->position));
focusInput.events.push_back(MakePointerButtonEvent(UIInputEventType::PointerButtonUp, inspectorTab->position));
player.Update(focusInput);
UIScreenFrameInput rightInput = BuildInputState(3u);
rightInput.events.push_back(MakeKeyDownEvent(KeyCode::Right));
const auto& consoleFrame = player.Update(rightInput);
EXPECT_TRUE(DrawDataContainsText(consoleFrame.drawData, "Console Content"));
EXPECT_FALSE(DrawDataContainsText(consoleFrame.drawData, "Inspector Content"));
const auto& afterRight = host.GetInputDebugSnapshot();
EXPECT_EQ(afterRight.lastResult, "Tab navigated");
EXPECT_NE(afterRight.focusedStateKey.find("/workspace-tabs/tab-console"), std::string::npos);
UIScreenFrameInput leftInput = BuildInputState(4u);
leftInput.events.push_back(MakeKeyDownEvent(KeyCode::Left));
const auto& inspectorFrameAfterLeft = player.Update(leftInput);
EXPECT_TRUE(DrawDataContainsText(inspectorFrameAfterLeft.drawData, "Inspector Content"));
EXPECT_FALSE(DrawDataContainsText(inspectorFrameAfterLeft.drawData, "Console Content"));
const auto& afterLeft = host.GetInputDebugSnapshot();
EXPECT_EQ(afterLeft.lastResult, "Tab navigated");
EXPECT_NE(afterLeft.focusedStateKey.find("/workspace-tabs/tab-inspector"), std::string::npos);
UIScreenFrameInput endInput = BuildInputState(5u);
endInput.events.push_back(MakeKeyDownEvent(KeyCode::End));
const auto& profilerFrame = player.Update(endInput);
EXPECT_TRUE(DrawDataContainsText(profilerFrame.drawData, "Profiler Content"));
EXPECT_FALSE(DrawDataContainsText(profilerFrame.drawData, "Inspector Content"));
const auto& afterEnd = host.GetInputDebugSnapshot();
EXPECT_EQ(afterEnd.lastResult, "Tab navigated");
EXPECT_NE(afterEnd.focusedStateKey.find("/workspace-tabs/tab-profiler"), std::string::npos);
UIScreenFrameInput homeInput = BuildInputState(6u);
homeInput.events.push_back(MakeKeyDownEvent(KeyCode::Home));
const auto& inspectorFrame = player.Update(homeInput);
EXPECT_TRUE(DrawDataContainsText(inspectorFrame.drawData, "Inspector Content"));
EXPECT_FALSE(DrawDataContainsText(inspectorFrame.drawData, "Profiler Content"));
const auto& afterHome = host.GetInputDebugSnapshot();
EXPECT_EQ(afterHome.lastResult, "Tab navigated");
EXPECT_NE(afterHome.focusedStateKey.find("/workspace-tabs/tab-inspector"), std::string::npos);
}