为 pdf.js 的移动端体验注入手势缩放：一种非侵入式增强方案

1. 为什么移动端PDF阅读需要手势缩放？

在移动设备上浏览PDF文档时，用手指捏合缩放几乎成了肌肉记忆。我做过一个小范围调查，超过90%的用户第一次打开PDF时会下意识做双指缩放动作，当发现无效时会露出困惑的表情。这种交互习惯的养成，很大程度上得益于手机相册、地图应用等高频场景的长期教育。

pdf.js作为浏览器内嵌PDF阅读的标杆解决方案，默认的"+"、"-"按钮缩放方式在桌面端尚可接受，但在触屏设备上就显得格格不入。我曾亲眼目睹用户反复点击缩略图以为是缩放按钮，这种体验断层会显著降低产品的好感度。更关键的是，移动端场景下用户常常需要快速放大查看图表细节或缩小把握整体布局，按钮操作在这种高频交互中显得尤为笨拙。

2. 理解pdf.js的缩放机制

2.1 核心缩放方法解析

扒开pdf.js的源码会发现，缩放功能主要依赖viewer.js中的两个关键方法：

javascript复制// 放大逻辑
zoomIn(ticks) {
  if (this.pdfViewer.isInPresentationMode) return;
  let newScale = this.pdfViewer.currentScale;
  do {
    newScale = (newScale * DEFAULT_SCALE_DELTA).toFixed(2);
    newScale = Math.ceil(newScale * 10) / 10;
    newScale = Math.min(_ui_utils.MAX_SCALE, newScale);
  } while (--ticks > 0 && newScale < _ui_utils.MAX_SCALE);
  this.pdfViewer.currentScaleValue = newScale;
}

// 缩小逻辑
zoomOut(ticks) {
  if (this.pdfViewer.isInPresentationMode) return;
  let newScale = this.pdfViewer.currentScale;
  do {
    newScale = (newScale / DEFAULT_SCALE_DELTA).toFixed(2)