@freegridjs/svelte

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

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

原始使用文档

@freegridjs/svelte

Svelte 5 component and action for FreeGrid.

npm i @freegridjs/core @freegridjs/svelte
<script>
  import { FreeGrid } from '@freegridjs/svelte';
  import '@freegridjs/core/styles.css';

  let api;
  const columns = [{ field: 'name' }, { field: 'qty', type: 'number' }];
  let rows = $state([{ name: 'Pen', qty: 3 }]);
</script>

<FreeGrid {columns} data={rows} rowSelection="multiple" height={480}
          onReady={a => (api = a)} onCellClick={e => console.log(e.row)} />

Every grid option is a prop; events are on + the event name (onSortChange, onCellValueChanged, …). columns, data, theme, locale, summary, groupBy, pivot, fontSize and fontFamily update the grid when they change. 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()).

Without a component, use the action:

<script>
  import { freegrid } from '@freegridjs/svelte';
</script>

<div use:freegrid={{ columns, data: rows }} style="height: 400px"></div>

Docs: https://freegrid.app/docs/#svelte

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} data={rows} />

版本与发布记录

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

版本发布日期距今
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/svelte 的常见问题

@freegridjs/svelte 是什么?

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

如何安装 @freegridjs/svelte?

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

@freegridjs/svelte 支持 TypeScript 吗?

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

@freegridjs/svelte 支持 ESM 还是 CommonJS?

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

@freegridjs/svelte 可以商用吗?

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

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

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

@freegridjs/svelte 还在维护吗?

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