Composer 是 PHP 包管理器,不支持关键帧或控制 BOM 显示/隐藏;BOM 显隐需在前端通过 Viewer SDK(如 composer-web-viewer)监听 keyframechange 事件并操作 DOM 实现。

Composer 本身不支持关键帧,也不处理 BOM 表格的显示/隐藏——这是前端渲染逻辑,和 Composer(PHP 包管理器)完全无关。你实际想问的,很可能是用 Three.js、Unity WebGL 或某款 3D 可视化平台(比如 Siemens Xcelerator 的 Teamcenter Visualization,或达索 3DEXPERIENCE 的 Composer Web Viewer)在网页中加载模型后,通过动画时间轴控制 BOM 面板的显隐。
为什么 Composer 命令行或 composer.json 无法控制 BOM 显示
Composer 是 PHP 生态的依赖管理工具,只负责下载、安装、自动加载类库(如 symfony/console)。它没有 DOM 操作能力,不解析 HTML/CSS/JS,更不参与 3D 渲染或 UI 动画。所谓“关键帧”,属于前端时间轴动画范畴,必须由运行时 JS 控制。
常见混淆点:
- 把“SolidWorks Composer”桌面软件误称为“Composer”——它确实有关键帧和 BOM 面板,但那是封闭桌面应用,不走 Composer(PHP)
- 把项目里用了 Composer 安装某个可视化 SDK(如
cesiumjs),就以为 Composer 在管动画逻辑 - 在 Web 端调用 Composer Web Viewer API 时,误以为播放关键帧会自动联动 UI 元素
composer-web-viewer 中用关键帧触发 BOM 显隐的正确做法
如果你用的是 Siemens 提供的 composer-web-viewer(基于 WebGL 的轻量化查看器),它的关键帧(Keyframe)仅驱动模型变换(位置/旋转/缩放/可见性),**不会自动同步到外部 HTML 元素(如 BOM 表格)**。必须手动监听事件并操作 DOM。
实操要点:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 用
viewer.playAnimation()播放含关键帧的动画序列 - 监听
viewer.on('keyframechange', callback)(具体事件名依 SDK 版本而定,常见为onKeyframeChange或onTimelineUpdate) - 在回调中根据当前关键帧 ID 或时间戳,用
document.getElementById('bom-table').style.display控制显隐 - 注意:BOM 表格需提前用 HTML 写好,且 id 或 class 可被 JS 获取;不能指望 viewer 自动渲染 BOM 到页面
示例片段(伪代码,以官方 JS API 为准):
viewer.on('keyframechange', (e) => {
if (e.keyframeId === 'show_bom_step') {
document.getElementById('bom-table').style.display = 'table';
} else if (e.keyframeId === 'hide_bom_step') {
document.getElementById('bom-table').style.display = 'none';
}
});
用 CSS 关键帧 + JS 控制 BOM 的兼容方案
如果不用厂商 SDK,而是自己用 Three.js 或 Babylon.js 加载模型,那么“关键帧”就得自己实现时间轴逻辑。此时推荐用 CSS 动画配合 JS 触发类名切换,比硬写 setTimeout 更可靠。
关键条件:
- BOM 表格容器需有明确 class,如
class="bom-panel" - 定义 CSS 动画:
@keyframes bomFadeIn { from { opacity: 0; } to { opacity: 1; } } - JS 在关键时间点添加/移除 class:
el.classList.add('animate-bom-in'),对应 CSS 中.animate-bom-in { animation: bomFadeIn 0.3s ease; } - 避免直接操作
display——它不可动画,改用opacity+visibility组合
真正卡住人的地方,往往不是怎么写动画,而是没分清「谁在驱动时间轴」:是 Composer(错)、是 Viewer SDK 的 timeline(对)、还是你自己写的 requestAnimationFrame 循环(也对)。一旦绑定错事件源,关键帧永远触不到 BOM。

















