GroveEngine/modules/UIModule/Widgets/UIScrollPanel.h
StillHammer 579cadeae8 feat: Complete UIModule Phase 7 - ScrollPanel & Tooltips
This commit implements Phase 7 of the UIModule, adding advanced features
that make the UI system production-ready.

## Phase 7.1 - UIScrollPanel

New scrollable container widget with:
- Vertical and horizontal scrolling (configurable)
- Mouse wheel support with smooth scrolling
- Drag-to-scroll functionality (drag content or scrollbar)
- Interactive scrollbar with proportional thumb
- Automatic content size calculation
- Visibility culling for performance
- Full styling support (colors, borders, scrollbar)

Files added:
- modules/UIModule/Widgets/UIScrollPanel.h
- modules/UIModule/Widgets/UIScrollPanel.cpp
- modules/UIModule/Core/UIContext.h (added mouseWheelDelta)
- modules/UIModule/UIModule.cpp (mouse wheel event routing)

## Phase 7.2 - Tooltips

Smart tooltip system with:
- Hover delay (500ms default)
- Automatic positioning with edge avoidance
- Semi-transparent background with border
- Per-widget tooltip text via JSON
- Tooltip property on all UIWidget types
- Renders on top of all UI elements

Files added:
- modules/UIModule/Core/UITooltip.h
- modules/UIModule/Core/UITooltip.cpp
- modules/UIModule/Core/UIWidget.h (added tooltip property)
- modules/UIModule/Core/UITree.cpp (tooltip parsing)

## Tests

Added comprehensive visual tests:
- test_28_ui_scroll.cpp - ScrollPanel with 35+ items
- test_29_ui_advanced.cpp - Tooltips on various widgets
- assets/ui/test_scroll.json - ScrollPanel layout
- assets/ui/test_tooltips.json - Tooltips layout

## Documentation

- docs/UI_MODULE_PHASE7_COMPLETE.md - Complete Phase 7 docs
- docs/PROMPT_UI_MODULE_PHASE6.md - Phase 6 & 7 prompt
- Updated CMakeLists.txt for new files and tests

## UIModule Status

UIModule is now feature-complete with:
 9 widget types (Panel, Label, Button, Image, Slider, Checkbox,
   ProgressBar, TextInput, ScrollPanel)
 Flexible layout system (vertical, horizontal, stack, absolute)
 Theme and style system
 Complete event system
 Tooltips with smart positioning
 Hot-reload support
 Comprehensive tests (Phases 1-7)

🚀 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-29 07:13:13 +08:00

95 lines
2.4 KiB
C++

#pragma once
#include "../Core/UIWidget.h"
#include <cstdint>
namespace grove {
/**
* @brief Scrollable container widget with clipping
*
* ScrollPanel extends Panel with scrolling capabilities:
* - Vertical and/or horizontal scrolling
* - Mouse wheel support
* - Optional scrollbars
* - Content clipping (only render visible area)
* - Drag-to-scroll support
*/
class UIScrollPanel : public UIWidget {
public:
UIScrollPanel() = default;
~UIScrollPanel() override = default;
void update(UIContext& ctx, float deltaTime) override;
void render(UIRenderer& renderer) override;
std::string getType() const override { return "scrollpanel"; }
// Scroll configuration
bool scrollVertical = true;
bool scrollHorizontal = false;
bool showScrollbar = true;
bool dragToScroll = true;
// Scroll state
float scrollOffsetX = 0.0f;
float scrollOffsetY = 0.0f;
float contentWidth = 0.0f; // Total content size
float contentHeight = 0.0f;
// Scrollbar appearance
float scrollbarWidth = 8.0f;
uint32_t scrollbarColor = 0x666666FF;
uint32_t scrollbarHoverColor = 0x888888FF;
uint32_t scrollbarBgColor = 0x222222FF;
// Style
uint32_t bgColor = 0x2a2a2aFF;
float borderRadius = 0.0f;
float borderWidth = 1.0f;
uint32_t borderColor = 0x444444FF;
// Interaction state
bool isDraggingContent = false;
bool isDraggingScrollbar = false;
float dragStartX = 0.0f;
float dragStartY = 0.0f;
float scrollStartX = 0.0f;
float scrollStartY = 0.0f;
/**
* @brief Handle mouse wheel scrolling
*/
void handleMouseWheel(float wheelDelta);
/**
* @brief Compute content bounds from children
*/
void computeContentSize();
/**
* @brief Clamp scroll offset to valid range
*/
void clampScrollOffset();
/**
* @brief Get visible content rect (for clipping)
*/
void getVisibleRect(float& outX, float& outY, float& outW, float& outH) const;
/**
* @brief Check if scrollbar is hovered
*/
bool isScrollbarHovered(const UIContext& ctx) const;
/**
* @brief Get scrollbar rect (vertical)
*/
void getScrollbarRect(float& outX, float& outY, float& outW, float& outH) const;
private:
void renderScrollbar(UIRenderer& renderer);
void updateScrollInteraction(UIContext& ctx);
};
} // namespace grove