萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

網頁嵌入 PDF 的現代方案:PDF.js、PDFObject 與原生 iframe 對比

三大主流方案對比

方案原理優點缺點適用場景
原生 <iframe/embed/object>瀏覽器內建 PDF 外掛零依賴、最簡單、效能最好UI 不可控、行動裝置支援差、無法統一風格簡單預覽、下載導向
PDFObject.jsJS 動態產生 iframe/embedAPI 簡單、支援 fallback、可指定容器仍依賴瀏覽器 PDF 檢視器、功能有限快速整合、需指定容器
PDF.js (Mozilla)純 JS 渲染 PDF (Canvas)完全可控 UI、跨平台一致、無外掛依賴、支援文字選取/搜尋體積大(~1MB)、渲染複雜頁較慢、記憶體佔用高完整閱讀器、註解、簽署、行動優先

方案一:原生嵌入 (最輕量)


<!-- iframe:最相容 -->
<iframe src="doc.pdf" width="100%" height="600" style="border:none"></iframe>

<!-- embed:HTML5 標準 -->
<embed src="doc.pdf" type="application/pdf" width="100%" height="600">

<!-- object:支援 fallback -->
<object data="doc.pdf" type="application/pdf" width="100%" height="600">
    <p>您的瀏覽器不支援內嵌 PDF,<a href="doc.pdf">點此下載</a></p>
</object>

方案二:PDFObject.js (v2.x)


<!-- 引入 -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/pdfobject/2.2.7/pdfobject.min.js"></script>

<div id="pdf-viewer" style="width:100%;height:600px"></div>

<script>
PDFObject.embed("doc.pdf", "#pdf-viewer", {
    // 可選參數
    page: 1,              // 開啟頁碼
    zoom: "page-width",   // 縮放: page-fit, page-width, 1.5
    pdfOpenParams: {
        navpanes: 0,      // 隱藏導覽列
        toolbar: 0,       // 隱藏工具列
        statusbar: 0,     // 隱藏狀態列
        view: "FitH"      // 適應寬度
    },
    onError: function(err) {
        console.error('PDF 載入失敗:', err);
        document.getElementById('pdf-viewer').innerHTML = 
            '

無法載入 PDF,下載檔案

'; } }); // 成功回傳 { success: true, node: } </script>

方案三:PDF.js 完整實作 (含工具列、搜尋、縮放)


<!-- PDF.js CDN (含 worker) -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/pdf.js/3.11.174/pdf.min.js"></script>
<script>
    // 指定 worker 來源 (必要,避免主執行緒阻塞)
    pdfjsLib.GlobalWorkerOptions.workerSrc = 
        'https://cdnjs.cloudflare.com/ajax/libs/pdf.js/3.11.174/pdf.worker.min.js';
</script>

<div id="pdf-viewer">
    <div class="toolbar">
        <button id="prev">上一頁</button>
        <span id="page-info">第 1 / 10 頁</span>
        <button id="next">下一頁</button>
        <select id="zoom">
            <option value="auto">自動</option>
            <option value="0.5">50%</option>
            <option value="1" selected>100%</option>
            <option value="1.5">150%</option>
        &select>
        <input type="search" id="search" placeholder="搜尋...">
    </div>
    <canvas id="pdf-canvas"></canvas>
</div>

<script>
class PDFViewer {
    constructor(containerId, url) {
        this.container = document.getElementById(containerId);
        this.canvas = this.container.querySelector('#pdf-canvas');
        this.ctx = this.canvas.getContext('2d');
        this.url = url;
        this.pdfDoc = null;
        this.pageNum = 1;
        this.scale = 1.5;
        this.rendering = false;
        
        this.bindEvents();
        this.load();
    }
    
    async load() {
        try {
            this.pdfDoc = await pdfjsLib.getDocument(this.url).promise;
            this.updatePageInfo();
            this.renderPage();
        } catch (err) {
            this.showError('PDF 載入失敗: ' + err.message);
        }
    }
    
    async renderPage() {
        if (this.rendering) return;
        this.rendering = true;
        
        try {
            const page = await this.pdfDoc.getPage(this.pageNum);
            const viewport = page.getViewport({ scale: this.scale });
            
            this.canvas.width = viewport.width;
            this.canvas.height = viewport.height;
            
            const renderContext = {
                canvasContext: this.ctx,
                viewport: viewport
            };
            
            await page.render(renderContext).promise;
            this.updatePageInfo();
        } catch (err) {
            this.showError('渲染失敗: ' + err.message);
        } finally {
            this.rendering = false;
        }
    }
    
    updatePageInfo() {
        this.container.querySelector('#page-info').textContent = 
            `第 ${this.pageNum} / ${this.pdfDoc?.numPages || 0} 頁`;
    }
    
    bindEvents() {
        this.container.querySelector('#prev').onclick = () => {
            if (this.pageNum > 1) { this.pageNum--; this.renderPage(); }
        };
        this.container.querySelector('#next').onclick = () => {
            if (this.pdfDoc && this.pageNum < this.pdfDoc.numPages) { 
                this.pageNum++; this.renderPage(); 
            }
        };
        this.container.querySelector('#zoom').onchange = (e) => {
            this.scale = e.target.value === 'auto' ? 
                Math.min(this.container.clientWidth / 800, 2) : 
                parseFloat(e.target.value);
            this.renderPage();
        };
        // 搜尋功能需額外實作 TextLayer
    }
    
    showError(msg) {
        this.container.innerHTML = `

${msg}

`; } } // 初始化 new PDFViewer('pdf-viewer', 'doc.pdf'); </script>

進階主題

文字選取與搜尋 (TextLayer)


// PDF.js 需額外建立文字圖層疊在 Canvas 上
const textLayerDiv = document.createElement('div');
textLayerDiv.className = 'textLayer';
container.appendChild(textLayerDiv);

const textLayer = await page.getTextContent();
await pdfjsLib.renderTextLayer({
    textContent: textLayer,
    container: textLayerDiv,
    viewport: viewport,
    textDivs: []
});

行動裝置優化

  • 使用 willReadFrequently Canvas 內容
  • 分頁渲染、虛擬化 (只渲染可視頁)
  • 觸控手勢:雙指縮放、拖曳平移 (Hammer.js / Pointer Events)
  • 記憶體管理:page.cleanup() 釋放非當前頁資源

安全性考量

  • CORS:PDF 檔案需設定 Access-Control-Allow-Origin
  • 敏感文件:加密傳輸、下載權限控制、水印
  • XSS:PDF.js 解析器歷史有漏洞,務必保持更新

選型決策樹

需要完整閱讀器功能(搜尋、縮放、書籤)?
├─ 是 → PDF.js (或商業: PDFTron, PSPDFKit)
└─ 否
    ├─ 只需簡單預覽、下載 → 原生 iframe/embed
    └─ 需指定容器、基本參數控制 → PDFObject.js
copyright © 萬盛學電腦網 all rights reserved