# @adapttable/vue 中文文档

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

版本：0\.4\.1
npm 元数据更新时间：2026-11-01T19:59:49.396Z
中文译文更新时间：2026-11-08T10:17:10.171Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：3.7 MB，129 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：2 个
- peer 依赖：vue ^3\.5\.0
- 首次发布：2026-10-11T07:14:51.343Z
- 最新版本发布：2026-11-01T19:59:49.012Z
- 近 30 天下载量：1804（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

无头 Adaptable Table的Vue composables和结构表合同——在框架中性引擎上排序,过滤,编辑,分组,URL状态和服务器数据.

## 安装

```sh
npm install @adapttable/vue
```

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

## README

# @ adaptable/ veue

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

无头 Vue 3.5可堆放于框架中性Adaptable引擎之上. Vue拥有回放和生命周期;适配器提供每个可见的控制. 这是公众 `0.1.0` 软件包.

```sh
pnpm add @adapttable/vue vue@^3.5.0
```

使用本地控件准备的表格,请安装 `@adapttable/vue-unstyled` 财务报告和审定财务报表 跟着 [Vue 启动指南](https://adapttable.orwamahmoud.com/vue/getting-started/)。 。 。 .

## 特征

-   反应前端、服务器和查询-图书馆源以及搜索、过滤、, 对主机拥有的行进行排序和页化
-   已键入单元格/页眉/页脚渲染器、控制列布局和行选择, 桌面表格和应答移动卡模式
-   过滤器、页眉过滤器和AND/OR过滤器树的特性构成; 单元格、行和批次编辑,并附有验证、冲突处理、肮脏状态 撤销/重写
-   分组和汇总、树数据、行扩展和嵌入式表格; 可调整/组合列、行针、独立摘要行、单元格间距、, 全线行、行样式和主机拥有的行动作
-   密度/ 全屏视图控制、 URL 状态和已保存的已连接视图 状态切片
-   本地化标签、 RTL 语义属性、 SSR 安全设置和范围化资源 所有权通过挂载、保持Live停用和处置

捆绑提供了模型和结构克罗姆. 需要UI的特性 需要适配器控制; 使用来自 `@adapttable/vue-unstyled` 联合国 `DataTable`土著 `standardFeatures()` 预设可用自 `@adapttable/vue-unstyled/preset`。 。 。 .

## 来源和渲染

```ts
import { useFrontendData, useDataTable } from "@adapttable/vue";
import type { ColumnDef } from "@adapttable/vue";

interface Person {
  id: string;
  name: string;
}
const columns: ColumnDef<Person>[] = [{ key: "name", sortable: true }];
const source = useFrontendData({
  data: [{ id: "ada", name: "Ada" }],
  columns,
  urlSync: false,
});
const table = useDataTable({
  source,
  columns,
  rowKey: (row: Person) => row.id,
});
```

以设置或自有效果范围运行可堆积器 。 源结果只读 浅回; 读最新 `source.value` 在脚本中。 返回的桌子 裁判员留下来 解结构时有反应 回调值仍为回调; 通过一个获取器 当替换回调身份时,整个选项的对象.

`useServerData` 向主机发送查询和请求本地中止符号 。 检查 `info.signal.aborted` 在发布行、总计、出错或装入状态之前. `responseKey` 将数据属性为查询;它不是一个请求生成符号. `useQuerySource` 调整一个拥有其请求的现有查询可编译, 取消和安全部门改革政策.

`ColumnDef<TRow, TValue>`, (中文(简体) ), `CellContext`, (中文(简体) ), `HeaderContext`, (中文(简体) ), `FooterContext` 财务报告和审定财务报表 `componentRenderer` 保存行/值类型。 表格中从未变异主机数据 . 控制下的布局、选择、密度和等级状态请求主机更改; 忽略请求保留了提供状态.

## 特性和适配器条目

`@adapttable/vue/features` 出口选入工厂和特定特点的选项. 导入共享表格、来源、栏、视图状态和特征组成合同 从 `@adapttable/vue`结构色调、所需插槽道具和适配器 建筑辅助人员所属 `@adapttable/vue/adapter`。 。 。 .

公式、支点、流和火花集成保持匹配绑定 条目。 可选 PDF 和 XLSX 工厂和作家 `/pdf` 财务报告和审定财务报表 `/xlsx`· ; CSV和回调印刷厂 `/features`。 。 。 .

适应作者使用 `@adapttable/vue/adapter` 页:1 `useDataTableShell`语义 属性/折叠桥、结构铬和生命周期/模型通道。 每个 可见的按钮、输入、选择和覆盖由适配器提供。 捆绑 完整属性记录到实际语义元素.

`DataTableSurfaceChrome` 是一个可选择的共享外部布局。 规定 搜索、选择、按钮、加载、桌面和移动渲染器让每个工具箱拥有 其控件、表/卡加码和外观. `DataTableSurfaceSlots` 财务报告和审定财务报表 `DataTableSurfaceChromeProps` 描述这一建筑边界。 根号 可堆肥和直接外壳渲染仍可完全定制 UI 不选择此布局 。 见 [可选布局参考](https://npmcn.com/docs/vue/api.md#optional-adapter-layout)。 。 。 .

外壳会编出列相通的摘要 `useSummaryCells`, (中文(简体) ), `useTableSummaryModel`, (中文(简体) ), `TableSummaryChrome` 财务报告和审定财务报表 `MobileSummaryChrome`。 。 。 . `TableFooterChrome` 将自定义内容放在表外。 地图简编 接收当前源行范围,带有被动 Vue 值并共享 支持中性增量总量.

外壳区分已装入的行和可见的分级行:已崩溃 孩子们保留他们的编辑草稿,同时选择全部跟随可见行. 分组/树表拒绝数据行针;独立摘要仍然有效. 保存视图捕获连接的 URL 切片,包括密度和无控制 pins; 组倒塌和列布局需要明确的主机接线. `useColumnLayoutUrlState` 返回布局/更改/浮动绑定; `useColumnLayoutStorageState` 坚持独立浏览器的偏好。 过 网络 `flush` 作为已保存的视图 `flushViewState` 选项。 选择, 树/细节扩展和编辑草稿不被捕获.

SSR状态是请求本地。 浏览器资源在挂载后启动并暂停 在Keep Alive的下面,我们来 当所有者完成时处理明确的效果范围. 提供等同的初始行、方向、 URL 状态和响应设置 在服务器和客户端上.

读取 [开始中](https://adapttable.orwamahmoud.com/vue/getting-started/), (中文(简体) ), [特性构成](https://adapttable.orwamahmoud.com/vue/features/) 编辑 [Vue API 参考文献](https://adapttable.orwamahmoud.com/vue/api/) 签名, 实例、所需插槽和状态-持久性界限.

## 可选助理 UI

`@adapttable/vue/adapter` 出口 `TableAssistantChrome`, (中文(简体) ), `AgentApprovalChrome`, (中文(简体) ), `ApprovalReviewChrome` 及其规定的装具控制合同。 它进口没有 AI运行时间. 单独的选入 `@adapttable/ai-vue` 软件包连接代理, 和Vue瞄准镜的对话和演讲 见 [助理指南](https://adapttable.orwamahmoud.com/vue/assistant/) 用于核准, 控制更新和生命周期行为。 这些公共软件包在npm上发布.

## 弹出控制槽所有权

在组件设置中创建弹出渲染器功能并读取当前 通过获取器显示道具。 一个新的 `slots` 包含相同对象 渲染器功能是无害的渲染器;它不会开始新的 逻辑会话 。 在每次渲染过程中创建新的渲染器封口替换 他们的主人和退休的回调 被前主人抓住.

`SidePanelChrome` 跟踪 `Frame`, (中文(简体) ), `Tab`,以及 `Close` 制造器(或其 完整 `presentation` (原始内容存档于2018-09-26). productioner. `SavedViewsPanelChrome` 音轨 `Surface`, (中文(简体) ), `Row`, (中文(简体) ), `Input`,以及 `Empty`上下文菜单跟踪其 `Surface` 驱动程序; 保存视图菜单跟踪 `Panel` 驾驶员。 替换上下文菜单 `onClose` 调用还取消了抓取的调用和排队命令。 拿着 函数在样式、标签和其他普通演示文稿更新之间稳定。 槽对象可能是 重新创建,获取器可读取更新的类或方向而不替换 职能。 被替换的模型或召回所有者、被替换的渲染器、关闭 继续关闭, 处理仍会停止调用. 已接受关闭的背景菜单命令仍为一发 当关闭的投影清除其物品或重新创建其表面包装器时.

控制器在挂载成像被冲走后开始活动。 挂载 交互测试, 等待 Vue 的下个勾选, 然后再引用控制 第一次;从不活动部件中捕捉到的回调仍为已退役.

## 常见问题

### @adapttable/vue 是什么？

无头 Adaptable Table的Vue composables和结构表合同——在框架中性引擎上排序,过滤,编辑,分组,URL状态和服务器数据\.

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

在项目目录运行 npm install @adapttable/vue，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.5\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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

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

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

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

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