@brotskyllc/react-data-table

中文文档
0.1.0发布于 2026/10/06MITTypeScriptES Module近 30 天下载 6.8万

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

中文使用文档
文档目录3 节
  1. 使用量
  2. 造型和定制
  3. 发展和分配

重现数据表

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

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

使用量

'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, 添加相对于样式表的路径 :

@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 。 业务行动仍然是由应用程序提供的功能的单元格.

发展和分配

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 共发布 2 个版本,首次发布于 2026/10/06;过去 12 个月发布了 2 个版本。

版本发布日期距今
0.1.0latest2026/10/061 个月前
0.0.0-stage2026/10/061 个月前

关于 @brotskyllc/react-data-table 的常见问题

@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 和提交记录判断。