# @covalent/echarts 中文文档

规范地址：https://npmcn.com/package/%40covalent/echarts/

版本：11\.23\.0
npm 元数据更新时间：2026-10-02T15:28:37.461Z
中文译文更新时间：2026-11-10T21:50:05.849Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.3 MB，69 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：echarts ^5\.4\.3，@angular/core 20\.x\.x，@angular/common 20\.x\.x
- 首次发布：2018-10-29T22:38:50.071Z
- 最新版本发布：2026-10-02T15:28:37.280Z
- 近 30 天下载量：3272（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：397（近 12 个月 74 个）

## 中文简介

Teradata UI 平台图模块

## 安装

```sh
npm install @covalent/echarts
```

也可以使用：`pnpm add @covalent/echarts`、`yarn add @covalent/echarts`、`bun add @covalent/echarts`

## README

# 共价电荷

### 埃克萨斯是什么?

[图表](https://echarts.apache.org/en/index.html) 是一个大型的可视化图书馆, 由Baidu建于画布上.

### 为什么是共价画?

Covalent Echarts是一个由Teradata所建的Angular库,目的是在Angular最佳做法和标准中揭露强大的Echarts API. 共价Echarts还包括了自动再大小,事件输出等易用功能.

共价UI平台不需要使用共价Echarts.

### 为什么是坎瓦斯?

Teradata客户在大型数据集工作,是地球上最大的数据集. 像D3.js这样的SVG图表对于灵活性和定制性来说是巨大的,但对实时数据和大数据来说却没有那么有效. 共价Echarts消除了在极其强大和灵活的Echarts API的基础上自定义画图的复杂性,这些画图提供了你所能想象的每一个定制.

## 安装共价图

```bash
npm install --save echarts
```

```bash
npm install --save @covalent/echarts
```

要测试( 仅用于测试 !) 开发中的最新更改, 请安装夜建 :

```bash
npm install --save https://github.com/Teradata/covalent-echarts-nightly.git
```

## 设置

在您的 NgMudule 中导入 \[CovalentBaseEchartsMudule\] :

```typescript
import { CovalentBaseEchartsModule } from '@covalent/echarts/base';
import { CovalentBarEchartsModule } from '@covalent/echarts/bar';
import { CovalentTooltipEchartsModule } from '@covalent/echarts/tooltip';
@NgModule({
  imports: [
    CovalentBaseEchartsModule,
    CovalentBarEchartsModule,
    CovalentTooltipEchartsModule,
    ...
  ],
  ...
})
export class MyModule {}
```

## 使用量

基本示例:

```html
<td-chart [style.height.px]="300">
  <td-chart-tooltip
    [trigger]="'item'"
    [textStyle]="{ color: '#818181' }"
    [backgroundColor]="'#ffffff'"
  >
    <ng-template let-params let-ticket="ticket" tdTooltipFormatter>
      <ng-container *ngIf="params">
        <div layout="row" layout-align="start center">
          <mat-icon>
            <span [style.color]="params.color">people</span>
          </mat-icon>
          <span class="mat-caption pad-left-sm">
            {{params.seriesName + ': ' + params.value}}
          </span>
        </div>
      </ng-container>
    </ng-template>
  </td-chart-tooltip>
  <td-chart-x-axis
    [show]="true"
    [position]="'bottom'"
    [type]="'category'"
    [data]="['Electronics', 'Toys', 'Grocery', 'Appliances', 'Automotive', 'Sports']"
    [boundaryGap]="true"
  >
  </td-chart-x-axis>
  <td-chart-y-axis
    [show]="true"
    [type]="'value'"
    [position]="'right'"
    [max]="200"
  >
  </td-chart-y-axis>
  <td-chart-series
    td-bar
    [data]="[150, 130, 150, 120, 150, 120]"
    [name]="'Today'"
    [color]="'#F2724B'"
  >
  </td-chart-series>
</td-chart>
```

## 运行单元测试

运行 `nx test angular-echarts` 执行单元测试.

## 常见问题

### @covalent/echarts 是什么？

Teradata UI 平台图模块

### 如何安装 @covalent/echarts？

在项目目录运行 npm install @covalent/echarts，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：echarts（^5\.4\.3）、@angular/core（20\.x\.x）、@angular/common（20\.x\.x）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @covalent/echarts 支持 TypeScript 吗？

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

### @covalent/echarts 支持 ESM 还是 CommonJS？

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

### @covalent/echarts 可以商用吗？

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

### @covalent/echarts 的下载量有多少？

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

### @covalent/echarts 还在维护吗？

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