@freegridjs/core

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

FreeGrid — a fast data grid for the web: virtual scrolling, grouping, pivot, charts, Excel export, 7 languages. Free core; paid features free with a personal key.

原始使用文档

FreeGrid

A fast data grid for the web with a free core and free personal keys. Docs and live demos: https://freegrid.app

  • 100,000+ rows with row and column virtualization
  • Pinned columns, multi-level headers, resize and drag to reorder
  • Multi-sort, text / number / date / set filters, a filter row, two conditions per column and an advanced filter across columns, quick search
  • Column chooser and side bar, autosize, collapsible column groups, row numbers, tooltips, density; save and restore whole views (getState / setState)
  • Summary rows (top or bottom, pinned or scrolling)
  • Row selection, keyboard navigation, light / dark and Korean-style themes, font settings
  • 14 languages: English, 한국어, 简体中文, 繁體中文, 日本語, Tiếng Việt, ไทย, Bahasa Indonesia, Español, Português, Français, Deutsch, Italiano, Русский
  • Editing (cell or whole row), validation, unique values, formulas, undo; Excel copy/cut/paste, several cell ranges, fill handle, merged cells
  • Live updates by id with flashing cells (applyTransaction)
  • Row grouping with group checkboxes, tree data with lazy children, master/detail, row drag between grids; pagination, server-side rows and server-side grouping
  • Excel (.xlsx, several sheets, cell styles) and CSV export and import, printing; pivot tables, SVG charts and sparklines
  • Server helpers for Spring Boot and eGovFrame (restDatasource, loadData, saveChanges) with Java examples
  • Accessibility (ARIA grid), Shadow DOM, right-to-left, card view for phones
  • Zero dependencies. React: @freegridjs/react · Vue: @freegridjs/vue · Svelte: @freegridjs/svelte · Angular: @freegridjs/angular
npm i @freegridjs/core
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' } }] },
});

The container needs a height. Languages: import ko from '@freegridjs/core/locales/ko' and pass locale: ko.

CDN

<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>

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....');   // or createGrid(el, { licenseKey: 'FG1....', ... })

版本与发布记录

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

@freegridjs/core 是什么?

FreeGrid — a fast data grid for the web: virtual scrolling, grouping, pivot, charts, Excel export, 7 languages. Free core; paid features free with a personal key.

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