# Fields

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

**类型**: `submodule`

**描述**: 编辑器字段控件子模块，覆盖布尔、数字、文本、颜色、对象、资源与属性网格等值编辑控件。

## 概述

`Fields` 面向“属性编辑”场景。当前头文件可以分成两层：

- 单字段控件
  - `UIEditorBoolField*`
  - `UIEditorNumberField*`
  - `UIEditorTextField*`
  - `UIEditorEnumField*`
  - `UIEditorColorField*`
  - `UIEditorObjectField*`
  - `UIEditorAssetField*`
  - `UIEditorVector2/3/4Field*`
- 聚合编辑控件
  - `UIEditorPropertyGrid*`
  - 把 section、field row、弹窗菜单和颜色字段等组合成统一 inspector 布局

按当前 `UIEditorPropertyGrid.h`，这一层会复用：

- `Collections` 中的滚动/列表布局能力
- `Shell/UIEditorMenuPopup.h` 提供的弹出菜单能力
- `Widgets/UIEditorFieldRowLayout.h` 和 `UIEditorTextLayout.h` 等基础布局工具

## 公开头文件

- `UIEditorAssetField.h`
- `UIEditorAssetFieldInteraction.h`
- `UIEditorBoolField.h`
- `UIEditorBoolFieldInteraction.h`
- `UIEditorColorField.h`
- `UIEditorColorFieldInteraction.h`
- `UIEditorEnumField.h`
- `UIEditorEnumFieldInteraction.h`
- `UIEditorFieldStyle.h`
- `UIEditorNumberField.h`
- `UIEditorNumberFieldInteraction.h`
- `UIEditorObjectField.h`
- `UIEditorObjectFieldInteraction.h`
- `UIEditorPropertyGrid.h`
- `UIEditorPropertyGridInteraction.h`
- `UIEditorTextField.h`
- `UIEditorTextFieldInteraction.h`
- `UIEditorVector2Field.h`
- `UIEditorVector2FieldInteraction.h`
- `UIEditorVector3Field.h`
- `UIEditorVector3FieldInteraction.h`
- `UIEditorVector4Field.h`
- `UIEditorVector4FieldInteraction.h`

## 当前实现边界

- 当前这里只建立目录索引页，具体头文件页仍需后续逐个补齐。
- 这一层当前偏重 UI 表达与交互状态，不负责真正的资产解析、对象生命周期或命令持久化。

## 相关文档

- [XCEditor](../XCEditor.md)
- [Collections](../Collections/Collections.md)
- [Shell](../Shell/Shell.md)
- [Widgets](../Widgets/Widgets.md)