# @cloudpdf/viewer-react 中文文档
规范地址：https://npmcn.com/package/%40cloudpdf/viewer-react/
版本：3\.1\.0
npm 元数据更新时间：2026-11-08T19:20:51.070Z
中文译文更新时间：2026-11-10T09:41:06.355Z
软件包许可：Apache-2\.0
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40cloudpdf/viewer-react
原文对照：https://npmcn.com/package/%40cloudpdf/viewer-react/?lang=original
项目主页：https://www.cloudpdf.com/
源码仓库：https://github.com/embedpdf/embed-pdf-viewer
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：20.6 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react \>=18
- 首次发布：2026-08-05T21:42:36.449Z
- 最新版本发布：2026-11-08T19:20:50.910Z
- 近 30 天下载量：1756（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）
## 中文简介
以 CloudPDF 引擎作为回放组件的完整取景器默认:与 @embedpdf/viewer-react相同,在 CloudPDF SaaS 或您自己的 @cloudpdf/server 上渲染出HTTPS,本地引擎仅在邮票需要时才加载.
## 安装
```sh
npm install @cloudpdf/viewer-react
```
也可以使用：`pnpm add @cloudpdf/viewer-react`、`yarn add @cloudpdf/viewer-react`、`bun add @cloudpdf/viewer-react`
## README
# @ cloudpdf/ 查看器- react
完整的EmbedPDF取景器作为React组件,以CloudPDF引擎为默认. 那边 您的捆绑中没有 Web Assembly 和 Web Worker 用于读取: 渲染 发生在 CloudPDF (SaaS, 或您自己的 [`@cloudpdf/server`](https://www.npmjs.com/package/@cloudpdf/server)因此 穿过网络的只有HTTPS API流量.
```bash
npm install @cloudpdf/viewer-react
```
```tsx
import { PDFViewer } from '@cloudpdf/viewer-react';
export function Report({ token }: { token: string }) {
return ;
}
```
`src` 文档是: `{ token }` 带有文档符号的后端创建 用于用户(一个字符串,或一个给新字符串的函数), `{ id }` 当 引擎本身 `token` 已经允许了,或者 `{ grant }` 有补助金 从仪表板。 又一个 `src` 打开它的位置。 关于若干文件,见 一次,通过 `documents`: 条目 `{ src, name, password, active }`。 。 。 .
取景器连接了 CloudPDF SaaS (`https://engine.cloudpdf.com`) (中文(简体) ). 属于你的 [`@cloudpdf/server`](https://www.npmjs.com/package/@cloudpdf/server) 进入 引擎设置 : `engine: { baseUrl: 'https://pdf.example.com' }`,与 引擎本身 `token` 财务报告和审定财务报表 `fetch` 旁边.
## 是开放的收视器 引擎换了
这个软件包是 **门** 结束 [`@embedpdf/viewer-react`](https://www.npmjs.com/package/@embedpdf/viewer-react), (中文(简体) ), 由于该软件包与内置引擎是同一个取景器:组件是 同样的 ``周围的每个名字都一样 所有的东西,开放的观众 此处接受的作品不变(`layout`, (中文(简体) ), `commands`, (中文(简体) ), `icons`, (中文(简体) ), `strings`, (中文(简体) ), `theme`, (中文(简体) ), `plugins`里面的组件,随时回电) 文件是逐字记录。 惟相公所传之文.
```tsx
…}>
```
## 文档
[https://www.cloudpdf.com (中文(简体) )](https://www.cloudpdf.com/)
## 许可证
阿帕奇-2.0 — 见 [自由主义](https://npmcn.com/package/%40cloudpdf/viewer-react/LICENSE)。 。 。 .
CloudPDF给浏览器的船都是开源的;所有运行在 服务器是商用的。 这个软件包是浏览器侧面的,所以是Apache-2.0——如同 它包裹的观众,从 [嵌入式PDF](https://www.embedpdf.com/) 开源 项目。 彩绘是在CloudPDF的部署(SaaS,或自备的)下进行的 [`@cloudpdf/server`](https://www.npmjs.com/package/@cloudpdf/server) a 项下 ,即商业部分.
## 常见问题
### @cloudpdf/viewer-react 是什么？
以 CloudPDF 引擎作为回放组件的完整取景器默认:与 @embedpdf/viewer-react相同,在 CloudPDF SaaS 或您自己的 @cloudpdf/server 上渲染出HTTPS,本地引擎仅在邮票需要时才加载\.
### 如何安装 @cloudpdf/viewer-react？
在项目目录运行 npm install @cloudpdf/viewer-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @cloudpdf/viewer-react 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @cloudpdf/viewer-react 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @cloudpdf/viewer-react 可以商用吗？
@cloudpdf/viewer-react 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。
### @cloudpdf/viewer-react 的下载量有多少？
根据 npm 官方下载统计，@cloudpdf/viewer-react 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,756 次，日均约 59 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @cloudpdf/viewer-react 还在维护吗？
最新版本 3\.1\.0 发布于 2026/11/09（1 天前）；至今共发布 26 个版本，其中过去 12 个月发布了 26 个；首次发布于 2026/08/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。