# @getsoren/data-grid 中文文档

规范地址：https://npmcn.com/package/%40getsoren/data-grid/

版本：4\.1\.8
npm 元数据更新时间：2026-09-30T22:00:26.584Z
中文译文更新时间：2026-11-16T06:53:29.563Z
软件包许可：ISC

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

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

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

- 包体积（解压后）：28.8 kB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：react ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0，@mui/x-license \>=7\.0\.0，@getsoren/design-system \>=4\.0\.0，@mui/x-data-grid-premium \>=8\.0\.0
- 首次发布：2026-05-15T22:03:40.864Z
- 最新版本发布：2026-09-30T22:00:26.407Z
- 近 30 天下载量：3929（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

反应数据表和反应数据网格

## 安装

```sh
npm install @getsoren/data-grid
```

也可以使用：`pnpm add @getsoren/data-grid`、`yarn add @getsoren/data-grid`、`bun add @getsoren/data-grid`

## README

# @ getsoren/ 数据网

**反应库数据表和数据网格**

> 图书馆基于 [MUI 十届理事会](https://mui.com/x/introduction/)

-   [安装](https://npmcn.com/package/%40getsoren/data-grid/#readme-Installation)
-   [使用量](https://npmcn.com/package/%40getsoren/data-grid/#readme-Usage)
-   [附加道具](https://npmcn.com/package/%40getsoren/data-grid/#readme-Additional-props)

## 安装

```console
yarn add @getsoren/design-system @getsoren/data-grid 
```

或者说

```console
npm install @getsoren/design-system @getsoren/data-grid 
```

## 使用量

```typescript
import { DataGrid, DataGridProvider, GridColDef, GridRowsProp} from "@getsoren/data-grid";

const columns: GridColDef[] = [
  {
    field: "name",
    headerName: "Name",
  },
  {
    field: "companies",
    headerName: "Companies", 
  },
];

const rows : GridRowsProp = [
  {
    companies: "Tracktor",
    name: "Kevin Durant",
  },
];

const App = () => (
  <DataGridProvider licence={"YOUR_LICENSE_MUI"}>
    <DataGrid rows={rows} columns={columns} />
  </DataGridProvider>
);
```

## 附加道具

此库将所有道具从 [MUI 十届理事会](https://mui.com/x/introduction/) 并在 DataGrid 组件中添加一些道具.

| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| 高度 | 数字 qq 字符串 | 未定义 | 设置网格高度 |
| 面板厚度 | 数字“ 自动” | 未定义 | 设置自定义面板的高度 `getDetailPanelContent` 提供 |
| 变体 | "外线" | 未定义 | 设定变体 |
| 上升 | 编号 | 1个 | 设定高度。 这个道具只能用到 `elevation` 变种. |
| nbeRowsLoading斯凯勒通 | 编号 | 第7条 | 设定装入骨架的行数 |
| 装入变量 | "斯凯莱通""线性" | "斯凯勒通" | 设置装入变体样式 |
| 正在丢失 | 布尔 | 未定义 | 装入时不使用 |

## 常见问题

### @getsoren/data-grid 是什么？

反应数据表和反应数据网格

### 如何安装 @getsoren/data-grid？

在项目目录运行 npm install @getsoren/data-grid，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）、@mui/x-license（\>=7\.0\.0）、@getsoren/design-system（\>=4\.0\.0）、@mui/x-data-grid-premium（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @getsoren/data-grid 支持 TypeScript 吗？

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

### @getsoren/data-grid 支持 ESM 还是 CommonJS？

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

### @getsoren/data-grid 可以商用吗？

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

### @getsoren/data-grid 的下载量有多少？

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

### @getsoren/data-grid 还在维护吗？

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

