# @adapttable/core 中文文档

规范地址：https://npmcn.com/package/%40adapttable/core/

版本：3\.13\.1
npm 元数据更新时间：2026-11-01T19:58:34.339Z
中文译文更新时间：2026-11-06T02:08:46.826Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40adapttable/core
原文对照：https://npmcn.com/package/%40adapttable/core/?lang=original
项目主页：https://adapttable.orwamahmoud.com/react/demo/
源码仓库：https://github.com/orwa-mahmoud/adapttable

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

- 包体积（解压后）：14.9 MB，166 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：0 个
- 首次发布：2026-06-12T07:26:24.533Z
- 最新版本发布：2026-11-01T19:58:34.056Z
- 近 30 天下载量：6673（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：49（近 12 个月 49 个）

## 中文简介

框架中立的Adaptable引擎——模型,状态,URL同步,以及统一的客户端/服务器表源. 零UI-kit 或 React 导入.

## 安装

```sh
npm install @adapttable/core
```

也可以使用：`pnpm add @adapttable/core`、`yarn add @adapttable/core`、`bun add @adapttable/core`

## README

# @ 适应/ 核心

[![AdaptTable — one headless engine: the same table re-rendered through Mantine, MUI, Chakra, Ant Design, Radix, shadcn, and Tailwind](https://adapttable.orwamahmoud.com/media/core/tour.gif)](https://adapttable.orwamahmoud.com/react/demo/)

**[页:1](https://adapttable.orwamahmoud.com/)** • 妇女 **[现场演示](https://adapttable.orwamahmoud.com/react/demo/)** • 妇女 **[开始吧](https://adapttable.orwamahmoud.com/react/getting-started/)** • 妇女 **[在 StackBlitz 中尝试](https://stackblitz.com/github/orwa-mahmoud/adapttable/tree/main/starters/mantine)**

_搬出谭斯塔克桌子? 见 [移徙指南](https://adapttable.orwamahmoud.com/react/migrate-from-tanstack-table/)。 。 。 ._

这个 **框架中性引擎** 后面 [适应表](https://github.com/orwa-mahmoud/adapttable) —— 说 状态、模型、查询编码器和统一的客户端/服务器 `TableSource` 合同,其图表中没有反应或UI-kit进口.

```bash
pnpm add @adapttable/core
```

您通常想要在顶部设置一个有样式的适配器( Name`@adapttable/mantine`, (中文(简体) ), `@adapttable/mui`, (中文(简体) ), `@adapttable/chakra`, (中文(简体) ), `@adapttable/unstyled`) (中文(简体) ). 到达 `@adapttable/react` 当你想要钩子和道具 做你自己 标记.

需要节点.js **22.12.0 或较新的**;包装的释放在22.12和24号节点上进行测试.

## 特征

核心供应 状态,数据转换 和合同背后的完整 下面的表格。 反应钩子、键盘接线和使控件生效 内 `@adapttable/react` 和装备适配器.

-   **自动移动卡** ——核心保留一行/状态模型,同时 反应和适配器层在移动断点下方渲染出卡. [文档](https://adapttable.orwamahmoud.com/react/mobile/)。 。 。 .
-   **客户端或服务器数据** 通过一个 `TableSource` 合同——同样道具也一样.
-   **全球搜索** - 承诺的术语,其 `q` URL 参数和默认可搜索文本投影(`engineSearchText`);适配器使搜索框.
-   **URL 符号** 搜索 / 排序 / 过滤 / 页面 – 可共享,可深链接的链接.
-   **倾斜** 页面或无限卷轴通过 `paginationMode`; 服务器源 报告自己的总数,客户来源提供.
-   **SSR和服务器组件** ——引擎没有DOM依赖性;反应 绑定为 Next.js App 路由器提供客户端边界. [文档](https://adapttable.orwamahmoud.com/react/ssr-rsc/)。 。 。 .
-   **半个反弹** (单位:千美元)`@adapttable/core/query`)——过滤-树和支点 URL 编码器可以自行解码 没有安装反应的进程.
-   **套装套装** (单位:千美元)`@adapttable/core/conformance`——DOM 声称每个内置适配器都通过,可对任何约束性或 通过一个驱动器和您选择的测试跑者. [文档](https://adapttable.orwamahmoud.com/react/building-an-adapter/#testing)。 。 。 .
-   **排序** ——比较方分辨率和多键 `sortValue`; 回转 结果为可读信头状态.
-   **过滤** - 过滤模型、运算符和计数,包括嵌入式和/或 过滤树;适配器会使出窗体和芯片.
-   **页眉过滤器** - 后面的滤光铬模型 `headerFilters()`;适配器绘制头部漏斗.
-   **自定义过滤器类型** - 那个 `FilterTypeSpec` 后面的登记册 `FILTER_TYPES`:部件、运算符、上游、芯片和每个类型的URL参数.
-   **选择+批量动作** 选定的身份证和批量作业合同; 适配器生成 三态控件和对话框 .
-   **行动作** 知名度、残疾状况和确认合同; 适配器拥有控制器.
-   **列扩展** - 反应装订后状态 `rowDetail(...)` 特性.
-   **嵌入式表格** - 反应层 `nestedTable(...)` 制作一个完整的包 `DataTable` 在扩大的一行.
-   **内置单元格编辑** - 状态落后 `editing(handler)` 财务报告和审定财务报表 `editable` 列; 文本、 数字和选择 编辑器,键盘承诺/取消, Tab 提前。 关闭操作器,没有打开的手机.
-   **行重排顺序** —— 说 `rowReorder(handler)`; Space-lift键盘,数据集相对指数.
-   **行指针** —— 说 `rowPinning(...)`;上下行相黏.
-   **固定摘要行** —— 说 `pinnedSummaryRows({ top, bottom })`;主机拥有的总数出行模型外.
-   **横跨行和列** - 后面的模型 - 后面的模型 `cellSpan(...)`。 。 。 .
-   **全宽和分隔行** —— 说 `extraRows`。 。 。 .
-   **行型和高度** - 后面的模型 - 后面的模型 `rowAppearance(...)`。 。 。 .
-   **键盘单元格导航** – 核心状态支持反应层 `cellNavigation()` 特性,添加 ARIA 网格语义、箭头键 移动和屏幕阅读器通知.
-   **行组** ——模式支持 `grouping(...)` 财务报告和审定财务报表 `groupingPanel(...)`。 。 。 .
-   **合计** —— 说 `aggregate()`, (中文(简体) ), `aggregatable` 列操作和页脚和组总计后面的聚合模型,包括自定义操作.
-   **关键表格** 分行、分行和措施,小计和可折叠 组合,从可选 `@adapttable/core/pivot` 输入.
-   **树数据** - 后面的等级模式 `tree(...)`。 。 。 .
-   **栏管理** ——显示/隐藏,重排,接针(粘接)和再大小状态,外加可相撞的列组.
-   **火花线列** - 反应层 `@adapttable/react/sparkline` 使栏、行和区域图表成为内置SVG.
-   **PDF 导出和打印布局** (单位:千美元)`@adapttable/core/pdf`——可选条目; `pdfWriter()` 打开 `exportCsv`, (中文(简体) ), `printTable` 用于浏览器对话框.
-   **公式引擎** (单位:千美元)`@adapttable/core/formula`——电子表格公式并列和汇总;循环参考报告 `#CYCLE!`。 。 。 .
-   **活行补丁** (单位:千美元)`@adapttable/core/stream`——线剖析和插座 无反应的连接; `useRowPatchStream` 生活状况 `@adapttable/react/stream`。 。 。 .
-   **已保存视图** 指定过滤器/分包/分栏安排,并相互切换.
-   **特征构成基础** - 框架中立国和合同制 工厂暴露于 `@adapttable/react/features` 和每个工具箱的子路径. 主机插件使用相同的 `TableFeature` 编号 : `setup(host)` 表面.
-   **CSV 导出** (单位:千美元)`exportCsv(...)`)——当前页面,被过滤的完整集,或 所选行; 选择列, 或将整行交给后端.
-   **XLSX 导出** (单位:千美元)`@adapttable/core/xlsx`——可选条目; `xlsxWriter()` 打开 `exportCsv` 写一个真实的 `.xlsx` 没有额外依赖的工作簿.
-   **命令调色板和上下文菜单** - 那个 `Command` 编号 : `ContextMenuItem` 模型和内置 `tableCommands` 编号 : `filterCommands`; 适配器渲染 `commandPalette()` 财务报告和审定财务报表 `contextMenu()`。 。 。 .
-   **查看控件** ——密度,全屏,平面,状态栏和侧面板的本地化标签;反应层和适配器拥有工具栏控制.
-   **虚拟化** (单位:千美元)`virtualize(...)`)——非常大名单行/卡窗口.
-   **拉特** 和i18n-不可知标签——通过 `labels` 或一个 `t` 函数.
-   **框架中立** ——没有组件,造型,反应或UI-kit导入.

## 看它有用吗

由每个适配器重接的1个数据集——这些片段是交叉基特巡演.

**行组** ——以一行为一列,每行小计

![row-grouping](https://adapttable.orwamahmoud.com/media/core/parts/row-grouping.gif)

**内置单元格编辑** ——双击单元格;文本、数字和选择编辑器

![cell-editing](https://adapttable.orwamahmoud.com/media/core/parts/cell-editing.gif)

**过滤** 键入绑定值,表格按键回答

![filtering](https://adapttable.orwamahmoud.com/media/core/parts/filtering.gif)

**栏管理** ——显示,隐藏,重排,接针和大小调整

![column-management](https://adapttable.orwamahmoud.com/media/core/parts/column-management.gif)

**拉特** - 整个桌子的镜子,不只是文字

![rtl](https://adapttable.orwamahmoud.com/media/core/parts/rtl.gif)

## 文档

[开始](https://adapttable.orwamahmoud.com/react/getting-started/) • 妇女 [现场演示](https://adapttable.orwamahmoud.com/react/demo/) • 妇女 [比较与 ag-Grid → MUI X → TanStack](https://adapttable.orwamahmoud.com/react/comparison/)

-   **数据** —— 说 [客户端对服务器级](https://adapttable.orwamahmoud.com/data-tiers/) • 妇女 [无限卷轴( i)](https://adapttable.orwamahmoud.com/react/pagination/) • 妇女 [URL 符号状态](https://adapttable.orwamahmoud.com/react/url-state/)
-   **互动** —— 说 [过滤](https://adapttable.orwamahmoud.com/react/filtering/) • 妇女 [排序](https://adapttable.orwamahmoud.com/react/sorting/) • 妇女 [选择大块动作( b)](https://adapttable.orwamahmoud.com/react/selection/) • 妇女 [扩展行](https://adapttable.orwamahmoud.com/react/row-expansion/) • 妇女 [内置单元格编辑](https://adapttable.orwamahmoud.com/react/cell-editing/) • 妇女 [行重排顺序](https://adapttable.orwamahmoud.com/react/row-reordering/) • 妇女 [行针](https://adapttable.orwamahmoud.com/react/row-pinning/) • 妇女 [已绑定的简要行](https://adapttable.orwamahmoud.com/react/pinned-summary-rows/) • 妇女 [横行和纵行](https://adapttable.orwamahmoud.com/react/row-spanning/) • 妇女 [全宽和分隔行](https://adapttable.orwamahmoud.com/react/full-width-rows/) • 妇女 [行型和高处](https://adapttable.orwamahmoud.com/react/row-styling/)
-   **列数** —— 说 [显示/隐藏 · 重排 · 接针 · 调整大小](https://adapttable.orwamahmoud.com/react/column-management/) • 妇女 [闪光柱](https://adapttable.orwamahmoud.com/react/sparkline/) • 妇女 [行组和集合](https://adapttable.orwamahmoud.com/react/row-grouping/) • 妇女 [CSV 导出](https://adapttable.orwamahmoud.com/react/customization/#csv-export)
-   **再来** —— 说 [i18n 和 RTL](https://adapttable.orwamahmoud.com/react/i18n-rtl/) • 妇女 [虚拟化](https://adapttable.orwamahmoud.com/react/virtualization/) • 妇女 [定制](https://adapttable.orwamahmoud.com/react/customization/) • 妇女 [API 密码](https://adapttable.orwamahmoud.com/react/api/) • 妇女 [财务问题](https://adapttable.orwamahmoud.com/faq/)

## 许可证

[麻省理工学院](https://npmcn.com/LICENSE) © [奥尔瓦·马哈茂德](https://orwamahmoud.com/)

## 常见问题

### @adapttable/core 是什么？

框架中立的Adaptable引擎——模型,状态,URL同步,以及统一的客户端/服务器表源\. 零UI-kit 或 React 导入\.

### 如何安装 @adapttable/core？

在项目目录运行 npm install @adapttable/core，或使用 pnpm add / yarn add / bun add。

### @adapttable/core 支持 TypeScript 吗？

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

### @adapttable/core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @adapttable/core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adapttable/core 可以商用吗？

@adapttable/core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adapttable/core 的下载量有多少？

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

### @adapttable/core 还在维护吗？

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