# Widgets

**命名空间**: `XCEngine::UI::Editor::Widgets`

**类型**: `submodule`

**描述**: 编辑器基础 UI 原语子模块，覆盖集合控件标签分类、通用文本布局、字段行布局与颜色工具。

## 概述

`Widgets` 不是完整控件集合，而是被 `Collections`、`Fields` 和 `Shell` 反复复用的低层工具头文件：

- `UIEditorCollectionPrimitives.h`
  - 统一描述 scroll/tree/list/property-section/field-row 等标签的分类和布局属性
- `UIEditorColorUtils.h`
  - 颜色与视觉辅助函数
- `UIEditorFieldRowLayout.h`
  - 字段标签列 / 控件列的基础布局工具
- `UIEditorTextLayout.h`
  - 文本高度、顶边与裁剪矩形的内联 helper

这些类型被 `UIEditorTheme.h`、`UIEditorPropertyGrid.h`、`UIEditorShellCompose.h` 等更高层模块直接复用。

## 公开头文件

- `UIEditorCollectionPrimitives.h`
- `UIEditorColorUtils.h`
- `UIEditorFieldRowLayout.h`
- `UIEditorTextLayout.h`

## 当前实现边界

- 当前这里只建立目录索引页，具体头文件页仍需后续逐个补齐。
- 这一层主要提供纯函数和轻量布局工具，不承担 panel / workspace 级状态管理。

## 相关文档

- [XCEditor](../XCEditor.md)
- [Collections](../Collections/Collections.md)
- [Fields](../Fields/Fields.md)
- [Foundation](../Foundation/Foundation.md)