# @barchart/chart-lib 中文文档

规范地址：https://npmcn.com/package/%40barchart/chart-lib/

版本：2\.416\.0
npm 元数据更新时间：2026-11-06T09:11:04.321Z
中文译文更新时间：2026-11-07T21:11:17.688Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40barchart/chart-lib
原文对照：https://npmcn.com/package/%40barchart/chart-lib/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.2 MB，13 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2020-03-17T21:41:23.532Z
- 最新版本发布：2026-11-06T09:11:04.139Z
- 近 30 天下载量：2514（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：630（近 12 个月 218 个）

## 中文简介

条形图 HTML5 流图

## 安装

```sh
npm install @barchart/chart-lib
```

也可以使用：`pnpm add @barchart/chart-lib`、`yarn add @barchart/chart-lib`、`bun add @barchart/chart-lib`

## README

# 挂图 HTML5 图表 SDK

## 包的内容

该档案包含以下文件:

1.  `barchart.chart.js` - 将图表组件纳入产品中
2.  `barchart.chart.d.ts` - 用于库的 TypeScript 声明文件;请注意这对两个 TypeScript 都有用 **财务报告和审定财务报表** JavaScript 项目
3.  `index.html` - 单一图表的网页;请注意,您可能在一个网页内托管许多图表,我们测试了同时显示的几十个图表
4.  `index.js` - 使用一个 _自定义_ 数据输入(提供完全执行)用于演示目的;实际上,输入由Barchart提供,使用图表只需要几行代码
5.  `style.css` - 一种简单的CSS,用于使用暗色主题设计UI的一些元素
6.  `chart.def.json` - 带有一个符号图的默认图表定义(其状态)和使用暗主题的卷研究
7.  `AMZN_Daily.json` - 亚马逊每日数据示意图,用于示范目的
8.  `AMZN_Events.json` - 亚马逊事件数据以示示范
9.  `package.json` - npm 包定义

## 如何运行示例

请注意, 由于时间序列数据使用 JavaScript 载入 `fetch` 功能,必须使用网络服务器为网页服务(换句话说,你不能仅仅打开) `index.html` 从本地文件系统). 你需要一个非常成熟和受欢迎的 [我们喜欢的国家预防机制](https://www.npmjs.com/package/serve)假设你把SDK解压到 `chart-lib` 文件夹,只需进入 `chart-lib` 文件夹并运行 `serve .`。默认情况下,服务器将服务于 `index.html` 在5000个港口 为了保持实例的运行,请联系Barchart并获得一个API 密钥,该密钥应取代 `<YOUR_API_KEY>` 输入 `index.js`。 。 。 .

## 浏览器支持

为了保持图表组件的大小合理小,我们已经为上个 EcmaScript (JavaScript) 标准构建了组件. 所有主要浏览器的后2个版本都支持这个标准,因此需要现代浏览器来使用组件.

请注意该部分 **能够** 用于支持更古老的浏览器(例如IE 11,我们没有测试更古老的版本)而牺牲其大小,而对于非常古老的浏览器来说,其尺寸通常会大大增加.

## 使用 npm 的库

当示例代码( E)`index.html` 和相关文件)是完整的,并且是可行的,它没有显示现代的JavaScript开发情景——它更类似于一种传统的方法,即您在HTML中引用库,然后在脚本中使用从Barchart"namespace"中获取的资源.

然而,这只是一种而且肯定不是使用图书馆的唯一方法。 如果您想引用并用您的代码构建库, 您正在使用 [无](https://npmjs.com/) - 几乎所有现代方法都做到的 - 和任何现代捆绑工[网络软件包](https://webpack.js.org/), (中文(简体) ), [滚动](https://rollupjs.org/), (中文(简体) ), [括号](https://parceljs.org/) 或者说 [维特](https://vitejs.dev/)和转写器喜欢 [宝贝](https://babeljs.com/),那么请 _一个_ 两者中:

1.  如果您有网络访问权限, 请按惯例从 npm 安装我们的库, 也就是说 `npm i @barchart/chart-lib` 或者说 `yarn add @barchart/chart-lib`
2.  如果您没有网络访问, 您可以通过运行直接从此归档( 不需要解压缩) 安装软件包 `npm i /path/to/chart-lib.tgz` 或者说 `yarn add file:/path/to/chart-lib.tgz`

你现在可以 `import` 图表库导出的任何函数/类/算法;以上TypeScript声明文件都对此有记载。 我们的模块名称是 `@barchart/chart-lib`。 。 。 .

图表部分具有框架不可知性,与任何现代联合来文框架同样有效,而且根本没有框架.

## 何处找到更多信息

图表组件/SDK不携带任何形式的UI来发. API 图表对应的是 [此处记录](https://docs.barchart.com/chart)我们正忙于工作,使文件更清晰,更容易使用,请经常复检.

我们确实有一个产品,叫做部件,它包括UI。 一个 UI 构建器生成 HTML 的小片段, 以获取您的页面上的部件 [在部件站点](https://demo.barchart.com/chart-widget)。 。 。 . 同样部件的力量 [我们的演示网站](https://demo.barchart.com/chart)。部件使用 Barchart 的尖端(专有)库编写,该库将生成 [Web 组件](https://developer.mozilla.org/en-US/docs/Web/Web_Components),帮助保持软件包的尺寸小而高效.

请注意,我们正在使用 组件是,在很多 [巴图的](https://www.barchart.com/) 产品。 该组件自2016年起投入生产,在几种不同的情景中进行了战斗测试----既基于页面,又基于SPA。 我们很乐意帮助您将组件融入您的产品中.

## 常见问题

### @barchart/chart-lib 是什么？

条形图 HTML5 流图

### 如何安装 @barchart/chart-lib？

在项目目录运行 npm install @barchart/chart-lib，或使用 pnpm add / yarn add / bun add。

### @barchart/chart-lib 支持 TypeScript 吗？

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

### @barchart/chart-lib 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @barchart/chart-lib 可以商用吗？

@barchart/chart-lib 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @barchart/chart-lib 的下载量有多少？

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

### @barchart/chart-lib 还在维护吗？

最新版本 2\.416\.0 发布于 2026/11/06（1 天前）；至今共发布 630 个版本，其中过去 12 个月发布了 218 个；首次发布于 2020/03/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。