這篇只講功能層 JavaScript 實(shí)現(xiàn)。這個(gè)工具是我用 Vue 組織頁面交互，再配合 pdf-lib 在瀏覽器端完成 PDF 生成。pdf-lib 是公開可用的通用開源庫（MIT 許可），可直接用于瀏覽器和 Node.js。核心流程是：

上傳圖片 -> 讀取并建模 -> 調(diào)整順序/旋轉(zhuǎn) -> 計(jì)算頁面與布局 -> 寫入 PDF -> 下載

在線工具網(wǎng)址：https://see-tool.com/image-to-pdf
工具截圖：\

0）先說下 pdf-lib 在這個(gè)工具里的角色

pdf-lib 在這里主要負(fù)責(zé)三件事：創(chuàng)建 PDF 文檔、把圖片字節(jié)嵌入文檔、按給定坐標(biāo)繪制到頁面。

它的調(diào)用模型很直接：

create/load -> addPage/embed -> drawImage -> save

對圖片轉(zhuǎn) PDF 這類場景，它有幾個(gè)很實(shí)用的點(diǎn)：

• API 穩(wěn)定，瀏覽器端可直接運(yùn)行，不依賴后端轉(zhuǎn)換
• 頁面坐標(biāo)和尺寸控制細(xì)，適合做“邊距、縮放、居中、鋪滿”這類排版
• 同一套邏輯可擴(kuò)展到“合并現(xiàn)有 PDF、寫文本、填表單”等后續(xù)功能

這個(gè)工具里最核心的一步是 embedJpg + drawImage：前者把二進(jìn)制圖片數(shù)據(jù)放進(jìn) PDF，后者決定圖片在頁面中的位置和顯示尺寸。只要前面把頁面尺寸和布局參數(shù)算對，最終導(dǎo)出的版式就會穩(wěn)定可控。

1）狀態(tài)模型：圍繞“圖片隊(duì)列 + 轉(zhuǎn)換配置”組織

工具初始化后維護(hù)一個(gè)狀態(tài)對象，核心字段如下：

• images：當(dāng)前待轉(zhuǎn)換圖片隊(duì)列
• settings：頁面尺寸、方向、布局、邊距、文件名
• isConverting：是否正在生成，防止重復(fù)點(diǎn)擊

每張圖片對象都會保存：name、size、format、preview(dataURL)、width、height、rotation。這樣后續(xù)排序、旋轉(zhuǎn)、預(yù)覽和生成 PDF 都可以直接復(fù)用同一份數(shù)據(jù)。

2）文件接入：先過濾，再讀取 DataURL 和尺寸

上傳與拖拽最后都進(jìn)入同一入口，先只保留圖片類型，再做數(shù)量上限控制。每個(gè)文件會經(jīng)過兩步：

1. FileReader.readAsDataURL 讀成 DataURL
2. 用 Image 對象加載，拿到 naturalWidth/naturalHeight

核心讀取函數(shù)：

function readFileAsDataUrl(file) {
  return new Promise(function (resolve, reject) {
    var reader = new FileReader();
    reader.onload = function (event) {
      resolve(
        String(event.target && event.target.result ? event.target.result : ""),
      );
    };
    reader.onerror = function () {
      reject(new Error("file_read_failed"));
    };
    reader.readAsDataURL(file);
  });
}

讀取成功后把圖片對象追加進(jìn)隊(duì)列，頁面統(tǒng)計(jì)和預(yù)覽區(qū)會立即重渲染。

3）頁面尺寸計(jì)算：統(tǒng)一轉(zhuǎn)換到 PDF 點(diǎn)單位

PDF 里統(tǒng)一使用 point（pt），因此先做單位換算：

• MM_TO_PT = 72 / 25.4
• PX_TO_PT = 72 / 96

固定紙張（A4/A3/Letter/Legal）先由毫米轉(zhuǎn) pt；如果用戶選“原始尺寸”，則按圖片像素轉(zhuǎn) pt。方向?yàn)?auto 時(shí)，會根據(jù)圖片寬高自動判定橫版或豎版。

function getPageSizePt(pageSize, orientation, imageWidth, imageHeight) {
  var widthPt;
  var heightPt;

  if (pageSize === "original") {
    widthPt = imageWidth * PX_TO_PT;
    heightPt = imageHeight * PX_TO_PT;
  } else {
    var pageSizeValue = PAGE_SIZES_MM[pageSize] || PAGE_SIZES_MM.a4;
    widthPt = pageSizeValue.width * MM_TO_PT;
    heightPt = pageSizeValue.height * MM_TO_PT;
  }

  // 省略方向交換邏輯
  return {
    widthPt: widthPt,
    heightPt: heightPt,
    orientation: finalOrientation,
  };
}

4）布局算法：contain / cover / center

每頁先算內(nèi)容區(qū)：

contentWidth = pageWidth - margin * 2

contentHeight = pageHeight - margin * 2

然后按布局模式計(jì)算繪制矩形：

• contain：完整顯示圖片，按最小縮放比適配
• cover：鋪滿內(nèi)容區(qū)，按最大縮放比適配
• center：不縮放，居中繪制

當(dāng)邊距過大導(dǎo)致內(nèi)容區(qū)寬高小于等于 0 時(shí)，直接拋錯(cuò)，轉(zhuǎn)換流程會給出明確提示。

5）旋轉(zhuǎn)處理：先畫到 Canvas，再統(tǒng)一轉(zhuǎn) JPEG

為了讓 pdf-lib 寫入穩(wěn)定，工具會先把當(dāng)前圖片（含旋轉(zhuǎn)角度）繪制到 canvas，再導(dǎo)出 JPEG 字節(jié)。角度支持 0/90/180/270。

function drawImageToJpeg(image, rotation) {
  var angle = Number(rotation || 0);
  var swapSide = angle === 90 || angle === 270;
  var canvas = document.createElement("canvas");

  canvas.width = swapSide ? image.naturalHeight : image.naturalWidth;
  canvas.height = swapSide ? image.naturalWidth : image.naturalHeight;

  var context = canvas.getContext("2d", { alpha: false });
  context.fillStyle = "#ffffff";
  context.fillRect(0, 0, canvas.width, canvas.height);
  context.translate(canvas.width / 2, canvas.height / 2);
  context.rotate((angle * Math.PI) / 180);
  context.drawImage(image, -image.naturalWidth / 2, -image.naturalHeight / 2);

  return parseDataUrl(canvas.toDataURL("image/jpeg", 0.92));
}

這里先鋪白底，可以避免透明圖在 PDF 中出現(xiàn)黑底。

6）PDF 生成：逐頁 addPage + embedJpg + drawImage

轉(zhuǎn)換時(shí)按圖片隊(duì)列順序循環(huán)處理，每張圖先算頁面尺寸和布局，再寫入 PDF：

async function buildPdfBlobWithPdfLib(pages, PDFDocument) {
  var pdfDocument = await PDFDocument.create();

  for (var i = 0; i < pages.length; i += 1) {
    var item = pages[i];
    var page = pdfDocument.addPage([item.pageWidthPt, item.pageHeightPt]);
    var jpg = await pdfDocument.embedJpg(item.imageBytes);
    page.drawImage(jpg, {
      x: item.xPt,
      y: item.yPt,
      width: item.drawWidthPt,
      height: item.drawHeightPt,
    });
  }

  var pdfBytes = await pdfDocument.save();
  return new Blob([pdfBytes], { type: "application/pdf" });
}

最終通過對象 URL 觸發(fā)瀏覽器下載，文件名會先做非法字符清洗。

7）交互動作如何影響最終 PDF

工具里“上移/下移/拖拽排序/旋轉(zhuǎn)/刪除”都直接改 images 隊(duì)列，因此最終 PDF 頁序與圖片列表始終一致。

• 排序：交換數(shù)組元素或拖拽后 splice
• 旋轉(zhuǎn)：rotation = (rotation + 90) % 360
• 刪除：按 id 過濾

由于生成時(shí)是按隊(duì)列順序遍歷，交互結(jié)果會無縫反映到導(dǎo)出文件。

8）轉(zhuǎn)換過程控制：狀態(tài)鎖 + 分階段提示

點(diǎn)擊“轉(zhuǎn)換”后會先進(jìn)入 isConverting = true：

• 禁用上傳、配置項(xiàng)和操作按鈕
• 顯示“正在生成第 X / N 頁”
• 完成后恢復(fù)可操作狀態(tài)

錯(cuò)誤按場景給出明確反饋，比如無圖片、文件名為空、邊距過大、生成失敗。整條鏈路是純前端閉環(huán)：從讀取、排版到導(dǎo)出，都在瀏覽器端完成。

以上就是JavaScript基于pdf-lib實(shí)現(xiàn)圖片轉(zhuǎn)PDF工具的詳細(xì)內(nèi)容，更多關(guān)于JavaScript pdf-lib圖片轉(zhuǎn)PDF的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論