# @brotskyllc/react-data-table 中文文档

规范地址：https://npmcn.com/package/%40brotskyllc/react-data-table/

版本：0\.1\.0
npm 元数据更新时间：2026-10-05T21:54:45.231Z
中文译文更新时间：2026-11-08T16:08:28.545Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：117 kB，94 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：6 个
- peer 依赖：react ^19\.0\.0，react-dom ^19\.0\.0
- 首次发布：2026-10-05T21:53:50.698Z
- 最新版本发布：2026-10-05T21:54:45.046Z
- 近 30 天下载量：68008（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

受控回放数据表渲染,并附有选择,扩展,排序,再大小和懒惰拖放支持.

## 安装

```sh
npm install @brotskyllc/react-data-table
```

也可以使用：`pnpm add @brotskyllc/react-data-table`、`yarn add @brotskyllc/react-data-table`、`bun add @brotskyllc/react-data-table`

## README

# 重现数据表

从AEGIS的共享表格中取出的控制回放19表渲染器. 主机拥有数据获取,搜索,过滤,页码化,选择状态,偏好,商业动作,以及输出. 本软件包不进行网络或存储访问.

**麻省理工学院有执照.** 来源为公众. 公共 npm 软件包名称为 `@brotskyllc/react-data-table`; 在首次发布后, 安装 `npm install --save-exact @brotskyllc/react-data-table@0.1.0`启用 `npm view @brotskyllc/react-data-table version` 以检查登记册的可用性。 验了验收 `npm pack` 文物也得到支持。 在再分配时保留LICENSE和TIII PARTY NOTICES.md.

## 使用量

```tsx
'use client';
import { DataTableCore, type TableColumn } from '@brotskyllc/react-data-table';

type Item = { id: string; name: string; count: number };
const columns: TableColumn<Item>[] = [
  { key: 'name', header: 'Name' },
  { key: 'count', header: 'Count', className: 'text-right' },
  { key: 'actions', header: 'Actions', render: (_value, row) => <button onClick={() => console.log(row.id)}>Open</button> },
];
export function Example({ rows }: { rows: Item[] }) {
  return <DataTableCore data={rows} columns={columns} scrollAreaLabel="Items"
    onSort={() => {}} onSelectAll={() => {}} onRowSelect={() => {}} />;
}
```

使用稳定的独特字符串 `id` 用于选择、扩展、拖放和内置拾取器的数值。 指数回落只适合静态,非交互行.

## 造型和定制

该套件使用Tailwind公用事业和语义符号(`background`, (中文(简体) ), `foreground`, (中文(简体) ), `muted`, (中文(简体) ), `border`, (中文(简体) ), `ring`, (中文(简体) ), `primary`, (中文(简体) ), `popover`) (中文(简体) ). 在主机的 Tailwind 扫描中包含其已发布源 。 对于 Tailwind 4, 添加相对于样式表的路径 :

```css
@source "../../../node_modules/@brotskyllc/react-data-table/src";
```

尾风3包括 `./node_modules/@brotskyllc/react-data-table/src/**/*.{ts,tsx}` 内 `content`。提供现有的轻/暗主题和动画公用事业.

-   `columns`:嵌入式密钥,自定义单元格渲染,宽度,对齐,页眉工具提示, `headerClassName` 和细胞课.
-   `sort` + 键 `onSort`:控制指标和回调. 制造器不会重排行. `sortRowsByColumn` 是可选的不可变客户端类帮助者.
-   `selection`, (中文(简体) ), `allSelected`, (中文(简体) ), `hasSelectableRows`, (中文(简体) ), `onSelectAll`, (中文(简体) ), `onRowSelect`:主机控制状态和资格. 主机定义了选择范围并保留了非页面选择.
-   `expandableRows`:可控或局部扩展并带有可访问切换标签和面板ID.
-   `columnResize`: 结构 `ColumnResizeApi` 适配器. 主机拥有测量,界限,存储和持久性. 控件支持指针拖放,箭头(用于较大步),主控和双击重置.
-   `draggable`: 选入懒惰拖放正文和主机 `onDragEnd`;需要稳定的ID. React Suspense取代了原来的"下"特异性加载器.
-   `rowClassName`,行徘徊/点击回调,测试ID, `footer`, (中文(简体) ), `emptyState`, (中文(简体) ), `isTableLoading`,以及 `loadingRowCount` 覆盖演示文稿定制.
-   `useDataTableRowPickerOpen`:通过行刷新保留内线拾取状态. 从与渲染器相同的包中导入此钩子, 因此上下文身份仍然共享 .

保留认证, GraphQL 类型, 应用程序 ID, 导出审计, 保存视图, 响应面色调, pagination 和重试主机中的 UI 。 业务行动仍然是由应用程序提供的功能的单元格.

## 发展和分配

```sh
npm ci
npm run build
bun test
npm pack --dry-run
npm run check:package
npm run test:consumer
```

TypeScript 发布无害环境管理和申报。 反应仍然是对等依赖;第三方代码被安装为依赖而非捆绑. 客户端条目保留 `use client`; 相对进口用途 `.js` 关于本土无害环境管理兼容性.

该建筑在编译前会清除旧输出. 软件包审计检查真实的沥青球,检查其许可列表,导出目标,客户端边界和反应端,并扫描证书模式,私人进口和工作站路径. 消费者检查将柏花球安装入一个临时应用程序,解决了本土ESM中的两个条目,检查了严格TypeScript设置的申报,服务器-发送合成行,并从已发布源生成Tailwind 3风格. 它使用网络访问来安装公共依赖性,并在完成后删除其临时文件. 检查都不公布任何信息.

在扩大向其他表格迁移之前,应审查初始适应器。 没有配置注册发布自动化 。 登记出版物需要所有者批准、经核实的npm组织访问和最后成套审计。 发布核准的柏油球 `npm publish <tarball> --access public --registry=https://registry.npmjs.org/`永不提交登记证书.

## 常见问题

### @brotskyllc/react-data-table 是什么？

受控回放数据表渲染,并附有选择,扩展,排序,再大小和懒惰拖放支持\.

### 如何安装 @brotskyllc/react-data-table？

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

### @brotskyllc/react-data-table 支持 TypeScript 吗？

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

### @brotskyllc/react-data-table 支持 ESM 还是 CommonJS？

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

### @brotskyllc/react-data-table 需要什么版本的 Node\.js？

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

### @brotskyllc/react-data-table 可以商用吗？

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

### @brotskyllc/react-data-table 的下载量有多少？

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

### @brotskyllc/react-data-table 还在维护吗？

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