# @gravity-ui/yagr 中文文档

规范地址：https://npmcn.com/package/%40gravity-ui/yagr/

版本：5\.3\.1
npm 元数据更新时间：2026-09-02T09:27:12.356Z
中文译文更新时间：2026-11-16T23:44:44.104Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gravity-ui/yagr
原文对照：https://npmcn.com/package/%40gravity-ui/yagr/?lang=original
项目主页：https://github.com/gravity-ui/yagr#readme
源码仓库：https://github.com/gravity-ui/yagr

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

- 包体积（解压后）：7.9 MB，147 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=16\.0\.0
- 运行依赖：1 个
- 首次发布：2022-12-09T14:12:35.134Z
- 最新版本发布：2026-09-02T09:27:11.786Z
- 近 30 天下载量：36830（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：116（近 12 个月 21 个）

## 中文简介

UPlot 高级包装

## 安装

```sh
npm install @gravity-ui/yagr
```

也可以使用：`pnpm add @gravity-ui/yagr`、`yarn add @gravity-ui/yagr`、`bun add @gravity-ui/yagr`

## README

# {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 ![](https://raw.githubusercontent.com/gravity-ui/yagr/main/docs/assets/yagr.svg)

Yagr 是高性能的 HTML5 画布图表渲染器,基于 [uPlot 地图](https://github.com/leeoniya/uPlot)。它为 uPlot 图表提供了高级功能.

![](https://raw.githubusercontent.com/gravity-ui/yagr/main/docs/assets/demo.png)

## 特征

-   [线条,区域,列和点作为可视化类型. 每个序列可配置](https://yagr.tech/en/api/visualization)
-   [可配置的图例工具提示](https://yagr.tech/en/plugins/tooltip)
-   [带有小数级精度额外选项的轴](https://yagr.tech/en/api/axes)
-   [具有可配置范围函数和转换的缩放](https://yagr.tech/en/api/scales)
-   [画出线条和乐队. 可配置绘图层](https://yagr.tech/en/plugins/plot-lines)
-   [响应图表](https://yagr.tech/en/api/settings#adaptivity) (所需经费) [调整观察员的大小](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver)(中文(简体) )
-   [堆放区/栏的高级别支助](https://yagr.tech/en/api/scales#stacking)
-   [可配置标记](https://npmcn.com/package/%40gravity-ui/yagr/docs/api/markers.md)
-   [浅/暗主题](https://yagr.tech/en/api/settings#theme)
-   [数据正常化](https://yagr.tech/en/api/scales#normalization)
-   [可配置的横发、光标和快取](https://yagr.tech/en/api/cursor)
-   字体
-   [本地化](https://yagr.tech/en/api/settings#localization)
-   [颜色名称中的 CSS 变量](https://yagr.tech/en/api/css)
-   [插入内线图例](https://yagr.tech/en/plugins/legend)
-   [处理错误和扩展钩](https://yagr.tech/en/api/lifecycle)
-   [数据对接和缺失数据的内插](https://yagr.tech/en/api/data-processing)
-   [实时更新](https://yagr.tech/en/api/dynamic-updates)

## [文档](https://yagr.tech/)

## 快速启动

```
npm i @gravity-ui/yagr
```

### 国家预防机制模块

```typescript
import Yagr from '@gravity-ui/yagr';

new Yagr(document.body, {
    timeline: [1, 2, 3, 4, 5],
    series: [
        {
            data: [1, 2, 3, 4, 5],
            color: 'red',
        },
        {
            data: [2, 3, 1, 4, 5],
            color: 'green',
        },
    ],
});
```

### 脚本标记

```html
<script src="https://unpkg.com/@gravity-ui/yagr/dist/yagr.iife.min.js"></script>
<script>
    new Yagr(document.body, {
        timeline: [1, 2, 3, 4, 5],
        series: [
            {
                data: [1, 2, 3, 4, 5],
                color: 'red',
            },
            {
                data: [2, 3, 1, 4, 5],
                color: 'green',
            },
        ],
    });
</script>
```

### 实例

需要具体的东西吗? 雅格勒在下文中提出了一些有用的例子 [演示/实例](https://npmcn.com/package/%40gravity-ui/yagr/demo/examples/) 文件夹。 如何从当前版本开始 :

1.  克隆仓库.
2.  安装依赖关系 `npm i`。 。 。 .
3.  运行 `npm run build`。 。 。 .
4.  运行 `npx http-server .`。 。 。 .
5.  根据 http-server 输出在浏览器中打开示例 .

## 常见问题

### @gravity-ui/yagr 是什么？

UPlot 高级包装

### 如何安装 @gravity-ui/yagr？

在项目目录运行 npm install @gravity-ui/yagr，或使用 pnpm add / yarn add / bun add。

### @gravity-ui/yagr 支持 TypeScript 吗？

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

### @gravity-ui/yagr 支持 ESM 还是 CommonJS？

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

### @gravity-ui/yagr 需要什么版本的 Node\.js？

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

### @gravity-ui/yagr 可以商用吗？

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

### @gravity-ui/yagr 的下载量有多少？

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

### @gravity-ui/yagr 还在维护吗？

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

