패키지, 저장소 및 앱 카테고리 검색

패키지 상세v1.4.5

flutter_pdfview

안드로이드 및 iOS에서 PDFView 위젯을 제공하는 플러터 플러그인입니다.

AndroidiOS
30일 다운로드
49.1만
좋아요
751
Pub 점수
160

패키지 설치

flutter pub add flutter_pdfview

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

flutter_pdfview는 Android 및 iOS 플랫폼에서 Flutter 애플리케이션 내부에서 PDF 문서를 렌더링할 수 있도록 해주는 Flutter 플러그인입니다. 줌, 패닝, 페이지 탐색과 같은 기본적인 PDF 보기 기능을 지원하는 PDFView 위젯을 제공합니다. 각 플랫폼의 네이티브 PDF 렌더링 기능을 활용하여 부드러운 성능과 정확한 표시를 보장합니다. 외부 뷰어가 필요 없는 문서 미리보기 또는 읽기 기능을 필요로 하는 앱에 적합합니다.

사용 사례

  • 앱에서 PDF 문서 표시
  • 문서 미리보기 기능
  • 전자책 또는 매뉴얼 읽기
  • 교육 앱에서 PDF 통합
  • 오프라인 문서 액세스

주요 기능

  • 안드로이드 및 iOS에서의 네이티브 PDF 렌더링
  • 줌 및 팬 지원
  • 페이지 탐색
  • 가볍고 효율적
  • 크로스 플랫폼 호환성

적합한 대상

  • PDF 보기 필요 앱
  • 교육 또는 문서 중심 앱
  • 모바일 리더
  • 콘텐츠 전달 플랫폼
  • 오프라인 문서 액세스

고려 사항

  • 제한된 고급 PDF 편집 기능
  • 내장된 검색 기능 없음
  • 큰 PDF 파일에서는 성능이 달라질 수 있습니다
  • 로컬 또는 원격 PDF에 대한 적절한 파일 처리가 필요합니다
  • 네이티브 플랫폼 렌더링 품질에 따라 다릅니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

flutter_pdfview

Native PDF View for iOS and Android

Buy Me A Coffee

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');
  },
),

Dependencies

Android

AndroidPdfViewer

iOS (only support> 12.0)

PDFKit

Future plans

  • Replace barteksc/AndroidPdfViewer with MuPDF or Android Native PDF Renderer.
  • Improve documentation
  • Support other platforms such as MacOS, Windows, Linux and Web
  • Add search functionality
  • Improve performance on zooming, page changing
  • Improve image quality
  • Write more test

Support

Buy Me A Coffee

Donate with PayPal button

Star History

Star History Chart
Developer

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트