元素
Element 组件用于在具有 Screen 祖先组件的层级中，构建由图像、文本等二维内容组成的用户界面。它提供锚点和轴心等布局属性。
锚点、轴心、边距和尺寸详见元素；图像和文本分别详见图像元素与文本元素。
组元素
组元素仅提供 Element 组件的布局属性。
图像元素
图像元素通过纹理资源、精灵资源或纯色显示图像。
文本元素
文本元素使用字体资源渲染字符串。
通用组件属性
| 属性 | 说明 |
|---|---|
| 类型（Type） | 元素类型：Group（组）、Image（图像）或 Text（文本）。 |
| 预设（Preset） | 选择布局预设时，自动将 Anchor 和 Pivot 设为预设值。 |
| 锚点（Anchor） | 决定元素计算相对位置的参照，详见锚点。 |
| 轴心（Pivot） | 元素的轴心位置，(0, 0) 为左下角，(1, 1) 为右上角，详见轴心。 |
| 自动宽度（Auto Width） | 仅文本，根据文本内容自动计算宽度。 |
| 自动适配宽度（Auto Fit Width） | 仅文本，自动减小字号，使文本适合元素宽度。 |
| 宽度（Width） | 元素宽度，单位为像素。启用 Auto Width 或水平锚点分离时可能不可编辑。 |
| 自动高度（Auto Height） | 仅文本，根据文本内容自动计算高度。 |
| 自动适配高度（Auto Fit Height） | 仅文本，自动减小字号，使文本适合元素高度。 |
| 高度（Height） | 元素高度，单位为像素。启用 Auto Height 或垂直锚点分离时可能不可编辑。 |
| 边距（Margin） | 元素边缘到锚点的距离，仅在锚点分离，即至少一轴上的锚点值不相等时可用。顺序为左、下、右、上。 |
| 使用输入（Use Input） | 将元素加入输入检测列表，检测并触发相关事件。 |
| 批处理组（Batch Group） | 元素所属批处理组，详见批处理。 |
| 图层（Layers） | 元素渲染到的图层，详见图层。 |
图像组件属性
| 属性 | 说明 |
|---|---|
| 颜色（Color） | 元素染色。 |
| 不透明度（Opacity） | 0 为完全透明，1 为完全不透明。 |
| 矩形（Rect） | 显示的纹理区域，使用归一化 U、V、宽、高指定，仅使用纹理时显示。 |
| 遮罩（Mask） | 将图像元素变为遮罩。遮罩本身不显示，仅限制子元素在其覆盖区域内渲染。遮罩与子元素必须在同一图层，否则子元素不会绘制，详见遮罩与图层及遮罩。 |
| 纹理（Texture） | 要显示的纹理资源。Texture、Sprite 和 Material 只能分配其中一种。 |
| 精灵（Sprite） | 要显示的精灵资源。Texture、Sprite 和 Material 只能分配其中一种。 |
| 帧（Frame） | 精灵帧索引，仅分配 Sprite 时显示。 |
| 每单位像素数（Pixels Per Unit） | 组件坐标系中一个单位对应的像素数，仅分配 Sprite 时显示。 |
| 材质（Material） | 用于渲染的自定义材质资源。Texture、Sprite 和 Material 只能分配其中一种。 |
| 适配模式（Fit Mode） | 图像在元素边界内的适配方式：Stretch（拉伸，默认）、Contain（保持比例并完整容纳）、Cover（保持比例并填满）。仅分配纹理或精灵时显示。 |
文本组件属性
| 属性 | 说明 |
|---|---|
| 对齐（Alignment） | 文本在元素内的对齐，(0, 0) 为左下角，(1, 1) 为右上角。 |
| 字体（Font） | 渲染文本使用的字体资源。 |
| 本地化（Localized） | 使用 Key 属性在本地化数据中查找文本。 |
| 文本（Text） | 要显示的字符串，仅禁用 Localized 时显示。 |
| 键（Key） | 查找译文使用的本地化键，仅启用 Localized 时显示。 |
| 启用标记（Enable Markup） | 允许文本包含颜色、加粗等样式标记。 |
| 字号（Font Size） | 以 Screen 组件像素为单位的字体大小，仅禁用 Auto Fit Width 和 Auto Fit Height 时显示。 |
| 最小字号（Min Font Size） | 自动适配宽度或高度时使用的最小字号。 |
| 最大字号（Max Font Size） | 自动适配宽度或高度时使用的最大字号。 |
| 行高（Line Height） | 换行时向下移动的距离，单位为 Screen 组件像素。 |
| 自动换行（Wrap Lines） | 文本超出元素宽度时换到下一行。 |
| 两端对齐（Justify） | 增大词间距，使自动换行的文本行对齐两侧边缘。仅启用 Wrap Lines 且禁用 Auto Width 时显示。 |
| 最大行数（Max Lines） | 显示的最大行数，超出部分被裁切。仅启用 Wrap Lines 时显示。 |
| 字间距（Spacing） | 字符间距倍率。 |
| 颜色（Color） | 字体染色。 |
| 不透明度（Opacity） | 0 为完全透明，1 为完全不透明。 |
| 描边颜色（Outline Color） | 文本轮廓颜色，包含控制不透明度的 Alpha。 |
| 描边厚度（Outline Thickness） | 0 为无描边，1 为最大厚度。 |
| 阴影颜色（Shadow Color） | 文本阴影颜色，包含控制不透明度的 Alpha。 |
| 阴影偏移（Shadow Offset） | 阴影相对文本的水平与垂直偏移。 |
另请参阅
- Screen 组件：用户界面的根组件。
- Button 组件：交互按钮元素。
- LayoutGroup 组件：自动布局子元素。
- LayoutChild 组件：覆盖单个元素的布局行为。
- 元素：锚点、轴心、边距与尺寸。
- 图像元素与文本元素：绘制图像和文本。
- 用户界面：进一步了解界面构建。
脚本接口
可以通过 Script 组件控制 Element 组件属性。接口详见 ElementComponent。