@cloudpdf/viewer

中文文档
3.1.0发布于 2026/11/09Apache-2.0TypeScriptES Module近 30 天下载 2245

以 CloudPDF 引擎为默认值的开源 EmbedPDF 查看器: , init () 和每个框架包装器的名称,在 CloudPDF SaaS 或您自己的@cloudpdf/ server 上提供的页面,本地引擎仅在需要邮票时才加载. 点/点

中文使用文档

@ cloudpdf/ 查看器

以 CloudPDF 引擎作为默认的全 EmbedPDF 查看器: 相同 <embedpdf-viewer> 元素和 init() 作为 @embedpdf/viewer,其 文档在 CloudPDF (SaaS, 或您自己的 @cloudpdf/server) (中文(简体) ). 开幕 而读取的文档仅为HTTPS API流量. 唯一的例外是邮票: 邮票库是 PDF 在浏览器中切入邮票,所以第一次 有人打开印花或签名 查看器加载本地引擎 (单位:千美元)embedpdf.wasm,在同一个文件夹中运出). 过 plugins: { stamp: { assetEngine } } 提供你自己的.

使用量

<embedpdf-viewer id="viewer" style="height: 100vh"></embedpdf-viewer>

<script type="module">
  import 'https://cdn.jsdelivr.net/npm/@cloudpdf/viewer@3/dist/cloudpdf.js';

  document.getElementById('viewer').src = { grant: 'grt_…' };
</script>

云文档不是URL,所以它是从脚本中给出的,而不是作为属性. 或者从脚本创建取景器:

import CloudPDF from 'https://cdn.jsdelivr.net/npm/@cloudpdf/viewer@3/dist/cloudpdf.js';

CloudPDF.init({ target: '#viewer', src: { token: '<document token>' } });

src 文档是: { token } 带有文档符号的后端创建 用于用户(一个字符串,或一个给新字符串的函数), { id } 当 引擎本身 token 已经允许了,或者 { grant } 有补助金 从仪表板。 又一个 src 打开它的位置。 关于若干文件,见 一次,通过 documents: 条目 { src, name, password, active }。 。 。 .

取景器连接了 CloudPDF SaaS (https://engine.cloudpdf.com) (中文(简体) ). 属于你的 @cloudpdf/server 进入 引擎设置 : engine: { baseUrl: 'https://pdf.example.com' },与 引擎本身 token 财务报告和审定财务报表 fetch 旁边.

开源查看器的每个定制选项(布局、命令、, 图标、主题、语言)沿着逐字记录;参见 嵌入式PDF 文件 用于词汇.

从 npm 而不是 CDN :

npm install @cloudpdf/viewer
import CloudPDF from '@cloudpdf/viewer';

许可证

阿帕奇-2.0 — 见 自由主义。 。 。 .

CloudPDF给浏览器的船都是开源的;所有运行在 服务器是商用的。 这个文物是浏览器侧面,所以是Apache-2.0——作为 是取景器铬和引擎接口 它的基于,从 嵌入式PDF 开源项目. 发作发生在一个 CloudPDF的部署(SaaS, 或自主办 @cloudpdf/server a 项下 ,即商业部分.

版本与发布记录

@cloudpdf/viewer 共发布 32 个版本,首次发布于 2022/08/16;过去 12 个月发布了 26 个版本。

版本发布日期距今
3.1.0latest2026/11/091 天前
3.0.02026/11/073 天前
3.0.0-next.23next2026/11/073 天前
3.0.0-next.222026/11/045 天前
3.0.0-next.212026/11/036 天前
3.0.0-next.202026/11/037 天前

关于 @cloudpdf/viewer 的常见问题

@cloudpdf/viewer 是什么?

以 CloudPDF 引擎为默认值的开源 EmbedPDF 查看器: , init () 和每个框架包装器的名称,在 CloudPDF SaaS 或您自己的@cloudpdf/ server 上提供的页面,本地引擎仅在需要邮票时才加载. 点/点

如何安装 @cloudpdf/viewer?

在项目目录运行 npm install @cloudpdf/viewer,或使用 pnpm add / yarn add / bun add。

@cloudpdf/viewer 支持 TypeScript 吗?

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

@cloudpdf/viewer 支持 ESM 还是 CommonJS?

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

@cloudpdf/viewer 可以商用吗?

@cloudpdf/viewer 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cloudpdf/viewer 的下载量有多少?

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

@cloudpdf/viewer 还在维护吗?

最新版本 3.1.0 发布于 2026/11/09(1 天前);至今共发布 32 个版本,其中过去 12 个月发布了 26 个;首次发布于 2022/08/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。