Appearance
可视化平台
可视化平台（ricon-viz）是一个低代码数据可视化大屏工具：从图元库把图表与页面元素拖拽到画布，在右侧面板配置样式与数据，保存后即可预览和发布大屏。
核心能力
- 拖拽搭建：左侧图元库按「大分类 → 分组」组织，选中后拖入画布即按默认尺寸落位，覆盖基础 / ECharts / VChart / 信息 / 列表 / 图标 / 小组件 / 图片八大分类。
- 数据接入：图元数据支持静态数据（直接编辑 JSON）与动态请求（图元内配置一次请求），并支持字段映射与预览页轮询刷新。
- 主题与外观：设计器深 / 浅色皮肤、界面主色、大屏内图元配色三层分开配置，互不干扰。
- 预览与发布：独立只读预览页（
/viewer）按四种适配方式铺满视口，支持导出 / 导入场景、发布与分享。
低代码不是「银弹」，请理智看待它的适用边界：适合标准化图表、仪表盘、监控大屏；不适合高度定制的交互与复杂业务表单。
两大环节
- 可视化设计器（路由
/designer/:reportCode）：顶部工具栏 + 左中右三栏 + 底部栏。从左侧图元库拖入图元，在右侧「配置 / 数据 / 动画 / 事件」标签里调整，画布支持框选、网格吸附、标尺与参考线、右键菜单，点击保存即可保存内容：登录并开通套餐后同步云端，未登录时自动保存为浏览器本地草稿。详见工作空间。 - 大屏预览（路由
/viewer?reportCode=xxx）：只读渲染，无设计器 UI；按大屏适配方式铺满浏览器视口，动态数据按组件间隔轮询刷新，交互事件在预览页生效。详见预览与发布。
文档地图
| 分组 | 页面 | 说明 |
|---|---|---|
| 产品与入门 | ||
| 产品与入门 | 可视化平台（本页） | 总览：定位、核心能力、文档地图与学习路径 |
| 产品与入门 | 产品简介 | 三块业务、安装启动编译与浏览器支持 |
| 产品与入门 | 快速上手 | 大屏管理 → 设计 → 预览全链路与数据持久化 |
| 设计器使用 | ||
| 设计器使用 | 界面导览 | 设计器顶部工具栏、底部栏与右侧各配置标签 |
| 设计器使用 | 工作空间 | 三栏布局、图元库分类、画布、标尺、参考线与图元交互 |
| 设计器使用 | 图元介绍 | 图元的数据结构、生命周期、图元形态与图元库分类清单 |
| 设计器使用 | 数据接入 | 静态数据、动态请求、字段映射与取数轮询 |
| 设计器使用 | 主题与外观 | 设计器深 / 浅色皮肤、界面主色与图元默认配色 |
| 设计器使用 | 快捷键与右键菜单 | 键盘快捷键与画布右键菜单 |
| 设计器使用 | 历史记录 | 撤销 / 重做的快照机制与覆盖范围 |
| 设计器使用 | 预览与发布 | 预览路由、四种适配方式、运行时行为与发布分享 |
| 二次开发 | ||
| 二次开发 | 目录结构 | 工程目录与设计器各模块职责 |
| 二次开发 | 新增基础图元组件 | 文本 / 图片 / 视频等信息类轻量图元的扩展方式 |
| 二次开发 | 新增 ECharts 图表组件 | 有分区配置能力的标准图表图元的扩展方式 |
| 二次开发 | 多语言切换 | 界面中英文切换与文案维护 |
| 参考 | ||
| 参考 | 常见问题 | 启动、编译、网格、数据刷新、主题等高频问题 |
建议学习路径
新手按 快速上手 → 工作空间 → 图元介绍 → 数据接入 → 预览与发布 的顺序阅读，即可跑通「新建大屏 → 拖拽配置 → 接数据 → 保存 → 预览」的完整链路；需要二次开发时再读 目录结构 → 新增图元组件 / 多语言切换，遇到问题查 常见问题。
与 2D 组态的关系
在 ricon 产品矩阵中，可视化平台（ricon-viz）与 2D 组态、3D 组态、物联网平台并列，是独立的文档分区（站点以 /viz/ 前缀区分）。
两者定位不同：
- 2D 组态面向工业物联网（IIoT）与 SCADA，核心是实时数据监控画面：
dataId变量绑定、HTTP / WebSocket / MQTT 三通道实时通信、交互联动与在线运行。 - 可视化平台面向标准化图表与数据大屏搭建：拖拽「图元」编排，数据来源为静态数据或动态请求，侧重图表呈现与多屏适配。
二者各自独立、互不依赖；本分区只介绍可视化平台。