纯前端实现的图片批量转 PDF 工具技术实现

0 阅读9分钟

关键词:图片转 PDF、pdf-lib、FileSaver.js、多图合并、本地处理、纯前端、JavaScript、Canvas


一、背景与需求

日常生活和工作中,经常需要把多张图片合并成一个 PDF 文件:身份证正反面、银行流水截图、发票照片、手写笔记扫描件等。分开发送不方便,合并在一起又很麻烦。

现有的图片转 PDF 工具普遍存在以下问题:

  • 图片需上传到第三方服务器,身份证、发票、银行卡等敏感图片泄露风险高;
  • 多数工具只能按上传顺序合并,无法调整图片顺序,合并后发现顺序错了还要重新上传;
  • 页面尺寸与边距固定,不适合打印或装订场景;
  • 部分工具需要安装客户端、注册登录,或加水印、限制转换次数。

基于此,我开发了 Toolion 图片批量转 PDF 工具(项目地址:toolion.cn/image-to-pd… PDF 应用,全部处理在浏览器本地完成,无需上传。 在这里插入图片描述


二、核心功能

功能说明
多图片合并支持一次性上传多张 JPG、PNG、WebP、GIF、BMP 图片,合并为一个 PDF
拖拽调整顺序上传后可通过拖拽调整图片在列表中的位置,合并时按最终顺序生成页面
页面尺寸自定义支持自动适应图片、A4、Letter 三种页面尺寸
页边距可选支持无边距、小(20pt)、中(40pt)、大(60pt)四种边距
按比例缩放居中图片尺寸不一致时自动按比例缩放并居中,避免变形
生成进度提示处理多张图片时显示进度条与当前处理张数
纯前端本地处理所有处理在浏览器内存完成,图片不上传服务器,支持离线运行
免登录免费无水印打开页面即用,无需注册,不加水印,不限制转换次数
深色/浅色主题CSS 变量适配深色模式

三、技术实现

3.1 整体架构

该工具是一个纯前端单页面应用,未引入 Vue/React 等前端框架,全部逻辑使用原生 JavaScript 实现:

浏览器端(纯原生 JavaScript)
├── 输入层:图片文件选择/拖拽、页面尺寸、页边距
├── 处理层:文件去重、拖拽排序、图片嵌入 PDF、页面布局计算
├── 生成层:pdf-lib 创建 PDF 文档并嵌入图片,FileSaver.js 下载
└── 渲染层:文件列表、进度条、结果面板、下载按钮

3.2 依赖库

页面通过 CDN 引入两个关键库:

<script src="https://unpkg.com/pdf-lib@1.17.1/dist/pdf-lib.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/FileSaver.js/2.0.5/FileSaver.min.js"></script>
  • pdf-lib@1.17.1:纯 JavaScript PDF 库,用于创建 PDF 文档、嵌入图片、添加页面、保存输出;
  • FileSaver.js@2.0.5:用于将生成的 Blob 保存为 PDF 文件,非 HTTPS 环境下降级为 a.download 原生下载。

3.3 图片上传与去重

支持点击选择和拖拽上传,接受 image/png, image/jpeg, image/webp, image/gif, image/bmp 类型。

为避免重复文件干扰顺序,按文件名 + 文件大小 + 修改时间构建唯一键进行去重:

function handleFiles(fileListObj) {
  const existingKeys = new Set(files.map(f => `${f.name}_${f.size}_${f.lastModified}`));
  for (let file of fileListObj) {
    if (!isImageFile(file)) continue;
    const key = `${file.name}_${file.size}_${file.lastModified}`;
    if (existingKeys.has(key)) continue;
    existingKeys.add(key);
    files.push(file);
  }
  renderList();
}

isImageFile 优先判断 MIME 类型,兜底通过扩展名识别,兼容部分浏览器未正确设置 file.type 的情况。

3.4 拖拽排序

文件列表项设置 draggable="true",利用 HTML5 拖拽 API 实现顺序调整:

  • dragstart:记录当前项索引,设置拖拽效果为 move;
  • dragover:调用 e.preventDefault() 允许放置;
  • drop:读取 dataTransfer.getData('text/plain') 获取源索引,将项从原位置移除并插入到目标位置,重新渲染列表。

为避免子元素触发 dragleave 导致高亮闪烁,上传区使用拖拽计数器控制 dragover 类的添加与移除。

3.5 PDF 生成(核心逻辑)

使用 pdf-lib 创建 PDF 文档,按顺序遍历图片文件,为每张图片添加一页:

const pageSizeMode = $('page-size').value;   // 'auto' | 'a4' | 'letter'
const margin = parseInt($('page-margin').value, 10); // 0 / 20 / 40 / 60

const SIZES = {
  a4:   { w: 595.28, h: 841.89 },
  letter: { w: 612, h: 792 }
};

const pdfDoc = await PDFLib.PDFDocument.create();

for (let i = 0; i < files.length; i++) {
  const file = files[i];
  const arrayBuffer = await file.arrayBuffer();
  
  let image;
  if (file.type === 'image/png') {
    image = await pdfDoc.embedPng(arrayBuffer);
  } else if (file.type === 'image/jpeg' || file.type === 'image/jpg') {
    image = await pdfDoc.embedJpg(arrayBuffer);
  } else {
    // WebP / GIF / BMP 等:通过 Canvas 转为 JPEG 再嵌入
    const img = new Image();
    const url = URL.createObjectURL(file);
    img.src = url;
    await new Promise((resolve, reject) => {
      img.onload = resolve;
      img.onerror = () => reject(new Error('图片加载失败:' + file.name));
      setTimeout(() => reject(new Error('图片加载超时:' + file.name)), 15000);
    });
    const canvas = document.createElement('canvas');
    canvas.width = img.width;
    canvas.height = img.height;
    const ctx = canvas.getContext('2d');
    ctx.fillStyle = '#ffffff'; // 填充白底,防止透明底变黑
    ctx.fillRect(0, 0, canvas.width, canvas.height);
    ctx.drawImage(img, 0, 0);
    const jpgUrl = canvas.toDataURL('image/jpeg', 0.95);
    URL.revokeObjectURL(url);
    const jpgBuffer = await (await fetch(jpgUrl)).arrayBuffer();
    image = await pdfDoc.embedJpg(jpgBuffer);
  }

  const imgW = image.width;
  const imgH = image.height;

  // 确定页面尺寸
  let pageW, pageH;
  if (pageSizeMode === 'auto') {
    pageW = imgW + margin * 2;
    pageH = imgH + margin * 2;
  } else {
    pageW = SIZES[pageSizeMode].w;
    pageH = SIZES[pageSizeMode].h;
  }

  const page = pdfDoc.addPage([pageW, pageH]);

  // 按比例缩放并居中
  const availW = pageW - margin * 2;
  const availH = pageH - margin * 2;
  const ratio = Math.min(availW / imgW, availH / imgH);
  const drawW = imgW * ratio;
  const drawH = imgH * ratio;
  const x = margin + (availW - drawW) / 2;
  const y = margin + (availH - drawH) / 2;

  page.drawImage(image, { x, y, width: drawW, height: drawH });

  // 更新进度
  updateProgress(Math.round(((i + 1) / files.length) * 100), `正在处理第 ${i + 1} / ${files.length} 张图片...`);
}

const pdfBytes = await pdfDoc.save();
const blob = new Blob([pdfBytes], { type: 'application/pdf' });

关键点:

  • 格式嵌入:PNG 直接用 embedPng,JPEG 直接用 embedJpg;WebP/GIF/BMP 等 pdf-lib 不直接支持的格式,先通过 Canvas 绘制并填充白色背景(避免透明 PNG 在 PDF 中出现黑底),再 toDataURL('image/jpeg', 0.95) 转为 JPEG 嵌入;
  • 页面尺寸:auto 模式按图片原始尺寸 + 边距生成页面;A4(595.28×841.89 pt)和 Letter(612×792 pt)为固定标准尺寸;
  • 比例缩放居中:ratio = min(availW/imgW, availH/imgH),保持原图比例,居中放置,避免变形;
  • 超时与错误处理:图片加载设置 15 秒超时,onerror 捕捉损坏文件,try-catch 包裹整个生成流程,失败时弹出错误并恢复按钮状态;
  • 进度反馈:每处理一张图片更新一次进度条,用户可直观了解生成状态。

3.6 文件下载

生成的 PDF 转为 Blob 后下载:

if (typeof saveAs === 'undefined') {
  // 降级方案:a 标签原生下载
  const url = URL.createObjectURL(downloadBlob);
  const a = document.createElement('a');
  a.href = url;
  a.download = 'images_merged.pdf';
  document.body.appendChild(a);
  a.click();
  document.body.removeChild(a);
  setTimeout(() => URL.revokeObjectURL(url), 1000);
} else {
  saveAs(downloadBlob, 'images_merged.pdf');
}

优先使用 FileSaver.js 的 saveAs;若库未加载(如非 HTTPS 或网络异常),降级为创建隐藏 a 标签触发浏览器原生下载,并及时 revokeObjectURL 释放内存。

3.7 前端实现要点

  • 防抖与状态锁:生成过程中禁用“生成 PDF”按钮并关闭上传区交互,防止重复提交;
  • 结果面板:生成成功后显示合并张数与文件大小(MB),提供下载按钮;
  • 内存管理:URL.revokeObjectURL 及时释放图片与 PDF Blob 的对象 URL;
  • 深色模式:全站使用 CSS 变量定义配色,深色模式下卡片背景、边框、文字颜色自动适配;
  • 依赖兜底:生成前检测 typeof PDFLib === 'undefined',CDN 加载失败时提示用户检查网络并刷新。

所有输入、绘制与 PDF 生成均在浏览器本地完成,图片内容不上传任何服务器。


四、关键技术挑战与解决方案

挑战解决方案
pdf-lib 不支持 WebP/GIF/BMP通过 Canvas 绘制并填充白底,toDataURL('image/jpeg') 转为 JPEG 再嵌入 PDF
透明背景图片在 PDF 中可能显示为黑底Canvas 绘制前先 fillRect 白色背景,再绘制图像
超大图片导致 Canvas 内存溢出toDataURL 包裹 try-catch,失败时提示图片过大
图片加载挂起导致页面卡死img.onload/onerror 配合 15 秒 setTimeout 超时控制
拖拽排序时子元素导致高亮闪烁上传区拖拽计数器,仅在计数归零时移除 dragover 类
非 HTTPS 环境 saveAs 不可用FileSaver.js 优先,失败后降级为 a.download 原生下载
重复文件干扰顺序按 name_size_lastModified 构建唯一键去重
纯前端无后端依赖所有处理封装在前端,浏览器即可离线运行

五、使用示例

场景:将 5 张发票图片合并为一份 A4 PDF,供报销使用

  1. 打开 https://toolion.cn/image-to-pdf/;
  2. 点击上传区或拖拽 5 张 JPG/PNG 发票图片进去;
  3. 通过拖拽调整图片顺序,确保发票按日期排列;
  4. 页面尺寸选择“A4 尺寸”,页边距选择“中边距 (40pt)”;
  5. 点击“生成 PDF 文件”,等待进度条完成;
  6. 点击“下载 PDF 文件”,保存为 images_merged.pdf。

注意事项:

  • 图片尺寸差异较大时,建议选择“自动适应图片”页面尺寸,每张图按原始比例生成页面,避免强制缩放变形;
  • 需要打印的文档建议选择 A4 尺寸与中/大边距,方便装订;
  • 一次性合并几十张甚至上百张高清图片时,生成可能需要数秒,请耐心等待进度完成;
  • 涉及身份证、银行卡、发票等敏感图片,建议使用本地处理工具,避免上传到第三方服务器。

六、免责声明

本文仅提供技术实现分享,相关工具仅供学习与日常便利使用,不构成任何商业建议。生成的 PDF 质量受图片分辨率、页面尺寸与边距设置影响,重要文档建议生成后检查一遍。本工具在浏览器本地内存中处理图片,图片不会上传到服务器,页面关闭后即从内存释放。


七、总结

本文介绍了一种纯前端实现的图片批量转 PDF 方案。核心设计思路:

  1. 多图合并:支持一次性上传多张图片,按顺序合并为一个 PDF 文件;
  2. pdf-lib 生成:PNG/JPEG 直接嵌入,WebP/GIF/BMP 经 Canvas 转为 JPEG 再嵌入,保持图片质量;
  3. 页面布局:支持 A4/Letter/自动页面尺寸与多级边距,图片按比例缩放居中,避免变形;
  4. 拖拽排序:HTML5 拖拽 API 实现图片顺序自定义,合并前灵活调整;
  5. 隐私优先:全部处理在浏览器本地完成,图片不上传服务器,无需登录,无水印;
  6. 健壮性:依赖加载检测、图片加载超时、Canvas 内存兜底、try-catch 错误处理、Blob 内存释放。

该方案适合需要轻量级、纯前端图片转 PDF 的场景,可作为前端文档处理类工具页面的技术参考。


#图片转PDF #多图合并PDF #pdf-lib #FileSaver.js #纯前端 #JavaScript #Canvas #本地处理 #隐私安全 #办公工具 #PDF生成 #图片处理 #工具开发