# @elastic/charts 中文文档 规范地址：https://npmcn.com/package/%40elastic/charts/ 版本：73\.3\.2 npm 元数据更新时间：2026-10-23T15:41:20.835Z 中文译文更新时间：2026-11-13T10:34:34.659Z 软件包许可：SEE LICENSE IN LICENSE\.txt 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40elastic/charts 原文对照：https://npmcn.com/package/%40elastic/charts/?lang=original 项目主页：https://github.com/elastic/elastic-charts#readme 源码仓库：https://github.com/elastic/elastic-charts ## 关键信息（来自 npm 元数据） - 包体积（解压后）：4.1 MB，2588 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：19 个 - peer 依赖：react ^18\.0，moment ^2\.29\.1，react-dom ^18\.0，moment-timezone ^0\.5\.32 - 首次发布：2019-02-07T01:47:45.610Z - 最新版本发布：2026-10-23T15:41:20.180Z - 近 30 天下载量：1028685（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：453（近 12 个月 33 个） ## 中文简介 弹性图数据可视化库 ## 安装 ```sh npm install @elastic/charts ``` 也可以使用：`pnpm add @elastic/charts`、`yarn add @elastic/charts`、`bun add @elastic/charts` ## README # ![elastic-charts logo](https://raw.githubusercontent.com/elastic/elastic-charts/main/public/logo.png) 弹性图表 [![Build Status - main branch](https://badge.buildkite.com/1b2f6369ef27e5b23a7fccf2545d7d6e31bff1957c7c941d31.svg?branch=main)](https://buildkite.com/elastic/elastic-charts-build/builds?branch=main)[![NPM version](https://img.shields.io/npm/v/@elastic/charts.svg)](https://www.npmjs.com/@elastic/charts) [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/) [![](https://img.shields.io/static/v1?label=examples&message=storybook&color=ff4685)](https://elastic.github.io/elastic-charts/storybook) 看看我们 [生活风格指南](https://elastic.github.io/elastic-charts/storybook/),其中包含许多例子,说明图表的外观和感受,以及如何在你的产品中使用这些图表或叉子 [代码和框](https://codesandbox.io/p/sandbox/elastic-charts-playground-gmnjx9?file=%2Fsrc%2FApp.tsx) 这里的示例可以直接播放库. ## 安装 要将弹性图表安装到现有项目中,请使用 `yarn` CLI (中文(简体) )`npm` 不被支持. ``` yarn add @elastic/charts ``` > **重要内容:** 见 [消费](https://github.com/elastic/elastic-charts/wiki/Consuming-@elastic-charts) 详细安装要求的wiki ## 本地运行 ### 节点 我们依赖于定义于 [.nvmrc (英语)](https://npmcn.com/package/%40elastic/charts/.nvmrc)。 。 。 . 您可能想要安装节点版本管理器 . [数字](https://github.com/creationix/nvm) 建议. 安装和使用正确的节点版本 `nvm`数字 : ``` nvm install ``` ### 发展环境 您可以在本地运行 dev 环境 [http://localhost:9001 (英语)](http://localhost:9001/) 通过运行 : ``` yarn yarn start ``` 我们用 [故事书](https://storybook.js.org/) 到文档 API、边框和库的使用. 主机版本可在 [https://elastic.github.io/elastic-charts/史地书](https://elastic.github.io/elastic-charts/storybook/)。 。 。 . ## 中情局 我们用同样的 [建设管道](https://buildkite.com/elastic/elastic-charts-build) 用于建设公关和主要分支. 这条管道通过网路事件触发 [建设基子- pr- bot](https://github.com/elastic/buildkite-pr-bot)。启动管道的配置可以在 [拉 - 请求.json](https://npmcn.com/package/%40elastic/charts/.buildkite/pull-requests.json)。 。 。 . ## 目标 这个库的主要目标是提供一套可重复使用的图表组件,可以在整个Elastic的网络产品中使用. 作为单一的真理来源,这个框架允许我们的设计者在代码中直接修改我们的外观和感觉. 并且单位测试覆盖图表组件,使我们能够提供稳定的"图表API". ## 捐款 您可以在创建和提交新功能时查找文档 [捐款](https://github.com/elastic/elastic-charts/wiki/Contributing-to-Elastic-Charts)。 。 。 . ## [维基](https://github.com/elastic/elastic-charts/wiki) ### 消费 - [消耗弹性图](https://github.com/elastic/elastic-charts/wiki/Consuming-@elastic-charts) ### 文档 - [概览](https://github.com/elastic/elastic-charts/wiki/Overview) - [他们](https://github.com/elastic/elastic-charts/wiki/Theming) ## 许可证 [在Elastic v2和Server Side公共许可证下获得双许可证,v 1](https://npmcn.com/package/%40elastic/charts/LICENSE.txt) 读取 [财务问题](https://github.com/elastic/elastic-charts/wiki/FAQ) 详细情况. ## 常见问题 ### @elastic/charts 是什么？ 弹性图数据可视化库 ### 如何安装 @elastic/charts？ 在项目目录运行 npm install @elastic/charts，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0）、moment（^2\.29\.1）、react-dom（^18\.0）、moment-timezone（^0\.5\.32）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @elastic/charts 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @elastic/charts 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @elastic/charts 可以商用吗？ @elastic/charts 使用 SEE LICENSE IN LICENSE\.txt 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。 ### @elastic/charts 的下载量有多少？ 根据 npm 官方下载统计，@elastic/charts 在 2026/10/13 – 2026/11/11 这 30 天内被下载 1,028,685 次，日均约 34,290 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @elastic/charts 还在维护吗？ 最新版本 73\.3\.2 发布于 2026/10/23（20 天前）；至今共发布 453 个版本，其中过去 12 个月发布了 33 个；首次发布于 2019/02/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。