大家好，我是小弋。

分享的內容是2021年頂級React PDF 庫。

2021 年頂級 React PDF 庫

[[406442]]

今天，許多網絡應用程序為其用戶提供內置的PDF瀏覽選項。然而，選擇一個并不容易，因為它們的功能遠遠超過顯示PDF。

因此，在這篇文章中，我將評估5個React的PDF瀏覽器庫，并進行功能比較，以幫助你選擇最適合你要求的。

主要介紹下面5個庫：

• react-pdf/renderer
• react-pdf
• @phuocng/react-pdf-viewer
• react-file-viewer
• @mikecousins/react-pdf

react-pdf/renderer

react-pdf/renderer

專門用于渲染和創(chuàng)建PDF。

React-pdf/renderer是一個廣泛使用的庫，用于在瀏覽器和服務器上創(chuàng)建PDF文件。

地址：https://www.npmjs.com/package/@react-pdf/renderer

這個庫提供了一些基本的組件來開始工作，隨著你的熟悉，你可以定制它們來提出更吸引人的設計:

• Document: 這是match一個PDF文件的根。
• Page: 單頁是由這個標簽描述的。它需要有一定的尺寸(如A4)。
• View: 一個通用的容器，用于樣式和格式化PDF。你可以使用StyleSheet.create() API，用Flexbox和CSS屬性的全部功能來設計你的視圖，以布局PDF，類似于它在React Native中的使用方式。
• Text: 用于顯示文本。
• Image: 可用于在PDF文檔中插入圖片。
• Link: 可用于生成超鏈接注釋。

另外，React-pdf/renderer帶有一些驚人的功能，可以用來生成令人驚嘆的文檔。我可以很容易地列出其中的一些功能:

• 支持各種樣式和CSS屬性。
• 通過usePDF hook API對文檔進行更多控制。
• 提供一個Node API。
• 快速和高效。
• 高度可定制&易于使用。

除了這些，React-pdf/renderer庫每周有大約93,000次下載，GitHub上有超過9.3k顆星星。

你可以使用npm install - save @react-pdf/renderer命令輕松地將這個庫安裝到你的項目中，下面的代碼顯示了一個使用React-pdf/renderer的簡單例子。

import React from 'react'; 
import { Document, Page, Text, View, StyleSheet } from '@react-pdf/renderer'; 
 
// Create styles 
const styles = StyleSheet.create({ 
  page: { 
    flexDirection: 'row', 
    backgroundColor: '#C0C0C0' 
  }, 
  section: { 
    margin: 10, 
    padding: 10, 
    flexGrow: 1 
  } 
}); 
 
// Create Pdf Component 
const MyPdf = () => ( 
  <Document> 
    <Page size="A4" style={styles.page}> 
      <View style={styles.section}> 
        <Text>Heading #1</Text> 
      </View> 
      <View style={styles.section}> 
        <Text>Heading #2</Text> 
      </View> 
    </Page> 
  </Document> 
); 

react-pdf

像顯示圖片一樣顯示PDF。

我們之前討論過的React-pdf/renderer是專門用于創(chuàng)建PDF的。但如果你正在尋找一個只顯示PDF的庫，React-pdf是最佳選擇。

地址：https://www.npmjs.com/package/react-pdf

React-pdf提供了一個React組件API，允許打開PDF文件并使用PDF.js渲染。雖然這是一個專門用于查看PDF的簡單庫，但它有一些驚人的功能，比如:

• 易于使用 - 插入Document組件并給它一個文件道具。React-pdf會把它整理出來，不管它是一個URL，一個文件，還是base64。
• 支持自定義事件。
• 多種渲染方法。
• 支持文本選擇和注釋。
• 跨瀏覽器兼容性。
• 可訪問性 - React-pdf不僅將PDF渲染成圖像。還可以作為屏幕閱讀器可以掌握的可見文本層，使你的內容對視力障礙者來說更可用。
• 免費和開源。

除此以外，每周有超過296,000次的下載和4.6K顆GitHub星，這表明這個庫在React社區(qū)是多么受歡迎。

你可以使用npm i react-pdf命令來安裝它，下面的例子顯示了React-pdf的基本用法。

import React, { useState } from 'react'; 
import { Document, Page } from 'react-pdf'; 
 
function MyPdf() { 
  const [numPages, setNumPages] = useState(null); 
  const [pageNumber, setPageNumber] = useState(1); 
 
  function onDocumentLoadSuccess({ numPages }) { 
    setNumPages(numPages); 
  } 
 
  return ( 
    <div> 
      <Document 
        file="myfile.pdf" 
        onLoadSuccess={onDocumentLoadSuccess} 
      > 
        <Page pageNumber={pageNumber} /> 
      </Document> 
      <p>Page {pageNumber} of {numPages}</p> 
    </div> 
  ); 
} 
export default MyPdf; 

@phuocng/react-pdf-viewer

@phuocng/react-pdf-viewer

React-pdf-viewer是一個完全由React鉤子驅動的React組件，用TypeScript編寫。

盡管是新的，React-pdf-viewer有一些令人興奮的功能，讓你為之傾倒。為了更好地理解，我將把它們列舉如下：

• 支持受密碼保護的文件。
• 縮放：支持自定義級別，如實際尺寸、頁面合適和頁面寬度。
• 頁面之間的導航。
• 搜索文本。
• 預覽頁面縮略圖。
• 查看和瀏覽目錄。
• 列出和下載附件。
• 旋轉和許多滾動模式。文本選擇和手動工具模式。
• 全屏模式。
• 可以打開本地文件(例如，拖放一個本地文件來查看它。
• 下載文件和打印。
• 查看文件屬性。
• 支持SSR。

另外，它的插件集合是完全可定制的，并以優(yōu)秀的文檔幫助用戶。

文檔：https://react-pdf-viewer.dev/docs/

從它首次發(fā)布到現在只有一年時間，它已經有超過2000次的每周下載和519顆GitHub星。

注意：你需要有React 16.8以上版本和TypeScript 3.8以上版本才能使用React-pdf-viewer。

你可以使用npm i @phuocng/react-pdf-viewer命令來安裝它，下面的例子展示了React-pdf-viewer的基本用法。

// Core viewer 
import { Viewer } from '@react-pdf-viewer/core'; 
 
// Plugins 
import { defaultLayoutPlugin } from '@react-pdf-viewer/default-layout'; 
 
// Import styles 
import '@react-pdf-viewer/core/lib/styles/index.css'; 
import '@react-pdf-viewer/default-layout/lib/styles/index.css'; 
 
// Create new plugin instance 
const defaultLayoutPluginInstance = defaultLayoutPlugin(); 
 
<Viewer 
    fileUrl='/my Documents/sample_doc.pdf' 
    plugins={[ 
        // Register plugins 
        defaultLayoutPluginInstance, 
        ... 
    ]} 
/> 

react-file-viewer

React-file-viewer是一個可擴展的文件查看器，用于Web應用程序，支持PDF、圖片、csv、xslx和docx。

這個庫提供了一個名為FileViewer的組件，用來顯示內容，它接受幾個props:

• fileType String: 要顯示的資源類型。如果你使用一個不支持的文件類型，將出現一個不支持的文件類型通知。
• filePath String: FileViewer將顯示的資源的URL。
• onError Function [optional]:如果文件查看器無法獲取或呈現所請求的資源，該函數將被調用。在這里你可以指定一個日志工具的回調。
• errorComponent react element [optional]: 一個在發(fā)生錯誤時渲染的組件，而不是 react-file-viewer 默認的錯誤組件。
• unsupported Component react element [Optional]:在文件格式不被支持的情況下要呈現的組件。

除此以外，它還有一些特殊的功能，比如:

• 用Jest或Enzyme進行測試。
• 通過使用make lint運行l(wèi)inter，在我們運行代碼之前發(fā)現錯誤，從而節(jié)省時間。
• 可擴展性--添加支持的文件類型很容易。

此外，這也是最受歡迎的pdf查看器庫之一，每周有17348次下載和291個GitHub Stars。

注意：這個庫在React 16以上版本中功能良好。如果你使用React< 16版本，你很可能需要安裝React-file-viewer 0.5版本。

React-file-viewer可以用npm i react-file-viewer命令安裝，下面的例子顯示了React-file-viewer的一個簡單例子:

// MyApp.js 
import React, { Component } from 'react'; 
import logger from 'logging-library'; 
import FileViewer from 'react-file-viewer'; 
import { CustomErrorComponent } from 'custom-error'; 
 
const file = 'http://mysite.com/sampledoc.pdf' 
const type = 'pdf' 
 
class MyDocComponent extends Component { 
  render() { 
    return ( 
      <FileViewer 
        fileType={type} 
        filePath={file} 
        errorComponent={CustomErrorComponent} 
        onError={this.onError}/> 
    ); 
  } 
 
  onError(e) { 
    logger.logError(e, 'error in file-viewer'); 
  } 
} 

@mikecousins/react-pdf

@mikecousins/react-pdf是一個使用PDF.js來渲染PDF文檔的組件。

這個庫使用一個叫做usePdf的Hook來渲染PDF，我們需要用這個Hook傳遞幾個props:

• file:PDF文件的URL。
• Page: 表示你要顯示的頁面。默認=1。
• scal：允許你對PDF進行縮放。默認=1。
• onDocumentLoadSuccess：你可以定義一個回調函數，在PDF文檔數據被完全加載后被調用。
• onDocumentLoadFail：讓你定義一個回調函數，當發(fā)生PDF文檔數據加載錯誤時被調用。
• onPageLoadSuccess：讓你定義一個回調，它將在PDF頁面數據加載完畢后被調用。
• onPageRenderSuccess：讓你定義一個回調，在PDF頁面被完全渲染到DOM后執(zhí)行。

如果你認為這工作太多，你可以簡單地直接使用Pdfcomponent，它在內部利用usePdf鉤子。

import React, { useState } from 'react'; 
import Pdf from '@mikecousins/react-pdf'; 
  
const MyPdfViewer = () => { 
  const [page, setPage] = useState(1); 
  
  return <Pdf file="sampledoc.pdf" page={page} />; 
}; 

npm軟件包@mikecousins/react-pdf-js每周有2,646次下載，有497顆GitHub星。

你可以簡單地用yarn add @mikecousins/react-pdf或npm install @mikecousins/react-pdf來安裝@mikecousins/react-pdf。

小結

我們來看看他們具體的下載量：

Source: https://www.npmtrends.com/

Source: https://www.npmtrends.com/

在分析了功能、流行度、安全問題和社區(qū)支持之后，我認為pdf查看器庫的最佳選擇是React-pdf。

考慮到發(fā)布版本的模式、軟件庫活動和其他相關數據，React-pdf的維護狀況遠遠領先于其他所有庫。

不過，庫的選擇可以根據你的要求來改變。我想這篇文章一定會幫助你更多地了解這些庫。