UI 组件参考

UI 编辑器目前提供基础控件、输入控件、记录组件和看板组件。

基础展示组件

按钮 Button

用于触发动作。主要属性包括文本、颜色、文字颜色、背景、字号和动作。按钮文字应直接表达结果，例如“查看设备”“播放动画”或“返回总览”。

文本 Text

显示标题、状态或说明。适合短文本，不建议承载大段文档内容。

面板 Panel

作为其他信息的视觉容器，可用于对象详情、说明区和半透明信息层。注意控制背景透明度，保持文字可读。

图片 Image

显示图片，也可以在点击时触发动作。可设置图片地址、替代文本和 cover 等适应方式。用于材质选择时，可以把图片作为目标贴图。

贴图分组 Texture Gallery

用分组和缩略图展示多套贴图，适合产品换肤、材质方案和部件选配。

常用属性包括：

• 分组和每组贴图项；
• 列数、间距和内容边距；
• 缩略图适应方式；
• 外框和标签样式；
• 项目尺寸和标签高度；
• 是否显示项目名称；
• 默认材质贴图动作。

输入与选择组件

组件	主要属性	常见用途
颜色选择器	颜色值、目标、动作	修改模型或材质颜色
开关	标签、布尔值、目标、动作	显示/隐藏对象或 UI
滑块	最小值、最大值、步长、当前值	透明度、进度或数值控制
下拉选择	选项、当前值、动作	方案、状态或模式切换
日期选择器	日期值、动作	单日筛选
日期范围选择器	开始、结束、数据源	查询时间范围

下拉选项应同时设置用户看到的标签和实际值。滑块的最小值、最大值和步长应符合业务单位。

记录组件

记录列表 Record List

显示查询结果，并允许用户选择一条记录。记录中如果包含对象或相机引用，可以进一步高亮对象或移动镜头。

日期范围选择器和记录列表可以组合成“按时间筛选—选择记录—定位设备”的完整流程。使用前需要准备对应数据源。

看板组件

KPI 指标卡

显示一个关键数值。可设置标题、数值字段、单位、小数位和趋势。适合设备数量、产量、温度或告警数。

饼图

按标签和值展示占比。适合设备状态、类型分布和任务比例。

折线图

以 X/Y 字段展示趋势，可设置序列字段、平滑曲线、面积填充、图例和最大点数。

柱形图

比较分类数值，可设置标签、数值、序列和堆叠方式。

仪表盘

展示一个范围内的当前值。需要设置最小值、最大值、单位和数值字段。

数据表格

按列显示多条记录。每一列包含显示名称和数据字段。适合告警、设备状态和事件记录。

组件选择建议

信息目标	推荐组件
展示单个关键结果	KPI 指标卡
展示比例	饼图
展示随时间变化	折线图
比较多个类别	柱形图
展示当前负载或进度	仪表盘
展示可查阅的详细记录	数据表格或记录列表

不要为了视觉丰富同时使用过多图表。每个组件都应对应一个用户问题。