| 方案 | 原理 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|---|
| 原生 <iframe/embed/object> | 瀏覽器內建 PDF 外掛 | 零依賴、最簡單、效能最好 | UI 不可控、行動裝置支援差、無法統一風格 | 簡單預覽、下載導向 |
| PDFObject.js | JS 動態產生 iframe/embed | API 簡單、支援 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>
<!-- 引入 -->
<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:
<!-- 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>
// 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 內容page.cleanup() 釋放非當前頁資源Access-Control-Allow-Origin
需要完整閱讀器功能(搜尋、縮放、書籤)?
├─ 是 → PDF.js (或商業: PDFTron, PSPDFKit)
└─ 否
├─ 只需簡單預覽、下載 → 原生 iframe/embed
└─ 需指定容器、基本參數控制 → PDFObject.js