在網頁中直接預覽 PDF 而非強制下載,是常見需求。本文比較四種主流方案:jquery.media.js (舊)、PDF.js (Mozilla 純 JS)、原生 `
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| PDF.js (推薦) | 純前端、無外掛、跨瀏覽器、支援文字選取/搜尋/縮放/列印、可離線、開源 MIT | 大型 PDF 首屏渲染較慢、需載入 worker、行動裝置記憶體壓力 | 現代 Web、SPA、需統一 UI/功能 |
| iframe/object/embed | 零程式碼、瀏覽器原生、效能最好 (交給 PDF 外掛/內建檢視器) | UI 不可控、行動裝置常回退下載、無法統一工具列、安全性沙箱限制 | 簡單內嵌、內部系統、相容舊瀏覽器 |
| jquery.media.js | 語法簡單、自動偵測媒體類型 | 已停止維護 (2013)、依賴 jQuery、實際仍靠瀏覽器外掛、不支援 PDF.js 功能 | 舊專案維護、快速原型 |
| 商業檢視器 | 功能最完整 (簽章、表單、註解、DRM)、技術支援 | 授權費用高、體積大、廠商鎖定 | 企業級文件管理、法律/金融合規 |
npm install pdfjs-dist
# 或下載預建檔:https://mozilla.github.io/pdf.js/getting_started/
<template>
<div class="pdf-viewer" ref="container">
<canvas ref="canvas" class="pdf-canvas" />
<div v-if="loading" class="loading">載入中...</div>
<div v-if="error" class="error">{{ error }}</div>
</div>
</template>
<script setup>
import { ref, onMounted, onUnmounted, watch } from 'vue';
import * as pdfjsLib from 'pdfjs-dist';
import 'pdfjs-dist/build/pdf.worker.entry'; // Webpack 5+ 自動處理 worker
// 指定 worker 路徑 (生產環境建議放在 CDN)
pdfjsLib.GlobalWorkerOptions.workerSrc = '/pdf.worker.min.js';
const props = defineProps({ src: { type: String, required: true }, page: { type: Number, default: 1 } });
const emit = defineEmits(['page-change', 'num-pages', 'error']);
const container = ref(null);
const canvas = ref(null);
const pdfDoc = ref(null);
const loading = ref(true);
const error = ref(null);
const renderPage = async (num) => {
if (!pdfDoc.value || num < 1 || num > pdfDoc.value.numPages) return;
loading.value = true;
error.value = null;
try {
const page = await pdfDoc.value.getPage(num);
const viewport = page.getViewport({ scale: 1.5 }); // 可依容器寬度動態計算 scale
const ctx = canvas.value.getContext('2d');
canvas.value.width = viewport.width;
canvas.value.height = viewport.height;
await page.render({ canvasContext: ctx, viewport }).promise;
emit('page-change', num);
} catch (e) {
error.value = e.message;
emit('error', e);
} finally {
loading.value = false;
}
};
onMounted(async () => {
try {
const loadingTask = pdfjsLib.getDocument({ url: props.src });
loadingTask.onProgress = (d) => console.log(`載入進度: ${(d.loaded / d.total * 100).toFixed(1)}%`);
pdfDoc.value = await loadingTask.promise;
emit('num-pages', pdfDoc.value.numPages);
await renderPage(props.page);
} catch (e) {
error.value = e.message;
emit('error', e);
}
});
watch(() => props.page, (n) => renderPage(n));
onUnmounted(() => {
pdfDoc.value?.destroy();
});
</script>
<style scoped>
.pdf-viewer { position: relative; width: 100%; background: #eee; }
.pdf-canvas { display: block; margin: 0 auto; box-shadow: 0 2px 8px rgba(0,0,0,.1); }
.loading, .error { position: absolute; inset: 0; display: flex; align-items: center; justify-content: center; }
.error { color: #c00; background: #fee; }
</style>
<div id="viewer"><canvas id="pdf-canvas"></canvas></div>
<script src="https://cdnjs.cloudflare.com/ajax/libs/pdf.js/3.11.174/pdf.min.js"></script>
<script>
pdfjsLib.GlobalWorkerOptions.workerSrc = 'https://cdnjs.cloudflare.com/ajax/libs/pdf.js/3.11.174/pdf.worker.min.js';
async function loadPdf(url, page = 1) {
const pdf = await pdfjsLib.getDocument(url).promise;
const pageObj = await pdf.getPage(page);
const viewport = pageObj.getViewport({ scale: 1.5 });
const canvas = document.getElementById('pdf-canvas');
const ctx = canvas.getContext('2d');
canvas.width = viewport.width;
canvas.height = viewport.height;
await pageObj.render({ canvasContext: ctx, viewport }).promise;
}
loadPdf('/files/manual.pdf');
</script>
<!-- iframe:最相容、可滾動、可列印 -->
<iframe src="/files/report.pdf#toolbar=1&navpanes=0" width="100%" height="800px" style="border:none;"></iframe>
<!-- object:HTML4 標準、可指定 fallback -->
<object data="/files/report.pdf#view=FitH" type="application/pdf" width="100%" height="800px">
<p>您的瀏覽器不支援內嵌 PDF,請
URL 參數 (僅 Adobe Reader/Chrome 內建檢視器支援):`#page=2`、`#zoom=100`、`#toolbar=0`、`#view=FitH`。
<script src="/scripts/jquery-1.7.2.min.js"></script>
<script src="/scripts/jquery.media.js"></script>
<script>
$(function () {
$('a.media').media({ width: 800, height: 600 }); // 自動將連結轉為 object/embed
});
</script>
<a class="media" href="/files/report.pdf">開啟 PDF</a>
缺點:實際仍依賴瀏覽器外掛,行動裝置多無法顯示,已不建議新專案採用。