跳到主要内容

PDF 查看器配置

在应用中选择四种查看器类型之一，配置 PDF 向顾客的显示方式。

在哪里配置​

在 PDF 详情页的查看器配置部分设置查看器类型。

此配置适用于该 PDF 已链接的主题应用扩展（包括按钮弹窗和嵌入式查看器）。​

手动 URL 区块使用主题区块架构中的查看器设置。手动 URL 区块 →

四种查看器类型​

自定义查看器（功能完整）​

功能最强大的选项，可对 PDF 查看体验进行全面控制。

功能：

  • 全部导航控件
  • 搜索功能
  • 缩放工具和可定制的显示选项
  • 移动端优化查看

配置选项：

PDF 查看器设置：

  • 初始页面 — 首先显示哪一页（第 1 页、第 2 页、第 3 页等）
  • 初始缩放 — 默认缩放级别（自动适应、适应宽度、适应页面、50%、75%、100%、125%、150%、200%）
  • 页面布局 — 单页、双页（奇数页）、双页（偶数页）
  • 滚动方向 — 垂直、水平、换行、翻页滚动

工具栏与功能：

  • 启用下载 — 允许顾客下载 PDF
  • 显示工具栏 — 显示导航工具栏
  • 启用添加图片/印章工具 — 允许顾客添加图片或印章
  • 启用高亮工具 — 文字高亮功能
  • 启用绘图工具 — 在 PDF 上进行自由绘画
  • 启用文字选择 — 允许选择和复制文字

最适合：

  • 需要缩放和搜索功能的技术文档
  • 需要导航的产品手册
  • 顾客需要高亮或批注的文档
  • 桌面端和移动端查看

轻量查看器（快速简洁）​

专为速度和简洁性优化的精简查看器。

功能：

  • 简单、加载快速的查看器
  • 简洁界面
  • 适合快速文档预览
  • 移动端优化

配置选项：

  • 无 — 开箱即用！

最适合：

  • 快速参考文档
  • 不需要高级功能的简单 PDF
  • 以移动端为主、注重快速加载的商店
  • 保修卡、证书、简单表格

原生浏览器查看器（标准版）​

使用浏览器内置的 PDF 查看器，提供熟悉的标准体验。

功能：

  • 浏览器原生 PDF 查看功能
  • 可靠且通用兼容
  • 无需额外配置
  • 注意： 不同浏览器（Chrome、Safari、Firefox 等）的查看体验可能有所不同

配置选项：

  • 无 — 使用浏览器默认设置

最适合：

  • 习惯标准浏览器 PDF 查看方式的顾客
  • 不需要自定义功能的简单文档
  • 在所有浏览器间实现最大兼容性
  • 无需定制的直接 PDF 展示

重要提示： 由于使用的是各浏览器的原生 PDF 查看器，不同浏览器和设备上的体验可能不一致。

翻页查看器（交互式翻页）​

模拟翻阅实体书的交互式翻页体验。

功能：

  • 翻页动画
  • 逼真的书籍/杂志阅读体验
  • 适合视觉型目录内容
  • 未针对移动端优化

配置选项：

  • 动画风格 — 流畅动画、快速动画、无动画
  • 页面阴影 — 添加逼真的阴影和立体效果
  • 背景颜色 — 浅灰色、白色、米白色、中灰色、深灰色

最适合：

  • 目录和宣传册
  • 营销材料和产品手册
  • 杂志风格内容
  • 桌面端查看体验

不推荐用于：

  • 以移动端为主的商店
  • 技术文档
  • 文字密集的长篇 PDF

链接区块与手动区块的查看器配置​

流程查看器配置位置适用范围
链接区块 (pdf_embedded、pdf_button)应用内 PDF 详情页每个 PDF
手动区块 (pdf_embedded_manual、pdf_button_manual)主题区块设置每个区块

手动区块支持相同的四种查看器类型：

  • 原生浏览器
  • 自定义查看器
  • 翻页查看器
  • 轻量查看器

对于手动区块，一个查看器配置适用于该区块中的所有 URL。

如何设置查看器配置​

  1. 在应用中进入您的 PDF 库
  2. 点击您要配置的 PDF
  3. 找到查看器配置部分
  4. 点击展开该部分
  5. 从下拉菜单中选择查看器类型
  6. 配置该查看器类型的可用选项
  7. 点击保存配置

查看器配置全局生效​

您选择的查看器配置适用于：

  • ✅ 按钮扩展弹窗（顾客点击按钮时）
  • ✅ 嵌入式查看器（在页面上内联显示的 PDF）
  • ✅ 显示该 PDF 的所有模板
  • ✅ 该 PDF 已链接的所有资源

只需设置一次，即可在该 PDF 所有显示位置生效。

对于手动区块，您在区块本身设置查看器选项，这些选项适用于该区块中的所有 URL。

扩展设置与查看器配置的区别​

请勿混淆以下两者：

查看器配置（应用内）扩展设置（主题编辑器）
自定义、轻量、原生浏览器或翻页查看器按钮颜色、文字、对齐方式
缩放、工具栏、下载选项查看器高度、标题文字
页面布局、滚动方向容器边框、弹窗大小
每个 PDF 设置一次在主题中每个扩展单独设置
控制 PDF 功能控制样式和布局

手动区块将两者合并在主题设置中：URL 列表 + 查看器类型 + 查看器选项。

示例：

  • 选择自定义查看器，启用下载并设置初始缩放为 100% → 这是查看器配置
  • 将按钮颜色设为蓝色，弹窗大小设为 80% → 这是扩展设置

随时更改查看器配置​

您可以随时更改查看器类型：

  1. 打开 PDF 详情页
  2. 展开查看器配置
  3. 选择其他查看器类型
  4. 调整设置
  5. 点击保存配置

更改立即生效，适用于所有显示该 PDF 的主题应用扩展。

查看器配置技巧​

从自定义查看器开始：

  • 功能最全面
  • 适合大多数使用场景
  • 高度可配置

切换至轻量查看器的情况：

  • PDF 加载缓慢
  • 希望提供最简洁的体验
  • 移动端速度至关重要

使用原生浏览器查看器的情况：

  • 顾客偏好标准浏览器 PDF 体验
  • 需要最大兼容性
  • 不需要自定义功能

使用翻页查看器的情况：

  • 桌面端体验为主
  • 视觉呈现最为重要
  • 拥有目录风格内容

测试您的选择：

  • 在桌面和移动端预览
  • 收集顾客反馈
  • 监控 PDF 参与度

后续步骤​