Angular2下使用pdf插件

Posted on | In

前言

最近需要在Angualr2建的项目里做一个pdf显示的功能，在网上找了个插件，不过由于是第一次使用额外插件，在用的时候遇到了一些坑，这里权且记一下使用的步骤，方便以后的参考。

安装

这里需要安装两个包：pdfjs-dist和ng2-pdf-viewer，安装时是要顺便保存到package.json里的，因此在项目根目录下输入下面命令：

1
2
npm install pdfjs-dist --save
npm install ng2-pdf-viewer --save

于此同时，我们还要在system.config.js里添加映射，否则会加载不到这个插件。我们需要添加两个地方，首先是要添加在其中的map变量下：

1
2
3
4
5
var map = {
    ......
    'ng2-pdf-viewer': 'node_modules/ng2-pdf-viewer',
    'pdfjs-dist': 'node_modules/pdfjs-dist'
}

然后还要添加在packages变量下：

1
2
3
4
var packages = {
    'ng2-pdf-viewer': { main: 'dist/index.js', defaultExtension: 'js' },
    'pdfjs-dist': { defaultExtension: 'js' }
}

这样我们才能正确的引用这个包。

注册主配置文件

要使用他，我们还要在app.module.ts文件里注册这个包，才能在其他文件里使用，一个最简单的配置如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
import { NgModule } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { AppComponent } from './app/app.component';
import { PdfViewerComponent } from 'ng2-pdf-viewer';

@NgModule({
  imports: [BrowserModule],
  declarations: [AppComponent, PdfViewerComponent],
  bootstrap: [AppComponent]
})

class AppModule {}
platformBrowserDynamic().bootstrapModule(AppModule);

注意要import，然后在@NgModule里的declarations里注册即可。

页面配置

在模板页面中，只要在适当的位置添加类似下面的标签：

1
2
3
4
5
<pdf-viewer [src]="pdfSrc"
            [page]="page"
            [original-size]="true"
            style="display: block;"
></pdf-viewer>

然后在.ts文件里定义pdfSrc以及page变量，即可控制显示的文件路径以及页数。
这里需要注意的是文件源如果是跨域的话是会报一个error的，而且这里的page是竖排显示的而不是带滚轮的显示，因此这实际上显示的是一张一张的图片。

当然，pdf-viewer还有很多其他的属性，比如支持缩放，旋转，以及提供了一系列相关的回调函数，具体的可以在github里找到。

样例

参考

github/VadimDez/ng2-pdf-viewer
SYSTEMJS.md
Angular 2 PDF Viewer and thumbnail creation