# @ag-media/react-pdf-table 中文文档

规范地址：https://npmcn.com/package/%40ag-media/react-pdf-table/

版本：2\.0\.3
npm 元数据更新时间：2025-05-15T12:57:21.152Z
中文译文更新时间：2026-11-05T17:35:21.573Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ag-media/react-pdf-table
原文对照：https://npmcn.com/package/%40ag-media/react-pdf-table/?lang=original
项目主页：https://github.com/ag-media/react-pdf-table.git#README
源码仓库：https://github.com/ag-media/react-pdf-table

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

- 包体积（解压后）：83.2 kB，22 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@react-pdf/renderer ^2\.0\.2 \|\| ^3\.0\.0 \|\| ^4\.0\.0，@react-pdf/stylesheet ^2\.0\.0 \|\| ^3\.0\.0 \|\| ^4\.0\.0 \|\| ^5\.0\.0 \|\| ^6\.0\.0，react ^16\.8\.6 \|\| ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0
- 首次发布：2023-06-19T17:26:05.492Z
- 最新版本发布：2025-05-15T12:57:20.945Z
- 近 30 天下载量：236280（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 0 个）

## 中文简介

@ react-pdf/ renderer 的宣告表生成器.

## 安装

```sh
npm install @ag-media/react-pdf-table
```

也可以使用：`pnpm add @ag-media/react-pdf-table`、`yarn add @ag-media/react-pdf-table`、`bun add @ag-media/react-pdf-table`

## README

# @ag-media/ react-pdf-表

`@ag-media/react-pdf-table` 是用于 [@ react-pdf/anderser (英语)](https://github.com/diegomura/react-pdf)。 。 。 .

> **3⁄4 ̄ ̧漯B**  
> 该图书馆专门设计用于: **@ react-pdf/anderser (英语)** 并将 **没有工作** 与其他反应成像器.

[![npm version](http://img.shields.io/npm/v/@ag-media/react-pdf-table.svg?style=flat)](https://npmjs.org/package/@ag-media/react-pdf-table "View this project on npm")

![example](https://npmcn.com/package/%40ag-media/react-pdf-table/.github/assets/readme-example.webp)

## 开始

```bash
npm install --save-dev @ag-media/react-pdf-table
```

### 基本实例

```jsx
import {Table, TR, TH, TD} from '@ag-media/react-pdf-table';

const Component = () => (
    <Table>
        <TH>
            <TD>Header 1</TD>
            <TD>Header 2</TD>
        </TH>
        <TR>
            <TD>Data 1</TD>
            <TD>Data 2</TD>
        </TR>
    </Table>
);
```

提示: 您可以使用短写( H)`<TH />`, (中文(简体) ), `<TR />`, (中文(简体) ), `<TD />`)或(或) 长 (`<TableHeader />`, (中文(简体) ), `<TableRow />`, (中文(简体) ), `<TableCell />`) 命名进口.

参考Repo的 [故事书](https://ag-media.github.io/react-pdf-table) 需要更多的实例.

## 小心点

虽然这个库涵盖了通常的表格布局,但它不是一个完整的或 防弹溶液. 因为并非所有布局都能够100%地实现 当前反应- pdf 原始数据,表格组件需要在 反应-pdf (**[提出这个问题](https://github.com/diegomura/react-pdf/issues/2343)**) (中文(简体) ).

## 页:1

### 表格目录

表格中的内容必须评估到 `string`, (中文(简体) ), `number`, (中文(简体) ), `<Fragment />` 或一个 `@react-pdf/renderer` 构成部分`View`, (中文(简体) ), `Text` 页:1.

### 桌边 `tdProps` 财务报告和审定财务报表 `trProps`

这两道道具会传给所有的"桌球"和"桌球". 可能会 用于样式单元格/行([样式示例](https://github.com/ag-media/react-pdf-table/blob/master/stories/styles.stories.tsx)) (中文(简体) ).

### `weighting`

加权可以定义为表格中所有行一次 `weightings` 道具 和每张表格单。 表单的 `weighting` 道具有优先级 超过表 `weightings`。 。 。 .

若为 `weighting` 没有定义表格单元格, 则默认为占用 剩余空间的等量.

总和 `weighting`s 对于一行必须到一,除非你想 一行比表格小.

## 限制/已知问题

-   页面包装可能以出乎意料的方式发生 : ![example](https://npmcn.com/package/%40ag-media/react-pdf-table/.github/assets/broken-page-wrap.webp)
    
-   弹性布局用于模拟表格的外观。 因为这个,它是 做柱子不排队是微不足道的.
    
-   边框崩溃
    
    因为没有这样的东西 在反应 -pdf, 这必须 "集成" 负差值。 这对不违约特别痛苦 边框样式(例如:. [外部边界](https://github.com/ag-media/react-pdf-table/blob/master/stories/borderStyles/outer.stories.tsx)(中文(简体) )
    
-   虚设和虚设的表格边框可能不规则或重叠

## 常见问题

### @ag-media/react-pdf-table 是什么？

@ react-pdf/ renderer 的宣告表生成器\.

### 如何安装 @ag-media/react-pdf-table？

在项目目录运行 npm install @ag-media/react-pdf-table，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@react-pdf/renderer（^2\.0\.2 \|\| ^3\.0\.0 \|\| ^4\.0\.0）、@react-pdf/stylesheet（^2\.0\.0 \|\| ^3\.0\.0 \|\| ^4\.0\.0 \|\| ^5\.0\.0 \|\| ^6\.0\.0）、react（^16\.8\.6 \|\| ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ag-media/react-pdf-table 支持 TypeScript 吗？

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

### @ag-media/react-pdf-table 支持 ESM 还是 CommonJS？

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

### @ag-media/react-pdf-table 可以商用吗？

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

### @ag-media/react-pdf-table 的下载量有多少？

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

### @ag-media/react-pdf-table 还在维护吗？

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

