@cubejs-client/playground

中文文档
1.8.21发布于 2026/11/10MITTypeScriptES Module构建来源已验证近 30 天下载 8811

Cube

原始使用文档

Cube

Website • Docs • Blog • Slack • Twitter

npm version GitHub Actions

Cube Playground

UI for Cube development server environment.

Learn more

React Components

@cubejs-client/playground provides standalone components you can embed in your application.

import { QueryBuilder } from '@cubejs-client/playground';
// import the antd styles from the `@cubejs-client/playground` package as it overrides some variables
import '@cubejs-client/playground/lib/antd.min.css';
// alternatively you can use the default antd styles
// import 'antd/dist/antd.min.css';

const apiUrl = 'http://localhost:4000/cubejs-api/v1';
const token = 'your.token';

export default function App() {
  const query = {
    measures: ['Orders.count'],
    dimensions:  ['Orders.status']
  };

  return (
    <QueryBuilder
      apiUrl={apiUrl}
      token={token}
      initialVizState={{
        query
      }}
    />
  );
}

Also, you will need to move the Playground chart renderers to a public folder. Assuming the publicly accessible folder is public, you can execute the following script from the root of your application

#!/bin/bash

rm -rf ./public/chart-renderers 2> /dev/null
cp -R ./node_modules/@cubejs-client/playground/public/chart-renderers ./public

License

Cube Client Core is MIT licensed.

版本与发布记录

@cubejs-client/playground 共发布 710 个版本,首次发布于 2019/03/07;过去 12 个月发布了 173 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.8.21latest2026/11/101 天前
1.4.62026/11/101 天前
1.6.772026/11/074 天前
1.8.202026/11/064 天前
1.8.192026/11/065 天前
1.8.182026/11/037 天前

关于 @cubejs-client/playground 的常见问题

如何安装 @cubejs-client/playground?

在项目目录运行 npm install @cubejs-client/playground,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:antd(>=4.16.13)、react(>=18.0.0)、graphql(>=15.8.0)、prismjs(>=1.25.0)、react-dom(>=18.0.0)、@cube-dev/ui-kit(>=0.52.3)、@ant-design/icons(>=4.7.0)、styled-components(>=6.5.3)、@cubejs-client/core(>=0.30.0)、@cubejs-client/react(>=0.30.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cubejs-client/playground 支持 TypeScript 吗?

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

@cubejs-client/playground 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cubejs-client/playground 可以商用吗?

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

@cubejs-client/playground 的下载量有多少?

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

@cubejs-client/playground 还在维护吗?

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