# @freegridjs/core 中文文档

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

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

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

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

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

- 包体积（解压后）：2 MB，38 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-14T20:27:13.114Z
- 最新版本发布：2026-10-20T13:25:44.018Z
- 近 30 天下载量：3945（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

FreeGrid——网络快速数据网格:虚拟滚动,分组,支点,图表,Excel导出,7种语言. 免费核心;有个人钥匙的付费功能.

## 安装

```sh
npm install @freegridjs/core
```

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

## README

# 免费Grid

网络的快速数据网格,带有自由的核心和自由的个人密钥. 医生和现场演示: **[https://freegrid.app (英语)](https://freegrid.app/)**

-   100,000多行并有行和列虚拟化
-   平接列、多级别标题、调整大小并拖曳以重排
-   多类型,文本 / 数字 / 日期 / 设置过滤器, 过滤行, 每个列有两个条件和一个跨列的高级过滤器, 快速搜索
-   列选择器和侧边栏,自动大小,可折叠的列组,行号,工具提示,密度;保存并恢复整个视图(get State / set State)
-   摘要行(上行或下行、被钉或滚动)
-   选择行、键盘导航、轻/ 暗和韩文风格的主题、字体设置
-   14种语言:英语、 语、简体中文语、繁體中文语、 Ti语、提容语、ệ语、印度尼西亚语、西班牙语、葡萄牙语、法语、德意志语、意大利语、Русский语
-   编辑(单元格或整行),验证,独特的值,公式,撤消; Excel copy/cut/paste,若干单元格区域,填充控件,合并单元格
-   由 id 与闪存单元格( applictly Transaction) 进行实时更新
-   组复选框的行组, 有懒惰子的树数据, 主/ 细节, 网格之间的行拖动; 配置、 服务器侧行和服务器侧分组
-   Excel(.xlsx,多张工作表,单元格样式)和 CSV 导出并导入,打印; 枢轴表, SVG 图表和火花线
-   用于 Spring Boot 和 eGovFrame (restDatasource, loadData, 保存 Changes) 的服务器助手, 有 Java 示例
-   无障碍(ARIA网格), Shadow DOM, 从右到左, 手机的卡片视图
-   零从属. 反应 : [`@freegridjs/react`](https://www.npmjs.com/package/@freegridjs/react) · Vue: [`@freegridjs/vue`](https://www.npmjs.com/package/@freegridjs/vue) · 斯维尔特: [`@freegridjs/svelte`](https://www.npmjs.com/package/@freegridjs/svelte) 角: [`@freegridjs/angular`](https://www.npmjs.com/package/@freegridjs/angular)

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

```js
import { createGrid } from '@freegridjs/core';
import '@freegridjs/core/styles.css';

const grid = createGrid(document.getElementById('grid'), {
  columns: [
    { field: 'name', header: 'Name', pinned: 'left' },
    { field: 'country', header: 'Country', filter: 'set' },
    { field: 'total', header: 'Total', type: 'number', format: '#,##0' },
  ],
  data: rows,
  rowSelection: 'multiple',
  summary: { rows: [{ label: 'Total', columns: { total: 'sum' } }] },
});
```

容器需要一个高度。 语文: `import ko from '@freegridjs/core/locales/ko'` 通过 `locale: ko`。 。 。 .

### 光盘N

```html
<link rel="stylesheet" href="https://unpkg.com/@freegridjs/core@1/dist/cdn/freegrid.css">
<script src="https://unpkg.com/@freegridjs/core@1/dist/cdn/freegrid.min.js"></script>
<script>FreeGrid.createGrid(el, { columns, data, locale: 'ko' });</script>
```

## 许可证

核心网格(排序、过滤、编辑、选择、绑定列、页面和服务器行、 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/)

```js
import { setLicenseKey } from '@freegridjs/core';
setLicenseKey('FG1....');   // or createGrid(el, { licenseKey: 'FG1....', ... })
```

## 常见问题

### @freegridjs/core 是什么？

FreeGrid——网络快速数据网格:虚拟滚动,分组,支点,图表,Excel导出,7种语言\. 免费核心;有个人钥匙的付费功能\.

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

在项目目录运行 npm install @freegridjs/core，或使用 pnpm add / yarn add / bun add。

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

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

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

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

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

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

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

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

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

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