# @freegridjs/angular 中文文档

规范地址：https://npmcn.com/package/%40freegridjs/angular/

版本：1\.15\.1
npm 元数据更新时间：2026-10-20T13:24:05.170Z
中文译文更新时间：2026-11-15T14:03:20.356Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40freegridjs/angular
原文对照：https://npmcn.com/package/%40freegridjs/angular/?lang=original
项目主页：https://freegrid.app/

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

- 包体积（解压后）：49.6 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@angular/core \>=17\.0\.0，@freegridjs/core ^1\.15\.1
- 首次发布：2026-10-15T01:10:24.588Z
- 最新版本发布：2026-10-20T13:24:04.253Z
- 近 30 天下载量：3122（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

FreeGrid的角构件,即快数据网. 免费核心;有个人钥匙的付费功能.

## 安装

```sh
npm install @freegridjs/angular
```

也可以使用：`pnpm add @freegridjs/angular`、`yarn add @freegridjs/angular`、`bun add @freegridjs/angular`

## README

# @freegridjs/ angular (英语)

角组件 [免费Grid](https://freegrid.app/). 独立工作,不论有无区.js(Angular 17+).

```bash
npm i @freegridjs/core @freegridjs/angular
```

```ts
import { Component } from '@angular/core';
import { FreeGridComponent } from '@freegridjs/angular';
import type { GridApi } from '@freegridjs/core';

@Component({
  selector: 'app-orders',
  standalone: true,
  imports: [FreeGridComponent],
  template: `
    <free-grid [columns]="columns" [data]="rows" rowSelection="multiple" [height]="480"
               (ready)="api = $event" (cellClick)="open($event.row)" />
  `,
})
export class OrdersComponent {
  columns = [{ field: 'name' }, { field: 'qty', type: 'number' }];
  rows = [{ name: 'Pen', qty: 3 }];
  api?: GridApi;
  open(row: unknown) { console.log(row); }
}
```

添加 `@import '@freegridjs/core/styles.css';` 到您的全局样式( 或者在下方列出) `styles` 在argular.json中).

每个网格事件都是同名输出(`(sortChange)`, (中文(简体) ), `(cellValueChanged)`(......) ; (......); `paste` 财务报告和审定财务报表 `scroll` 为: `(gridPaste)` 财务报告和审定财务报表 `(gridScroll)`。 。 。 . `columns`, (中文(简体) ), `data`, (中文(简体) ), `theme`, (中文(简体) ), `locale`, (中文(简体) ), `summary`, (中文(简体) ), `groupBy`, (中文(简体) ), `pivot`, (中文(简体) ), `fontSize` 财务报告和审定财务报表 `fontFamily` 更改时更新网格; 其他选项进入 `[options]` 并适用于创建. 通过一个内容相同的新阵列或对象(在每个渲染点上重新创建的内在文字)不会重置任何东西:列保持用户所改变的宽度、顺序和能见度 `groupBy` 财务报告和审定财务报表 `pivot` 只在内容发生变化时再次应用;要取消用户更改的内容,请拨打API(`resetColumnState()`, (中文(简体) ), `setGroupBy()`) (中文(简体) ). 网格运行在角区外,因此滚动不会触发变化检测.

文档 : [https://freegrid.app/docs/#angular (英语)](https://freegrid.app/docs/#angular)

## 许可证

核心网格(排序、过滤、编辑、选择、绑定列、页面和服务器行、 CSV 导出、, 印刷、主题、语言)对所有人免费,包括公司.

每个域进行30天的试验后,付费特性需要一个密钥:行分组和汇总、支点、图表、, 单元格区域选择、范围复制和粘贴、填充控件、Excel和PDF导出、工作簿、服务器侧组、, 高级过滤器、边栏面板、上下文菜单、摘要行、公式、查找、有条件的格式 和合并的细胞。 发展东道主(当地东道主、私人网络、当地网络、测试) 每一个特征.

-   个人、教育和非商业项目:免费个人钥匙,有效期6个月,可续用 任何时候,在 [https://freegrid.app/license/ personal/ 互联网档案馆的存檔,存档日期2013-12-11](https://freegrid.app/license/personal/)
-   公司:每年每个域20万克朗,或40万克朗一次(长期更新,主要领域范围内更新) 已购买). 一个密钥覆盖了域及其所有子域.

见 [https://freegrid.app/pricing/ 页面存档备份,存于互联网档案馆](https://freegrid.app/pricing/) 还有LICENSE文件.

기본. 30分 30分 30分 30分 30分. 개인·교육·비영리 (6개월 (6개월 (언제든)) 를 (갱신) 회사는 (도메인당) 20만 (또는) 또는 (영구) 40만 (원) 라이선스를,키也. 자세한 [https://freegrid.app/pricing/ 页面存档备份,存于互联网档案馆](https://freegrid.app/pricing/)

```ts
import { setLicenseKey } from '@freegridjs/core';
setLicenseKey('FG1....');   // once for every grid on the page
```

或每个网格 : `<free-grid licenseKey="FG1...." [columns]="columns" [data]="rows" />`

## 常见问题

### @freegridjs/angular 是什么？

FreeGrid的角构件,即快数据网\. 免费核心;有个人钥匙的付费功能\.

### 如何安装 @freegridjs/angular？

在项目目录运行 npm install @freegridjs/angular，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@angular/core（\>=17\.0\.0）、@freegridjs/core（^1\.15\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @freegridjs/angular 支持 TypeScript 吗？

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

### @freegridjs/angular 支持 ESM 还是 CommonJS？

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

### @freegridjs/angular 可以商用吗？

@freegridjs/angular 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @freegridjs/angular 的下载量有多少？

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

### @freegridjs/angular 还在维护吗？

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