@freegridjs/react

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

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

原始使用文档

@freegridjs/react

React component for FreeGrid.

npm i @freegridjs/core @freegridjs/react
import { FreeGrid } from '@freegridjs/react';
import '@freegridjs/core/styles.css';

<FreeGrid
  columns={columns}
  data={rows}
  rowSelection="multiple"
  onCellClick={e => console.log(e.row)}
  style={{ height: 480 }}
/>;

Every grid option is a prop, every event an on… prop, and the ref is the grid API. 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/#react

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 licenseKey="FG1...." columns={columns} data={rows} />

版本与发布记录

@freegridjs/react 共发布 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/react 的常见问题

@freegridjs/react 是什么?

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

如何安装 @freegridjs/react?

在项目目录运行 npm install @freegridjs/react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18)、@freegridjs/core(^1.15.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@freegridjs/react 支持 TypeScript 吗?

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

@freegridjs/react 支持 ESM 还是 CommonJS?

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

@freegridjs/react 可以商用吗?

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

@freegridjs/react 的下载量有多少?

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

@freegridjs/react 还在维护吗?

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