# @freegridjs/vue 中文文档

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

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

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

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

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

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

## 中文简介

Vue 3组件为快数据网FreeGrid. 免费核心;有个人钥匙的付费功能.

## 安装

```sh
npm install @freegridjs/vue
```

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

## README

# @ freegridjs/ veue (英语)

Vue 3 组件 [免费Grid](https://freegrid.app/)。 。 。 .

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

```vue
<script setup>
import { FreeGrid } from '@freegridjs/vue';
import '@freegridjs/core/styles.css';
</script>

<template>
  <FreeGrid :columns="columns" :data="rows" row-selection="multiple" :height="480"
            @cell-click="e => console.log(e.row)" />
</template>
```

事件为 kebab- case; 组件校对曝光 `getApi()`。通过一个内容相同的新阵列或对象(在每个渲染点上重新创建的内在文字),不会重设任何东西:列保持用户所改变的宽度、顺序和能见度,以及 `groupBy` 财务报告和审定财务报表 `pivot` 只在内容发生变化时再次应用;要取消用户更改的内容,请拨打API(`resetColumnState()`, (中文(简体) ), `setGroupBy()`) (中文(简体) ). 文档 : [https://freegrid.app/docs/#vue (英语)](https://freegrid.app/docs/#vue)

## 许可证

核心网格(排序、过滤、编辑、选择、绑定列、页面和服务器行、 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....');   // once for every grid on the page
```

或每个网格 : `<FreeGrid license-key="FG1...." :columns="columns" :data="rows" />`

## 常见问题

### @freegridjs/vue 是什么？

Vue 3组件为快数据网FreeGrid\. 免费核心;有个人钥匙的付费功能\.

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

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

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

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

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

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

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

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

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

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

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

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