必须用Animation模式+HTML发布流程导出交互式文档;export命令仅支持静态格式,不支持交互参数,因交互依赖composer.js运行时解析data-composer-link等属性。

Composer 导出交互式文档时,关键不是“设置属性”,而是必须用 Animation 模式 + HTML 发布流程;直接导出 SVG 或 PDF 都不带交互逻辑。
为什么不能在 export 命令里加交互参数?
Composer 的 composer export 命令本身不支持交互式行为配置——它只负责把当前视图转成静态文件(如 --format=svg 或 --format=pdf)。所谓“交互式文档”,实际是 Animation 模式下创建的带时间轴、视图跳转、热点响应的 HTML 页面,底层依赖 composer.js 运行时解析 data-composer-link 等属性。
- 运行
composer export --format=html会失败,因为该命令不存在 - 试图在
export --format=svg输出中手动加<script></script>或绑定 click 事件,导出后会被清空或失效 - 导出的 HTML 文件结构由 Composer 内部模板生成,不开放属性编辑入口
正确导出交互式 HTML 文档的三步操作
必须切换到 Animation 工作区,而非 Design 或 View 模式:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 顶部菜单 → 切换到 Animation 标签页
- 在时间轴上右键 → 添加视图动画(或拖入已有视图),设置起始/结束视角、持续时间
- 顶部菜单 → 发布 → 选择 HTML 格式 → 勾选 包含交互功能(默认开启)和 嵌入 Player Pro
导出后得到一个含 index.html、model.swc、composer.js 的文件夹,打开 index.html 才能触发缩放、旋转、热点点击等行为。
导出后点击无反应?检查这三点
即使正确走 Animation → Publish → HTML 流程,仍可能失效:
- 双击本地打开
index.html(file://协议)→ 浏览器会拦截composer.js加载,必须部署到 HTTP 服务(如php -S localhost:8000) - 热点没生效 → 回头确认是否在 Design 模式下为零件设置了
Link属性(如view://爆炸图),而非仅改颜色 - 视图跳转失败 → 检查发布时是否勾选了 包含所有引用视图,否则目标视图缺失会导致
view://链接静默失败
想控制 HTML 输出结构?只能改 Composer 安装目录里的模板
Composer 不提供用户级 HTML 模板覆盖机制。如果你需要:
- 自定义页面标题 → 修改
%COMPOSER_HOME%\Templates\HTML\index.html(路径因版本而异,需反编译或查安装包) - 注入额外 JS → 在模板中

















