react-native-pdf

A react native PDF view component (cross-platform support)

Feature

• read a PDF from url/local file/asset and can cache it.
• display horizontally or vertically
• drag and zoom
• first tap for reset zoom and continuous tap for zoom in
• support password protected pdf

Installation

npm install react-native-pdf --save

react-native link react-native-pdf

We use react-native-fetch-blob to handle file system access in this package and it requires an extra step during the installation. You should only have to do this once.

npm install react-native-fetch-blob --save

react-native link react-native-fetch-blob

Or, if you want to add Android permissions to AndroidManifest.xml automatically, use this one:

RNFB_ANDROID_PERMISSIONS=true react-native link react-native-fetch-blob

ChangeLog

v1.3.4

1. update ios project to xcode9 format.
2. fix crash problem when load from base64 #58
3. fix TypeScript definition for onError #53
4. update sample code in readme

v1.3.3

1. improve ios scrolling, fix #47

v1.3.2

1. move react-native and react-native-fetch-blob to peerDependencies

v1.3.1

1. refactor android source
2. stop page scrolling when tap screen #41

v1.3.0

1. fix drawing problem on Android 4.4 #31
2. add fitWidth support #36 , #38

[more]

Example

/**
 * Copyright (c) 2017-present, Wonday (@wonday.org)
 * All rights reserved.
 *
 * This source code is licensed under the MIT-style license found in the
 * LICENSE file in the root directory of this source tree.
 */

import React from 'react';
import {
    StyleSheet,
    TouchableHighlight,
    Dimensions,
    View,
    Text
} from 'react-native';

import Pdf from 'react-native-pdf';

export default class PDFExample extends React.Component {
    constructor(props) {
        super(props);
        this.state = {
            page: 1,
            pageCount: 1,
        };
        this.pdf = null;
    }

    componentDidMount() {
    }

    prePage=()=>{
        if (this.pdf){
            let prePage = this.state.page>1?this.state.page-1:1;
            this.pdf.setNativeProps({page: prePage});
            this.setState({page:prePage});
            console.log(`prePage: ${prePage}`);
        }
    }

    nextPage=()=>{
        if (this.pdf){
            let nextPage = this.state.page+1>this.state.pageCount?this.state.pageCount:this.state.page+1;
            this.pdf.setNativeProps({page: nextPage});
            this.setState({page:nextPage});
            console.log(`nextPage: ${nextPage}`);
        }

    }

    render() {
        //let source = {uri:'http://samples.leanpub.com/thereactnativebook-sample.pdf',cache:true};
        //let source = require('./test.pdf');  // ios only
        let source = {uri:'bundle-assets://test.pdf'};

        //let source = {uri:'file:///sdcard/test.pdf'};
        //let source = {uri:"data:application/pdf;base64,......"};

        return (
            <View style={styles.container}>
                <View style={{flexDirection:'row'}}>
                    <TouchableHighlight  disabled={this.state.page==1} style={this.state.page==1?styles.btnDisable:styles.btn} onPress={()=>this.prePage()}>
                        <Text style={styles.btnText}>{'Previous'}</Text>
                    </TouchableHighlight>
                    <TouchableHighlight  disabled={this.state.page==this.state.pageCount} style={this.state.page==this.state.pageCount?styles.btnDisable:styles.btn}  onPress={()=>this.nextPage()}>
                        <Text style={styles.btnText}>{'Next'}</Text>
                    </TouchableHighlight>
                </View>
                <Pdf ref={(pdf)=>{this.pdf = pdf;}}
                    source={source}
                    page={1}
                    scale={1}
                    horizontal={false}
                    onLoadComplete={(pageCount)=>{
                        this.setState({pageCount: pageCount});
                        console.log(`total page count: ${pageCount}`);
                    }}
                    onPageChanged={(page,pageCount)=>{
                        this.setState({page:page});
                        console.log(`current page: ${page}`);
                    }}
                    onError={(error)=>{
                        console.log(error);
                    }}
                    style={styles.pdf}/>
            </View>
        )
  }
}

const styles = StyleSheet.create({
    container: {
        flex: 1,
        justifyContent: 'flex-start',
        alignItems: 'center',
        marginTop: 25,
    },
    btn: {
        margin: 5,
        padding:5,
        backgroundColor: "blue",
    },
    btnDisable: {
        margin: 5,
        padding:5,
        backgroundColor: "gray",
    },
    btnText: {
        color: "#FFF",
    },
    pdf: {
        flex:1,
        width:Dimensions.get('window').width,
    }
});

Configuration

Property	Type	Default	Description	iOS	Android
source	object	not null	PDF source like {uri:xxx, cache:false}. see the following for detail.	✔	✔
page	number	1	page index	✔	✔
scale	number	1.0	zoom scale, scale>=1	✔	✔
horizontal	bool	false	draw page direction, if you want to listen the orientation change, you can use [react-native-orientation-locker]	✔	✔
fitWidth	bool	false	if true fit the width of view	✔	✔
spacing	number	10	draw page breaker	✔	✔
password	string	""	pdf password, if password error, will call OnError() with message "Password required or incorrect password."	✔	✔
style	object	{backgroundColor:"#eee"}	support normal view style, you can use this to set border/spacing color...	✔	✔
activityIndicator	Component	ProgressBar	when loading show it as an indicator	✔	✔
enableAntialiasing	bool	true	improve rendering a little bit on low-res screens, but maybe course some problem on Android 4.4, so add a switch	✖	✔
onLoadProgress	function	null	callback when loading, return loading progress (0-1)	✔	✔
onLoadComplete	function	null	callback when pdf load completed, return total page count	✔	✔
onPageChanged	function	null	callback when page changed ,return current page and total page count	✔	✔
onError	function	null	callback when error happened	✔	✔

parameters of source

parameter	Description	default	iOS	Android
uri	pdf source, see the forllowing for detail.	required	✔	✔
cache	use cache or not	false	✔	✔
method	request method when uri is a url	"GET"	✔	✔
headers	request headers when uri is a url	{}	✔	✔

types of source.uri

Usage	Description	iOS	Android
{uri:"http://xxx/xxx.pdf"}	load pdf from a url	✔	✔
{require("./test.pdf")}	load pdf relate to js file (do not need add by xcode)	✔	✖
{uri:"bundle-assets://path/to/xxx.pdf"}	load pdf from assets, the file should be at android/app/src/main/assets/path/to/xxx.pdf	✖	✔
{uri:"bundle-assets://xxx.pdf"}	load pdf from assets, you must add pdf to project by xcode. this does not support folder.	✔	✖
{uri:"base64data"}	load pdf from base64 string	✔	✔
{uri:"file:///absolute/path/to/xxx.pdf"}	load pdf from local file system	✔	✔