1.1.0

架構

最後更新


本頁以一張圖概覽 pdf2image 的組成:載入時的相依注入、對外類別 pdf2image、內部的進度遮罩,以及它們依賴的 CDN 函式庫。

系統概覽


graph TB
    subgraph 載入時
        Boot[啟動 IIFE] --> Inject[注入 preconnect / preload / script / stylesheet]
    end
    subgraph CDN
        PDFJS[pdf.js 3.4.120 + worker + CMap]
        JSZip[JSZip 3.7.1]
        CSS[pdf2image.css @latest]
    end
    Inject --> PDFJS
    Inject --> JSZip
    Inject --> CSS
    App[呼叫端] --> Class[pdf2image]
    Class -->|convert| PDFJS
    PDFJS --> Canvas[canvas.toDataURL]
    Canvas --> Images[images 陣列]
    Class -->|download| JSZip
    Images --> JSZip
    JSZip --> Anchor[a download 點擊]
    Class --> Loading[pdf2imageLoading 遮罩]
    CSS --> Loading
  1. graph TB
  2. subgraph 載入時
  3. Boot[啟動 IIFE] --> Inject[注入 preconnect / preload / script / stylesheet]
  4. end
  5. subgraph CDN
  6. PDFJS[pdf.js 3.4.120 + worker + CMap]
  7. JSZip[JSZip 3.7.1]
  8. CSS[pdf2image.css @latest]
  9. end
  10. Inject --> PDFJS
  11. Inject --> JSZip
  12. Inject --> CSS
  13. App[呼叫端] --> Class[pdf2image]
  14. Class -->|convert| PDFJS
  15. PDFJS --> Canvas[canvas.toDataURL]
  16. Canvas --> Images[images 陣列]
  17. Class -->|download| JSZip
  18. Images --> JSZip
  19. JSZip --> Anchor[a download 點擊]
  20. Class --> Loading[pdf2imageLoading 遮罩]
  21. CSS --> Loading

分層


層組成職責
載入啟動 IIFE把 pdf.js、JSZip、樣式表掛進 <head>
對外 APIpdf2image 類別正規化參數、convert()、download()、images
內部 UIpdf2imageLoading建立與更新進度遮罩,依語系切換文字
外部相依pdf.js、JSZip、瀏覽器 API解析渲染 PDF、打包 ZIP、觸發下載

跨切原則


  • 不打包相依:所有第三方程式碼都在執行時從 CDN 取得,套件本體只有一個小檔案
  • 純前端:PDF 不離開瀏覽器,沒有任何伺服器端元件
  • 單一入口:對外只有 pdf2image 一個類別,pdf2imageLoading 不對外暴露
  • 在瀏覽器渲染、輸出 Data URL:pdf2pic 需要 Node.js 加上 GraphicsMagick 與 Ghostscript,pdf-to-img 在 Node.js 中轉換 PDF,兩者適合伺服器與建置腳本。pdf-img-convert 與 pdf2image 同樣以 pdf.js 為基礎,但以 npm 模組回傳 PNG 的 Uint8Array 緩衝區。pdf2image 在訪客的頁面中執行,回傳可直接放進 <img src> 的 Data URL,並內建進度遮罩與 ZIP 下載

延伸閱讀


EN