# @fieldia/grid 中文文档

规范地址：https://npmcn.com/package/%40fieldia/grid/

版本：0\.36\.1
npm 元数据更新时间：2026-10-28T10:19:49.019Z
中文译文更新时间：2026-11-14T17:21:54.437Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fieldia/grid
原文对照：https://npmcn.com/package/%40fieldia/grid/?lang=original
项目主页：https://fieldia.dev/
源码仓库：https://github.com/fieldia-dev/fieldia

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

- 包体积（解压后）：601 kB，21 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：ag-grid-community ^36\.0\.0
- 首次发布：2026-10-02T15:14:14.731Z
- 最新版本发布：2026-10-28T10:19:48.615Z
- 近 30 天下载量：4073（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

Fieldia在AG Grid上的行表: 电子表格在单元格中用Fieldia自己的字段编辑.

## 安装

```sh
npm install @fieldia/grid
```

也可以使用：`pnpm add @fieldia/grid`、`yarn add @fieldia/grid`、`bun add @fieldia/grid`

## README

# @fieldia/ grid

A 类 [外地](https://fieldia.dev/) 作为电子表格的行表 [AG 网格社区](https://www.ag-grid.com/)。每个单元格都经过编辑 Fieldia自己的球场 被线接通 所以每个键盘 键入单元格时到达窗体,并随之计算出数值.

```sh
npm install @fieldia/grid ag-grid-community
```

```ts
import { mountViewer } from '@fieldia/viewer';
import { gridWidgets } from '@fieldia/grid';

mountViewer(host, { page, dataSource, widgets: gridWidgets });
```

一个12个节点选择使用 `"widget": "grid"`; 节点没有它保持 plain table, 所以不使用网格的页面从不加载 AG Grid 。 在反应中 通过 `widgets={gridWidgets}`时,在 Vue `:widgets="gridWidgets"`,以角为单位 `[widgets]="gridWidgets"`。 。 。 .

```json
{ "type": "field", "id": "f-lines", "field": "line_ids", "widget": "grid",
  "totals": ["qty", "subtotal"], "optionalColumns": { "discount": "show" } }
```

-   **密钥**: 输入时保留单元格并下移, Tab 移动过( skipping) 无法编辑的单元格, Tab 或 Enter 结尾处启动一行新行, 逃出后置单元格, 空格勾选是/否, Alt+Up/ Down 移动行 .
-   **节和说明** (单位:千美元)`lineKinds` 横行; a 音符随打入而增长.
-   **移动线路** 用一个手柄,有一个 `sequenceField` 在球场上.
-   **共计** 在线下, **栏** 改变大小、移动和选择 (在观众席上) `preferences` 存储, **长表格** 那个卷轴 内部,以及 `"editMode": "row"` 立即打开整条线。 列移动 如列表中的那样,通过拖动其标题: 网格从不隐藏它, 一根手指休息片刻 在一个头端抬起它的柱子 (一丝一毫地滚动页面),它的新位置被说到屏幕上 读者.
-   **拒绝保存** 标记错误的单元格,打开第一个单元格.
-   **在电话上** (网格520px宽度或更小)它的行是卡,如: 节点说 `"cards": "narrow"`:每个值按其列的标签排列, 一张卡片的标题以自己的形式打开了线条(一节或注释部分), 如果放手的话, 这里 主机不给对话框打开一条线, 网格会保持一个网格; `"cards": "never"` 留着吧, `"always"` 在每个宽度制作牌.
-   **选择了一条线的改变** 在它的单元格下,行是 高高高高高高高高高高出声.
-   **大多数行** (单位:千美元)`"options": { "max": 12 }` 在节点上,作为平板桌子 保存它们:最多添加一行的复制件, 在最后一行末尾输入或标签,则不添加.
-   **从电子表格粘贴的行** 在选中的单元格上( Ctrl+V, Safari 中的QQV) 或在一个单元格中,点击打开打字,请按自己的行从 它,当平板表格贴上它们时:每个单元格读作它的一栏读作什么 键入,通过源代码的搜索按其确切名称链接 名称读取为没有记录完全不粘贴;行过最后一行后添加 线条, 最多 节点 `options.max` 允许; 一张纸条上写着什么, 线条加了,什么没有,为什么。 一个值粘贴在打开的单元格中 留在它的盒子里。 读者来到了线段,要求第一个 块被粘贴的时间 .

`gridApiOf(element)` 返回网格后方的 AG 网格 API,作为应用程序 需要超过页面描述的更多.

麻省理工学院. AG网格社区也是麻省理工学院;AG网格企业公司没有使用.

## 常见问题

### @fieldia/grid 是什么？

Fieldia在AG Grid上的行表: 电子表格在单元格中用Fieldia自己的字段编辑\.

### 如何安装 @fieldia/grid？

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

### @fieldia/grid 支持 TypeScript 吗？

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

### @fieldia/grid 支持 ESM 还是 CommonJS？

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

### @fieldia/grid 可以商用吗？

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

### @fieldia/grid 的下载量有多少？

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

### @fieldia/grid 还在维护吗？

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