让开源，少一点语言距离。
npm包中文文档

@cesium/widgets

中文文档
16.3.1发布于 2026/11/03Apache-2.0TypeScriptES Module近 30 天下载 134.1万

A widgets library for use with CesiumJS. CesiumJS is a JavaScript library for creating 3D globes and 2D maps in a web browser without a plugin.

原始使用文档
中文原文
文档目录4 节
  1. Install
  2. Usage
  3. Community
  4. License

@cesium/widgets

Build Status npm Docs

Cesium

CesiumJS is a JavaScript library for creating 3D globes and 2D maps in a web browser without a plugin. It uses WebGL for hardware-accelerated graphics, and is cross-platform, cross-browser, and tuned for dynamic-data visualization.

@cesium/widgets is a widgets library for use with CesiumJS—including the CesiumViewer widget plus widgets for common tasks such as animation, base layer selection and geocoding.

Examples :earth_asia: Docs :earth_americas: Website :earth_africa: Forum :earth_asia: User Stories

Install

@cesium/widgets is published as ES modules with full typing support.

Install with npm

npm install @cesium/widgets --save

Or, install with yarn

yarn add @cesium/widgets

Usage

Import individual modules to benefit from tree shaking optimizations through most build tools:

import { Viewer } from "@cesium/widgets";
import "@cesium/widgets/Source/widgets.css";

const viewer = new Viewer("cesiumContainer");

See our Quickstart Guide for more information on getting a CesiumJS app up and running.

Community

Have questions? Ask them on the community forum.

Interested in contributing? See CONTRIBUTING.md. :heart:

License

Apache 2.0. CesiumJS is free for both commercial and non-commercial use.

版本与发布记录

@cesium/widgets 共发布 64 个版本，首次发布于 2022/10/22；过去 12 个月发布了 14 个版本。

版本发布日期距今
16.3.1latest2026/11/036 天前
16.3.02026/10/021 个月前
16.2.1-wasm.0wasm2026/09/161 个月前
16.2.02026/09/022 个月前
16.1.12026/08/043 个月前
16.1.02026/07/024 个月前

其他发布通道：ion → 13.2.1-ion.0，wasm → 16.2.1-wasm.0。

关于 @cesium/widgets 的常见问题

@cesium/widgets 是什么？

A widgets library for use with CesiumJS. CesiumJS is a JavaScript library for creating 3D globes and 2D maps in a web browser without a plugin.

如何安装 @cesium/widgets？

在项目目录运行 npm install @cesium/widgets，或使用 pnpm add / yarn add / bun add。

@cesium/widgets 支持 TypeScript 吗？

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

@cesium/widgets 支持 ESM 还是 CommonJS？

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

@cesium/widgets 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=22.17.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@cesium/widgets 可以商用吗？

@cesium/widgets 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

@cesium/widgets 的下载量有多少？

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

@cesium/widgets 还在维护吗？

最新版本 16.3.1 发布于 2026/11/03（6 天前）；至今共发布 64 个版本，其中过去 12 个月发布了 14 个；首次发布于 2022/10/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。