推荐开源项目:react-pdf-js —— 轻松在React中渲染PDF文档

推荐开源项目:react-pdf-js —— 轻松在React中渲染PDF文档

项目介绍

react-pdf-js 是一个基于 PDF.js 的React组件库,它为你提供了便捷的方式,在你的React应用中展示和操控PDF文档。通过这个库,你可以轻松地将PDF文件集成到网页中,并实现各种交互功能。

项目技术分析

react-pdf-js 使用了Mozilla的PDF.js库作为其核心解析引擎,这使得它能够很好地处理各种复杂的PDF文档,包括图片、文本、表格等元素。项目还提供了一个名为usePdf的Hook,让你能够在函数式组件中方便地获取并操作PDF文档和页面。此外,它允许自定义缩放比例、旋转角度以及设置跨域请求时的凭据,为开发者提供了很大的灵活性。

项目及技术应用场景

react-pdf-js 可广泛应用于以下场景:

  • 在线阅读器: 在网站上创建一个用户友好的PDF阅读体验。
  • 文档预览: 在提交或下载之前让用户预览文档内容。
  • 教育平台: 教材、课件的展示,支持交互式学习。
  • 企业内部系统: 流程说明、合同签署等场景,实现文档的无纸化处理。

项目特点

  1. 简单易用: 提供简洁API,快速集成到React应用中。
  2. 兼容性广: 支持各种复杂PDF文档,确保高质量显示。
  3. 响应式设计: 自动适配不同屏幕尺寸,确保良好观感。
  4. 交互性强: 支持页面跳转、缩放、旋转等操作。
  5. 性能优化: 利用PDF.js的强大性能,加载速度快速。
  6. 社区活跃: 开源项目,有持续更新与维护,遇到问题可以寻求社区帮助。

如果你想在React应用中优雅地处理PDF文档,react-pdf-js 绝对是值得尝试的选择。现在就通过 npm install @mikecousins/react-pdf pdfjs-dist 或者 yarn add @mikecousins/react-pdf pdfjs-dist 安装它,开始你的PDF展示之旅吧!

演示地址:https://pdf.netlify.com
代码示例:

// ...
const MyPdfViewer = () => {
  const [page, setPage] = useState(1);
  const canvasRef = useRef(null);

  const { pdfDocument, pdfPage } = usePdf({
    file: 'test.pdf',
    page,
    canvasRef,
  });

  // ...
};

了解更多详情,请查阅项目文档和GitHub仓库: https://github.com/mikecousins/react-pdf-js

  • 6
    点赞
  • 6
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
react-pdf-viewer是一个基于ReactPDF阅读器组件库,由于其开源且易于使用的特点,被广泛应用于Web开发。 以下是react-pdf-viewer的文档: ## 安装 使用npm安装: ``` npm install @react-pdf-viewer/core --save ``` 或者使用yarn安装: ``` yarn add @react-pdf-viewer/core ``` ## 使用 ```javascript import React from 'react'; import { Viewer } from '@react-pdf-viewer/core'; import '@react-pdf-viewer/core/lib/styles/index.css'; const App = () => ( <Viewer fileUrl="https://arxiv.org/pdf/quant-ph/0410100.pdf" /> ); export default App; ``` ## API ### Viewer PDF阅读器组件,提供一系列的props来控制阅读器的行为。 #### 属性 * `fileUrl: string`:必须的属性。PDF文件的URL。 * `defaultScale?: number | string`:PDF文件的默认缩放比例。可以是数字,也可以是字符串,例如“auto”、“page-width”、“page-fit”、“50%”等。默认值为“auto”。 * `initialPage?: number`:PDF文件的初始页数。默认值为1。 * `onDocumentLoad?(pdfDocument: PdfDocument) => void`:当PDF文件加载完成时调用的回调函数。 * `onPageChange?(page: number) => void`:当页码发生改变时调用的回调函数。 * `renderError?(error: Error) => React.ReactElement`:当加载PDF文件出错时的自定义渲染函数。 * `renderLoader?() => React.ReactElement`:当加载PDF文件时的自定义渲染函数。 * `theme?: ThemeContext`:阅读器的主题。默认为`defaultTheme`。 ### defaultLayoutPlugin 默认的布局插件,提供一系列的props来控制布局。 #### 属性 * `defaultScale?: number | string`:PDF文件的默认缩放比例。可以是数字,也可以是字符串,例如“auto”、“page-width”、“page-fit”、“50%”等。默认值为“auto”。 * `sidebarTabs?: Array<SidebarTab>`:侧边栏选项卡列表。默认为`[bookmarksTab, attachmentsTab]`。 * `sidebarWidth?: number`:侧边栏的宽度。默认为`280`。 * `thumbnailContainer?: (props: ThumbnailContainerProps) => React.ReactElement`:自定义缩略图容器组件。 * `topToolbar?: (props: ToolbarProps) => React.ReactElement`:自定义顶部工具栏组件。 * `zoom?(scale: number) => void`:缩放PDF文件的函数。当需要在自定义组件调用缩放功能时,需要将此函数作为props传递给自定义组件。 ### defaultToolbarPlugin 默认的工具栏插件,提供一系列的props来控制工具栏。 #### 属性 * `numberOfPages?: number`:PDF文件的总页数。当PDF文件加载完成后,将自动更新此属性。 * `page?: number`:PDF文件的当前页码。当页码发生改变时,将自动更新此属性。 * `zoom?(scale: number) => void`:缩放PDF文件的函数。当需要在自定义组件调用缩放功能时,需要将此函数作为props传递给自定义组件。 ### defaultTheme 默认的主题。 #### 属性 * `background?: string`:阅读器的背景色。默认为`#fff`。 * `color?: string`:阅读器的前景色。默认为`#000`。 * `primaryColor?: string`:阅读器的主色调。默认为`#4caf50`。 * `secondaryColor?: string`:阅读器的次色调。默认为`#2196f3`。 ## 示例 以下是一个包含自定义缩略图容器和工具栏的示例: ```javascript import React, { useState } from 'react'; import { Viewer, defaultLayoutPlugin, defaultToolbarPlugin, ThumbnailList, Toolbar } from '@react-pdf-viewer/core'; import '@react-pdf-viewer/core/lib/styles/index.css'; const App = () => { const [numPages, setNumPages] = useState(0); const [currentPage, setCurrentPage] = useState(0); const handleDocumentLoadSuccess = ({ numPages }) => { setNumPages(numPages); }; const handlePageChange = (page) => { setCurrentPage(page); }; const handleZoom = (scale) => { console.log(`Zoom to ${scale}`); }; const thumbnailContainer = (props) => ( <div style={{ padding: '16px 0' }}> <ThumbnailList {...props} /> </div> ); const topToolbar = (props) => ( <div style={{ padding: '16px 0' }}> <Toolbar {...props} pageIndex={currentPage} numberOfPages={numPages} zoom={handleZoom} /> </div> ); return ( <div style={{ display: 'flex', flexDirection: 'row', height: '100vh' }}> <Viewer fileUrl="https://arxiv.org/pdf/quant-ph/0410100.pdf" plugins={[ defaultLayoutPlugin({ thumbnailContainer, }), defaultToolbarPlugin({ topToolbar, }), ]} onDocumentLoadSuccess={handleDocumentLoadSuccess} onPageChange={handlePageChange} /> </div> ); }; export default App; ``` ## 参考 * [react-pdf-viewer官方文档](https://react-pdf-viewer.dev/)

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

强妲佳Darlene

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值