欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

Vue預(yù)覽PDF的兩種方法比較(vue-pdf-embed與pdfjs-dist)

 更新時間:2025年08月17日 09:38:51   作者:VipSoft  
這篇文章主要為大家詳細(xì)介紹了Vue預(yù)覽PDF的兩種方法比較,即vue-pdf-embed與pdfjs-dist,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以了解下

簡介

Vue PDF預(yù)覽,vue-pdf-embedpdfjs-dist 的比較

  • 如果 PDF < 5MB → 用 vue-pdf-embed(簡單快捷)。
  • 如果 PDF > 5MB → 用 pdfjs-dist + 分頁懶加載(穩(wěn)定可控)。

PDFJS.getDocument TypeError: Cannot read from private field

pnpm install pdfjs-dist@2.14.305 --save

package.json,pdfjs-diist版本使用@2.11.338,高版本會報錯

"dependencies": {
    "pdfjs-dist": "^2.11.338",
    "vue": "^3.5.13",
    "vue-i18n": "^11.1.2",
    "vue-router": "^4.5.0"
  },
  "devDependencies": {
    "@types/node": "^22.13.10",
    "@types/pdfjs-dist": "^2.10.378",
    "@vitejs/plugin-vue": "^5.2.1",
    "typescript": "^5.8.2",
    "vite": "^6.2.1",
    "vue-tsc": "^2.2.8"
  }

vue-pdf-embed 與 pdfjs-dist 的比較與選擇

主要區(qū)別

特性vue-pdf-embedpdfjs-dist
性質(zhì)Vue專用封裝組件PDF.js的純JS庫
集成難度簡單,開箱即用需要自行實現(xiàn)渲染邏輯
功能完整性基礎(chǔ)功能完善功能最全面
自定義程度有限,通過props配置完全自定義
維護(hù)性社區(qū)維護(hù)Mozilla官方維護(hù)
體積較小(封裝后)較大(完整功能)
文檔支持社區(qū)文檔官方完善文檔

應(yīng)用場景

推薦使用vue-pdf-embed的情況:

  • 快速在Vue項目中集成PDF預(yù)覽功能
  • 不需要高度自定義的PDF渲染
  • 項目時間緊迫,需要快速實現(xiàn)
  • 只需要基礎(chǔ)查看功能(縮放、翻頁等)
  • 項目對包體積較敏感

推薦使用pdfjs-dist的情況:

  • 需要深度自定義PDF渲染(如自定義工具欄、注釋系統(tǒng))
  • 需要高級功能(文本選擇、搜索、表單填寫等)
  • 項目已在使用PDF.js相關(guān)生態(tài)
  • 需要處理特殊的PDF渲染需求
  • 需要直接訪問PDF.js底層API

具體推薦

對于大多數(shù)Vue項目 -推薦 vue-pdf-embed

優(yōu)勢

// 使用極其簡單
<template>
  <vue-pdf-embed 
    :source="pdfUrl" 
    :page="currentPage"
    @rendered="onRendered"
  />
</template>
  • 幾行代碼即可實現(xiàn)完整功能
  • 內(nèi)置分頁、縮放等常見功能
  • 專為Vue設(shè)計,響應(yīng)式集成好
  • 避免直接操作PDF.js的復(fù)雜性

需要高級功能時 -推薦 pdfjs-dist

典型復(fù)雜場景

// 自定義渲染示例
const renderPage = async (pageNum) => {
  const page = await pdf.getPage(pageNum);
  const viewport = page.getViewport({ scale: 1.5 });
  
  // 自定義canvas渲染
  const canvas = document.getElementById('canvas');
  const context = canvas.getContext('2d');
  canvas.height = viewport.height;
  canvas.width = viewport.width;
  
  // 添加自定義渲染邏輯
  const renderContext = {
    canvasContext: context,
    viewport: viewport,
    // 可以添加自定義注解層等
  };
  
  await page.render(renderContext).promise;
}

綜合建議

1.優(yōu)先嘗試 vue-pdf-embed - 能滿足80%的常規(guī)需求,開發(fā)效率高

2.遇到特殊需求再考慮 pdfjs-dist - 當(dāng)需要:

  • 深度定制UI/交互
  • 實現(xiàn)復(fù)雜注解功能
  • 處理加密/特殊格式PDF
  • 需要文本提取等底層操作

3.混合使用策略

// 可以用vue-pdf-embed作為基礎(chǔ),配合pdfjs-dist擴(kuò)展功能
import { getDocument } from 'pdfjs-dist';

// 在vue-pdf-embed之外獲取文檔元數(shù)據(jù)
const loadPdfMeta = async (url) => {
  const pdf = await getDocument(url).promise;
  return {
    numPages: pdf.numPages,
    metadata: await pdf.getMetadata()
  };
}

性能考量

  • 對于大型PDF文檔,pdfjs-dist可能更有優(yōu)勢,可以手動控制內(nèi)存和渲染優(yōu)化
  • 對于移動端,vue-pdf-embed的封裝優(yōu)化通常更好
  • 服務(wù)端渲染場景,兩者都需要特殊處理,但vue-pdf-embed集成更簡單

最終選擇應(yīng)基于項目具體需求,但現(xiàn)代Vue項目中,vue-pdf-embed在大多數(shù)情況下都是更優(yōu)選擇。

對于 20MB 的大 PDF 文件,推薦使用 pdfjs-dist 而不是 vue-pdf-embed,原因如下:

為什么pdfjs-dist更適合大文件

1.更精細(xì)的加載控制

  • 可以手動實現(xiàn) 分頁加載(懶渲染),避免一次性渲染所有頁面導(dǎo)致卡頓。
  • 支持 漸進(jìn)式渲染,先顯示已加載的部分,提升用戶體驗。

2.內(nèi)存管理更優(yōu)

可以手動釋放不再使用的頁面內(nèi)存,避免瀏覽器崩潰。

3.支持 Worker 多線程

PDF.js 默認(rèn)使用 Web Worker 解析 PDF,避免阻塞主線程。

4.可自定義緩存策略

大文件可以分段加載(range request),減少初始等待時間。

示例代碼(基于pdfjs-dist優(yōu)化大文件加載)

<template>
  <div>
    <el-button @click="loadPdf">加載PDF</el-button>
    <div v-loading="loading">
      <div v-for="page in visiblePages" :key="page">
        <canvas :id="`pdf-page-${page}`"></canvas>
      </div>
    </div>
    <el-pagination
      layout="prev, pager, next"
      :total="pageCount"
      @current-change="handlePageChange"
    />
  </div>
</template>

<script setup lang="ts">
import { ref, onMounted } from "vue";
import * as PDFJS from "pdfjs-dist";

// 設(shè)置 Worker 路徑(必須?。?
PDFJS.GlobalWorkerOptions.workerSrc =
  "https://cdn.jsdelivr.net/npm/pdfjs-dist@3.4.120/build/pdf.worker.min.js";

const pdfUrl = "https://example.com/large-file.pdf"; // 20MB PDF
const loading = ref(false);
const pdfDoc = ref<any>(null);
const pageCount = ref(0);
const visiblePages = ref<number[]>([]); // 當(dāng)前可見的頁(避免一次性渲染全部)

// 加載PDF文檔(但不會立即渲染所有頁)
const loadPdf = async () => {
  loading.value = true;
  try {
    const loadingTask = PDFJS.getDocument({
      url: pdfUrl,
      rangeChunkSize: 65536, // 分塊加載(優(yōu)化大文件)
    });
    pdfDoc.value = await loadingTask.promise;
    pageCount.value = pdfDoc.value.numPages;
    // 默認(rèn)只加載第一頁
    visiblePages.value = [1];
    await renderPage(1);
  } catch (error) {
    console.error("PDF加載失敗:", error);
  } finally {
    loading.value = false;
  }
};

// 渲染單頁
const renderPage = async (pageNumber: number) => {
  if (!pdfDoc.value) return;
  const page = await pdfDoc.value.getPage(pageNumber);
  const canvas = document.getElementById(`pdf-page-${pageNumber}`) as HTMLCanvasElement;
  const viewport = page.getViewport({ scale: 1.5 });
  canvas.width = viewport.width;
  canvas.height = viewport.height;
  await page.render({
    canvasContext: canvas.getContext("2d"),
    viewport,
  }).promise;
};

// 翻頁時動態(tài)加載
const handlePageChange = (newPage: number) => {
  if (!visiblePages.value.includes(newPage)) {
    visiblePages.value.push(newPage);
    renderPage(newPage);
  }
};

onMounted(() => {
  loadPdf();
});
</script>

優(yōu)化大文件加載的關(guān)鍵技術(shù)

1.rangeChunkSize

PDF.js 支持 HTTP Range Requests,可以分塊加載文件,而不是一次性下載20MB。

2.分頁懶渲染

只渲染用戶當(dāng)前查看的頁面,避免內(nèi)存爆炸。

3.Web Worker

解析PDF在后臺線程執(zhí)行,不阻塞UI。

4.卸載不可見頁面

可以在頁面離開視口時銷毀 canvas 釋放內(nèi)存(需監(jiān)聽滾動)。

為什么不推薦vue-pdf-embed

雖然 vue-pdf-embed 更簡單,但:

  • 默認(rèn)會嘗試渲染所有頁面,大文件容易卡死。
  • 自定義優(yōu)化空間有限,難以實現(xiàn)分頁懶加載。
  • 內(nèi)存控制較弱,20MB PDF 可能導(dǎo)致標(biāo)簽頁崩潰。

最終建議

  • 如果 PDF < 5MB → 用 vue-pdf-embed(簡單快捷)。
  • 如果 PDF > 5MB → 用 pdfjs-dist + 分頁懶加載(穩(wěn)定可控)。

對于你的 20MB PDF,pdfjs-dist 是更可靠的選擇!

到此這篇關(guān)于Vue預(yù)覽PDF的兩種方法比較(vue-pdf-embed與pdfjs-dist)的文章就介紹到這了,更多相關(guān)Vue預(yù)覽PDF內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!

相關(guān)文章

  • Vue中組件的數(shù)據(jù)共享分析講解

    Vue中組件的數(shù)據(jù)共享分析講解

    本文章向大家介紹vue組件中的數(shù)據(jù)共享,主要包括vue組件中的數(shù)據(jù)共享使用實例、應(yīng)用技巧、基本知識點總結(jié)和需要注意事項,具有一定的參考價值,需要的朋友可以參考一下
    2022-12-12
  • vue中computed順序、watch順序、響應(yīng)次數(shù)使用

    vue中computed順序、watch順序、響應(yīng)次數(shù)使用

    這篇文章主要介紹了vue中computed順序、watch順序、響應(yīng)次數(shù)使用方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
    2024-08-08
  • vue自定義組件實現(xiàn)雙向綁定

    vue自定義組件實現(xiàn)雙向綁定

    這篇文章主要為大家詳細(xì)介紹了vue自定義組件實現(xiàn)雙向綁定,文中示例代碼介紹的非常詳細(xì),具有一定的參考價值,感興趣的小伙伴們可以參考一下
    2021-01-01
  • webpack+vue+express(hot)熱啟動調(diào)試簡單配置方法

    webpack+vue+express(hot)熱啟動調(diào)試簡單配置方法

    今天小編就為大家分享一篇webpack+vue + express (hot) 熱啟動調(diào)試簡單配置方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧
    2018-09-09
  • 一篇文章告訴你如何編寫Vue插件

    一篇文章告訴你如何編寫Vue插件

    這篇文章主要為大家介紹了如何編寫Vue插件,具有一定的參考價值,感興趣的小伙伴們可以參考一下,希望能夠給你帶來幫助
    2021-11-11
  • 如何讓別人訪問本地運(yùn)行的vue項目

    如何讓別人訪問本地運(yùn)行的vue項目

    這篇文章主要介紹了如何讓別人訪問本地運(yùn)行的vue項目,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教
    2022-10-10
  • VUE中使用HTTP庫Axios方法詳解

    VUE中使用HTTP庫Axios方法詳解

    本文將詳細(xì)介紹在VUE中使用HTTP庫Axios的詳細(xì)方法,需要的朋友可以參考下
    2020-02-02
  • 前端部署踩坑實戰(zhàn)記錄(部署后404、頁面空白)

    前端部署踩坑實戰(zhàn)記錄(部署后404、頁面空白)

    Vue項目打包部署Nginx服務(wù)器后,刷新頁面后出現(xiàn)404的問題,下面這篇文章主要給大家介紹了關(guān)于前端部署踩坑的實戰(zhàn)記錄,文中包括部署后404、頁面空白等問題的解決辦法,需要的朋友可以參考下
    2024-09-09
  • vue使用watch 觀察路由變化,重新獲取內(nèi)容

    vue使用watch 觀察路由變化,重新獲取內(nèi)容

    本篇文章主要介紹了vue使用watch 觀察路由變化,重新獲取內(nèi)容 ,具有一定的參考價值,感興趣的小伙伴們可以參考一下。
    2017-03-03
  • 使用electron打包Vue前端項目的詳細(xì)流程

    使用electron打包Vue前端項目的詳細(xì)流程

    這篇文章主要介紹了使用electron打包Vue前端項目的詳細(xì)流程,文中通過圖文結(jié)合的方式給大家介紹的非常詳細(xì),對大家學(xué)習(xí)electron打包Vue有一定的幫助,需要的朋友可以參考下
    2024-04-04

最新評論