wojtekmaj/react-pdf

Что это?

Ключевые возможности

• 01Рендерит страницы PDF в виде React-компонентов с помощью API Document и Page.
• 02Принимает в качестве источников URL, данные в формате base64, Uint8Array и импортированные файлы.
• 03Интегрируется с React Suspense и Error Boundaries; также доступен устаревший режим загрузки.
• 04Поддерживает аннотации и текстовые слои с помощью дополнительных таблиц стилей.
• 05Загружает cMaps, декодеры WebAssembly и стандартные шрифты для нелатинского текста и специальных форматов изображений.

Сценарии использования

• Отображение загруженных или размещённых в сети PDF-документов, например договоров и отчётов, в веб-приложении на React.
• Создание собственного PDF-просмотрщика с навигацией по страницам и запросом пароля.
• Отображение предпросмотра или миниатюр PDF с боковой панелью оглавления.

Быстрый старт

1. 1

   Установите React-PDF с помощью npm

   npm install react-pdf
2. 2

   Импортируйте Document и Page и отображайте PDF внутри Suspense и Error Boundary

3. 3

   Настройте worker PDF.js в том же модуле, где отображаются компоненты PDF

Что важно знать

• !Для последней версии требуется React 19 или новее.
• !Требуется Node.js версии 22.13.0 или новее.
• !Для загрузки worker PDF.js и cMaps для текста на языках с нелатинской письменностью требуется дополнительная настройка.

В подборках

Темы

Частые вопросы

Что такое react-pdf?

Библиотека React-компонентов для отображения PDF-файлов в приложениях на React: рендерит страницы подобно изображениям и использует PDF.js. React-PDF позволяет отображать существующие PDF-документы в приложениях на React. Для этого разработчики добавляют компонент Document с источником файла — например, URL, строкой base64, Uint8Array или импортированным файлом — и помещают внутрь компоненты Page для отображения страниц. Библиотека предназначена для просмотра PDF, а не для их создания; для генерации PDF из React проект рекомендует @react-pdf/renderer.

react-pdf можно использовать бесплатно? Какая у него лицензия?

react-pdf распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

react-pdf всё ещё поддерживается?

Активно поддерживается. Последний коммит в react-pdf — 28 окт. 2026 г..

Для чего можно использовать react-pdf?

Отображение загруженных или размещённых в сети PDF-документов, например договоров и отчётов, в веб-приложении на React. Создание собственного PDF-просмотрщика с навигацией по страницам и запросом пароля. Отображение предпросмотра или миниатюр PDF с боковой панелью оглавления.

Как установить react-pdf?

Установите React-PDF с помощью npm: npm install react-pdf Импортируйте Document и Page и отображайте PDF внутри Suspense и Error Boundary Настройте worker PDF.js в том же модуле, где отображаются компоненты PDF

Где скачать react-pdf?

Исходный код и инструкции по установке — на GitHub: https://github.com/wojtekmaj/react-pdf