@freegridjs/vue

中文文档
1.15.1发布于 2026/10/20SEE LICENSE IN LICENSETypeScriptES Module零依赖近 30 天下载 3210

Vue 3 component for FreeGrid, the fast data grid. Free core; paid features free with a personal key.

原始使用文档

@freegridjs/vue

Vue 3 component for FreeGrid.

npm i @freegridjs/core @freegridjs/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>

Events are kebab-case; the component ref exposes getApi(). Passing a new array or object with the same content (an inline literal re-created on every render) does not reset anything: columns keep the widths, order and visibility the user changed, and groupBy and pivot are applied again only when their content changes; to undo what the user changed, call the API (resetColumnState(), setGroupBy()). Docs: https://freegrid.app/docs/#vue

License

The core grid (sorting, filters, editing, selection, pinned columns, pages and server rows, CSV export, printing, themes, languages) is free for everyone, companies included.

Paid features need a key after a 30-day trial per domain: row grouping and aggregation, pivot, charts, cell range selection, range copy and paste, fill handle, Excel and PDF export, workbook, server-side groups, advanced filter, side bar panels, context menu, summary rows, formulas, find, conditional formatting and merged cells. Development hosts (localhost, private networks, .local, .test) always have every feature.

  • Personal, educational and non-commercial projects: a free personal key, valid 6 months and renewable any time, at https://freegrid.app/license/personal/
  • Companies: KRW 200,000 per domain per year, or KRW 400,000 once (perpetual, updates within the major version bought). One key covers the domain and all its subdomains.

See https://freegrid.app/pricing/ and the LICENSE file.

기본 기능은 회사를 포함해 누구나 무료입니다. 유료 기능은 도메인마다 30일 체험 뒤 키가 필요합니다. 개인·교육·비영리 프로젝트는 무료 개인 키(6개월, 언제든 갱신)를, 회사는 도메인당 연 20만 원 또는 영구 40만 원 라이선스를 쓰며, 키 하나로 서브도메인까지 모두 쓸 수 있습니다. 자세한 내용은 https://freegrid.app/pricing/

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

or per grid: <FreeGrid license-key="FG1...." :columns="columns" :data="rows" />

版本与发布记录

@freegridjs/vue 共发布 27 个版本,首次发布于 2026/10/15;过去 12 个月发布了 27 个版本。

版本发布日期距今
1.15.1latest2026/10/2026 天前
1.15.02026/10/1927 天前
1.14.12026/10/1928 天前
1.14.02026/10/1928 天前
1.13.02026/10/1928 天前
1.12.02026/10/1928 天前

关于 @freegridjs/vue 的常见问题

@freegridjs/vue 是什么?

Vue 3 component for FreeGrid, the fast data grid. Free core; paid features free with a personal key.

如何安装 @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 和提交记录判断。