八荒启自主研发产品

玄武屏使用手册

融万物于一屏 · 以交互动画为魂,重塑演示的边界

89 章 · 持续更新

89
章节
4
版本
v1.0
产品最新版
元素详解

15. HTML 交互组件 html

更新于 2026-10-28

HTML 交互组件是玄武屏第二大类"活的内容"——任意 HTML / JS 实现的交互动画都能嵌入演示。

与 GGB 元素的区别

维度 GGB 元素 HTML 元素
内核 GeoGebra Applet 任意 HTML / JS / Canvas / WebGL
适合 几何 / 代数 / 数学动画 物理仿真 / 数据可视化 / 自定义工具
学习曲线 GGB 学习成本 前端开发能力
沙盒安全 同上 严格沙盒,禁外发请求

典型应用

场景 例子
物理仿真 弹簧振动、电磁感应、流体模拟
数据可视化 D3.js 自定义图表、Three.js 3D 场景
小工具 抽奖器、计时器、互动地图、随机点名
行业仿真 医学:人体 3D;建筑:户型漫游;军事:装备模型
数字孪生 实时数据驱动的 3D 场景

嵌入流程

{
  "type": "html",
  "workId": "BHtml24050001",
  "interactable": true
}

跟 GGB 一样,前端拿到的是 workId,OSS 真实 URL 由服务端鉴权代理,不会泄露。

创作者上传 HTML 组件

到「玄武屏空间 → 我的动画 → 上传」:

  1. 提交 .html 文件 + 配套静态资源(CSS / JS / 图片)
  2. 平台沙盒检测:
    • 无外发 fetch / XHR / WebSocket(除白名单)
    • 无危险 API 调用(eval / Function / document.write)
    • 无访问父页面 cookie / localStorage
  3. 通过审核 → 获得 workId → 可被任何 .xwp 引用

沙盒规则

HTML 组件运行在