@apollo/sandbox

中文文档
2.7.4发布于 2026/01/09MITTypeScriptESM + CJS近 30 天下载 14.9万

这个 repo 主机为 Aporo Studio 的可嵌入沙盒的源文件

中文使用文档
文档目录6 节
  1. 使用 @ apollo/ sandbox npm 软件包
  2. 反应
  3. 香草联署材料
  4. 原始 cdn 主机 umd 文件的实例
  5. 开发嵌入式沙盒
  6. 以反应为例开发嵌入式沙盒

阿波罗工作室可嵌入沙盒

这个 repo 主机为 Aporo Studio 的可嵌入沙盒的源文件

使用详情见文件

使用 @ apollo/ sandbox npm 软件包

您可以下载 @ apollo/ sandbox npm 软件包 npm install @apollo/sandbox。然后,您可以导入 AporoSandbox 类或 AporoSandbox 反应组件 :

import { ApolloSandbox } from '@apollo/sandbox';
import { ApolloSandbox } from '@apollo/sandbox/react';

当你用一个 target 在你的应用软件中,Sandbox会出现在这个元素的iframe中。 检查所有的 配置选项 你的图表.

反应

import { ApolloSandbox } from '@apollo/sandbox/react';

function App() {

  return (
    <ApolloSandbox />
  );
}

香草联署材料

import { ApolloSandbox } from '@apollo/sandbox';

function App() {

  ...
  new ApolloSandbox({
      target: '#embeddableSandbox',
  })
  ...

}
...
// style the iframe for your site
<style>
  iframe {
    height: 100%;
    width: 100%;
    border: none;
  }
</style>
<div id="embeddableSandbox" />

原始 cdn 主机 umd 文件的实例

开发嵌入式沙盒

运行 npm run build:umd 以构建嵌入式Sandbox在窗口上曝光的 umd 文件.

打开 examples/localDevelopmentExample.html 测试您的变化。 (如果来源未设定, 请运行本地DevelopmentExample.html from Live Server(中文(简体) )

安装 Live Server 扩展到 localDevelopmentExample.html 点击“Go Live” Screen Shot 2022-04-27 at 4 34 53 PM

以反应为例开发嵌入式沙盒

运行 npm run build:cjs-esm 用于构建 cjs & esm 文件,其中阿波罗Sandbox & 阿波罗Sandbox React 被命名为导出.

我们有一个反应实例应用程序,它使用我们的阿波罗Sandbox反应组件,使嵌入式沙盒位于src/examples/resact-example. 举个例子, npm run build 财务报告和审定财务报表 npm run start 内 react-example。在重建新的更改前,请确保删除 .parcel-cache 文件夹。 (TODO去掉包裹缓存)

版本与发布记录

@apollo/sandbox 共发布 24 个版本,首次发布于 2022/07/01;过去 12 个月发布了 1 个版本。

版本发布日期距今
2.7.4latest2026/01/099 个月前
2.7.32025/10/011.1 年前
2.7.22025/09/191.1 年前
2.7.12025/03/111.7 年前
2.7.02024/09/112 年前
2.6.02024/05/302 年前

其他发布通道:beta → 0.1.0-beta.0。

关于 @apollo/sandbox 的常见问题

@apollo/sandbox 是什么?

这个 repo 主机为 Aporo Studio 的可嵌入沙盒的源文件

如何安装 @apollo/sandbox?

在项目目录运行 npm install @apollo/sandbox,或使用 pnpm add / yarn add / bun add。

@apollo/sandbox 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@apollo/sandbox 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@apollo/sandbox 可以商用吗?

@apollo/sandbox 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@apollo/sandbox 的下载量有多少?

根据 npm 官方下载统计,@apollo/sandbox 在 2026/10/07 – 2026/11/05 这 30 天内被下载 148,963 次,日均约 4,965 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@apollo/sandbox 还在维护吗?

最新版本 2.7.4 发布于 2026/01/09(9 个月前);至今共发布 24 个版本,其中过去 12 个月发布了 1 个;首次发布于 2022/07/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。