最近因为工作的原因,需要在Angualr2建的项目里做一个pdf显示的功能,在网上找了个插件,不过由于是第一次使用额外插件,在用的时候遇到了一些坑,这里权且记一下使用的步骤,方便以后的参考。
安装
这里需要安装两个包:pdfjs-dist和ng2-pdf-viewer,安装时是要顺便保存到package.json里的,因此在项目根目录下输入下面命令:
npm install pdfjs-dist --save npm install ng2-pdf-viewer --save
于此同时,我们还要在system.config.js里添加映射,否则会加载不到这个插件。我们需要添加两个地方,首先是要添加在其中的map变量下:
var map = { ...... 'ng2-pdf-viewer': 'node_modules/ng2-pdf-viewer', 'pdfjs-dist': 'node_modules/pdfjs-dist' }
然后还要添加在packages变量下:
var packages = { 'ng2-pdf-viewer': { main: 'dist/index.js', defaultExtension: 'js' }, 'pdfjs-dist': { defaultExtension: 'js' } }
这样我们才能正确的引用这个包。
注册主配置文件
要使用他,我们还要在app.module.ts文件里注册这个包,才能在其他文件里使用,一个最简单的配置如下:
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里注册即可。
页面配置
在模板页面中,只要在适当的位置添加类似下面的标签:
<pdf-viewer [src]="pdfSrc" [ page ]="page" [original-size]="true"> </pdf-viewer>
然后在.ts文件里定义pdfSrc以及page变量,即可控制显示的文件路径以及页数。
这里需要注意的是:文件源如果是跨域的话是会报一个error的,而且这里的page是竖排显示的而不是带滚轮的显示,因此这实际上显示的是一张一张的图片。
当然,pdf-viewer还有很多其他的属性,比如支持缩放,旋转,以及提供了一系列相关的回调函数,具体的可以在github里找到,当然大家也可以通过本地下载。
样例