Package detailsv1.4.5

flutter_pdfview

A Flutter plugin that provides a PDFView widget on Android and iOS.

AndroidiOS

pub.dev API documentation Source code

30-day downloads: 458K
Likes: 751
Pub points: 160

Install package

flutter pub add flutter_pdfview

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

flutter_pdfview is a Flutter plugin that enables rendering PDF documents within Flutter applications on both Android and iOS platforms. It provides a PDFView widget that supports basic PDF viewing functionalities such as zooming, panning, and page navigation. The plugin leverages native PDF rendering capabilities of each platform to ensure smooth performance and accurate display. It is ideal for apps requiring document preview or reading features without the need for external viewers.

Use cases

Displaying PDF documents in apps
Document preview functionality
Reading e-books or manuals
Integrating PDFs in educational apps
Offline document access

Key features

Native PDF rendering on Android and iOS
Zoom and pan support
Page navigation
Lightweight and efficient
Cross-platform compatibility

Suitable for

Apps needing PDF viewing
Educational or documentation-focused apps
Mobile readers
Content delivery platforms
Offline document access

Considerations

Limited advanced PDF editing features
No built-in search functionality
Performance may vary with large PDFs
Requires proper file handling for local or remote PDFs
Depends on native platform rendering quality

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

flutter_pdfview

Native PDF View for iOS and Android

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_pdfview: ^1.4.5

2. Install it

You can install packages from the command line:

with Flutter:

$ flutter packages get

Alternatively, your editor might support pub get or flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:flutter_pdfview/flutter_pdfview.dart';

Options

Name	Android	iOS	Default
defaultPage	✅	✅	`0`
onViewCreated	✅	✅	`null`
onRender	✅	✅	`null`
onPageChanged	✅	✅	`null`
onLoadComplete	✅	✅	`null`
onDraw	✅	✅	`null`
onError	✅	✅	`null`
onPageError	✅	❌	`null`
onLinkHandle	✅	✅	`null`
gestureRecognizers	✅	✅	`null`
filePath	✅	✅
pdfData	✅	✅
fitPolicy	✅	✅	`FitPolicy.WIDTH`
enableSwipe	✅	✅	`true`
swipeHorizontal	✅	✅	`false`
password	✅	✅	`null`
nightMode	✅	❌	`false`
autoSpacing*	✅	✅	`true`
pageFling	✅	✅	`true`
pageSnap	✅	❌	`true`
preventLinkNavigation	✅	✅	`false`
backgroundColor	✅	✅	`null`
minZoom	✅	✅	1.0
maxZoom	✅	✅	4.0
showScrollIndicators*	✅	✅	`false`

Notes:

showScrollIndicators is ignored on iOS while horizontal page-flipping is active (pageFling: true together with swipeHorizontal: true).
autoSpacing only adds gaps between pages. It does not change initial zoom or fitPolicy (fixed in #150).

Using PDFView inside a scrollable widget

When a PDFView is embedded in a scrollable parent (SingleChildScrollView, ListView, PageView, ...), the parent can claim drag gestures before they reach the native view, so swiping inside the PDF does not work — most notably on iOS (#265). Pass an EagerGestureRecognizer to let the PDF view consume gestures within its bounds:

import 'package:flutter/foundation.dart';
import 'package:flutter/gestures.dart';

PDFView(
  filePath: path,
  gestureRecognizers: {
    Factory<OneSequenceGestureRecognizer>(() => EagerGestureRecognizer()),
  },
)

Controller Options

Name	Description	Parameters	Return
getPageCount	Get total page count	-	`Future<int>`
getCurrentPage	Get current page	-	`Future<int>`
setPage	Go to/Set page	`int page`	`Future<bool>`
getCurrentPageSize	Return the width and height of the loaded page	-	`Future<Size>`
getScreenshot	Create a PNG of the contents of the PDFView and save to fileName	`String fileName`	`Future<String>`
getPosition	Get the position of the top left of the PDF with respect to the origin (top left of PDFView)	-	`Future<Offset>`
getScale	Get the PDF zoom value, for zooming	-	`Future<double>`
setPosition	Set the position of the top left of the PDF with respect to the origin (top left of PDFView)	`Offset position`	`Future<bool>`
setScale	Set the PDF zoom value, for zooming	`double scale`	`Future<bool>`
setZoomLimits	Set the minimum, maximum and mid bounds of the zoom limits	`double minZoom, double midZoom, double maxZoom`	-
reload	Reload the PDF document in the PDFView	-	`Future<bool>`

Example

PDFView(
  filePath: path,
  enableSwipe: true,
  swipeHorizontal: true,
  autoSpacing: false,
  pageFling: false,
  showScrollIndicators: true,
  backgroundColor: Colors.grey,
  onRender: (_pages) {
    setState(() {
      pages = _pages;
      isReady = true;
    });
  },
  onError: (error) {
    print(error.toString());
  },
  onPageError: (page, error) {
    print('$page: ${error.toString()}');
  },
  onViewCreated: (PDFViewController pdfViewController) {
    _controller.complete(pdfViewController);
  },
  onPageChanged: (int page, int total) {
    print('page change: $page/$total');
  },
  onLoadComplete: (int? pages) {
    print('# of pages: $pages');
  },
  onDraw: (double xOffset, double yOffset, double scale) {
    print('onDraw');
  },
),