基础元素
| 元素 | 适合制作 |
|---|---|
| 文字 | 标题、说明、数值和变量文本 |
| 图片 | 背景、Logo、图标、立绘和装饰 |
| 按钮 | 菜单入口、确认、关闭和自定义动作 |
| 矩形 | 面板底色、遮罩、描边和分区 |
| 线条 | 分隔线和装饰线 |
| 分组 | 把多个元素作为一个整体移动、排序和复用 |
图片轮播
v1.9.0 新增
- 默认方案：添加多张图片组成播放列表，可调整顺序；少于两张时保持静态显示。
- 停留时间：每张图片的展示时长，默认 3 秒。
- 切换效果：「淡入淡出」（可调过渡时长）或「直接切换」。
- 循环播放：默认开启，播完最后一张从头继续。
轮播条件方案
轮播还支持按变量条件切换整组图片。在「条件方案」中添加方案，每个方案由一组条件（可读取界面状态或游戏变量，支持「全部满足 / 任一满足」）和一组图片组成：- 方案从上到下匹配，第一条命中的生效；都不命中时回退播放默认方案。
- 游戏运行时实时求值切换；编辑器画布按变量初始值预览。
- 典型用法：按好感度、章节进度切换标题画面的背景组图。
表单控件
| 元素 | 适合制作 |
|---|---|
| 下拉 | 跳过模式等枚举选项 |
| 开关 | 全屏、对话时停止语音等布尔设置 |
| 滑块 | 主音量、音乐、音效、语音、文字速度和自动播放速度 |
| 勾选框 | 另一种布尔设置表现形式 |
| 输入框 | 普通文本输入；默认不会自动写入游戏变量 |
| 页签 | 在同一面板中组织多个内容页 |
如果需要把玩家填写的内容写入剧情变量，请使用「输入对话框」智能组件。普通输入框不会自行持久化数据。
智能组件
| 元素 | 内置能力 |
|---|---|
| 存档格子 | 按页显示存档槽位，支持保存和读取模式 |
| 数据列表 | 把扩展存档中的数组显示为卡片或行列表 |
| 词条书 | 显示分类词条、未解锁占位、未读标记和详情，适合辞典与角色档案 |
| CG 鉴赏 | 显示已解锁 CG，并打开大图预览 |
| 音乐鉴赏 | 显示曲目列表，提供播放、暂停和切歌 |
| 片段鉴赏 | 显示已解锁剧情片段并启动回放 |
| 历史记录 | 显示对话历史，并支持语音重放 |
| 对话框 | 兼容旧版复合对话框配置；新样式优先使用拆分图层 |
| 角色名 | 显示当前对白角色名，供对话框样式独立排版 |
| 对白文本 | 显示当前对白正文，供对话框样式独立排版 |
| 对白头像框 | 按当前角色和表情显示头像，供对话框样式设置位置、裁切和边框 |
| 对话工具栏 | 跳过、自动、存读档、快存快读、历史、设置和隐藏对话 |
| 选项列表 | 接收当前分支 Block 的真实选项并返回选择结果 |
| 输入对话框 | 校验玩家输入并写入指定变量 |
| 消息框 | 带一个确认按钮的提示框，支持信息、成功、警告和危险语气 |
词条书
v1.9.0 新增
- 合并全局共享与当前存档的数据源；
- 按分类生成页签；
- 隐藏未解锁词条，或用「???」占位；
- 显示未读标记并调用扩展方法标记已读；
- 绑定玩家主题变量，让玩家切换界面配色。
对话框专用元素
v1.9.0 新增
通用属性
不同元素会显示不同的专属设置，但以下属性大多通用：位置与尺寸
- X、Y 坐标和宽高；
- 九宫格锚点；
- 图层顺序、锁定和隐藏；
- 分组和页签归属。
文字
- 字体、字号、颜色、字重；
- 斜体、下划线、字距；
- 水平与垂直对齐。
外观
- 填充色、描边、圆角和透明度；
- 背景模糊；
- 图片素材和状态图片；
- 旋转、水平镜像和垂直镜像；
- 自定义 CSS。
&:hover、& img 和 @keyframes。它适合补充检查器里没有提供的细节；关键布局仍建议优先使用可视化属性，后续更容易维护。
元素引用名
检查器中的「引用名」供扩展程序查找元素。它在同一个界面里必须唯一，例如：ctx.visualUI 获取它。只有纯可视化界面时，可以不填写。
下一步可以继续了解数据与动作，或者直接回到可视化界面编辑器开始制作。