界面组件Kendo UI for Angular教程 - 构建强大的PDF阅读器（二）

news2024/11/16 13:36:13

如今当用户需要处理PDF文件时，通常不得不下载应用程序或者浏览器插件，控制用户如何与PDF交互并不是一件容易的事。如果我们提供PDF作为内容，用户可以下载它并使用浏览器或PDF本身提供的控件进行交互。然而，一些企业可能希望控制用户使用PDF的方式，以提供更好的体验或在某些条件下限制下载。

构建这样的解决方案需要在后端和前端都付出巨大的努力，然而如果有一种方法可以让您在Angular PDF Viewer中用几行代码来管理PDF交互呢？Kendo UI for Angular PDFViewer可以帮助大家解决上述的一些问题，它以最佳的方式应用到每个合适的场景中。

P.S：Kendo UI for Angular是专用于Angular开发的专业级Angular组件，这些组件是专门为Angular构建的，没有任何jQuery依赖项。

在上文中（点击这里回顾>>），我们为大家介绍了构建PDF阅读器的基本设置、布局和PDF查看器构建等，本文将继续介绍如何处理Kendo UI PDF阅读器事件！

Kendo UI for Angular 2024 Q1新版下载(Q技术交流：726377843）

处理Kendo UI PDF Viewer事件

我们有几个挑战需要解决：

当用户接受条款和条件时，从工具栏启用下载选项。
保存并存储用户访问的最后一个页面。
当用户达到页面限制时显示支付模式。

您觉得工作太多了吗？Kendo UI PDF Viewer使用事件侦听器和几行代码简化了这个过程。

使用Kendo UI PDFViewer工具栏

默认情况下，Kendo PDFViewer显示工具栏中的所有选项。然而我们想要更多的控制，并希望当用户同意条款和条件显示下载按钮。

Kendo UI PDF Viewer允许我们通过提供PDFListViewerTool键数组来定义工具栏中的选项列表，可以在reader.service.ts中指定这个列表，并在其后面添加一个包含所需工具栏选项的新数组。

最后实现一个allowDownload方法，将“download”键添加到工具栏选项数组中。这样当用户接受条款和条件时，“download”选项就可用了。

最后的代码看起来是这样：

import { Injectable } from '@angular/core';
import {PDFViewerTool} from "@progress/kendo-angular-pdfviewer";

export class ReaderService {
public assetURL = 'http://localhost:4200/assets/';

private currentPage: number = 0 ; // Initialize with the default page
private storageKey: string = 'book-page';

//list of new list of options
public toolbar: PDFViewerTool[] = ['search', 'selection', 'print', 'pager'];

savePage(page: number) {
localStorage.setItem(this.storageKey, page.toString());
}

getPage() {
const savedPage = localStorage.getItem(this.storageKey) || this.currentPage;
return +savedPage;
}

allowDownload(acceptTerms: boolean) {
if (acceptTerms) {
this.toolbar.push('download');
} else {
this.toolbar.pop();
}
}
}

接下来，声明一个名为toolbarOptions的新变量，并绑定readerService.toolbar：

toolbarOptions = this.readerService.toolbar;

然后将kendo-pdfviewer组件中的tools属性链接到toolbarOptions：

<kendo-pdfviewer
[tools]="toolbarOptions"
[saveFileName]="bookName"
[url]="pdfAssetUrl">
</kendo-pdfviewer>

保存更改后，您将注意到工具栏现在只显示前四个选项，由toolbarOptions指定。

界面组件Kendo UI for Angular教程 - 构建强大的PDF阅读器

为了仅在用户同意这些条款时显示“download”选项，我们需要采取几个步骤。

首先创建一个名为acceptTerms的变量，使用Angular的ngModel和ngModelChange事件，我们就可以调用一个名为activateDownload的新方法，这个方法将触发我们服务中的allowdownload方法来更新工具栏选项。

export class AppComponent {
....
acceptTerms: boolean = false;

activateDownload() {
this.readerService.allowDownload(this.acceptTerms);
}
}

在app.component.html文件中，我们可以使用ngModel来绑定acceptTerms变量，并通过(ngModelChange)事件来监听变化。当用户与复选框交互时，此事件将触发activateDownload方法。

<input [(ngModel)]="acceptTerms" id="acceptTerms" type="checkbox" (ngModelChange)="activateDownload()"/>

保存更改，现在当选中“Agree with the Terms of Download”复选框时，“Download”选项应该出现在工具栏中，当您取消选中它时，它应该消失。

界面组件Kendo UI for Angular教程 - 构建强大的PDF阅读器

现在可以控制工具栏了！接下来，让我们深入研究Kendo UI PDF Viewer的事件处理功能。

保存和加载事件

Kendo UI PDF Viewer提供了两个方便的事件：load和pageChange，我们将把这些事件附加到reader.service中的方法上，来加载或保存相关信息。

为此打开app.component.ts并创建一个名为saveCurrentPage的方法，该方法接受PDFViewerPageChangeEvent作为参数，此事件对象包含有关PDF中当前页面的信息。

saveCurrentPage($event: PDFViewerPageChangeEvent) {
this.readerService.savePage($event.currentPage);
}

在HTML文件中，将pageEvent与saveCurrentPage方法关联起来，并将PDF查看器的高度设置为600像素。

<kendo-pdfviewer
[tools]="toolbarOptions"
[saveFileName]="bookName"
[url]="pdfAssetUrl"
style="height: 600px;"
(pageChange)="saveCurrentPage($event)">
</kendo-pdfviewer>

保存更改后，服务将在本地存储中存储book-page键。

界面组件Kendo UI for Angular教程 - 构建强大的PDF阅读器

要在用户加载PDF时跳转到特定的页面，并访问Kendo UI for Angular PDFViewer，我们可以使用Angular的ViewChild装饰器，这允许访问组件并监听加载事件。

首先向Kendo UI PDF Viewer组件添加一个模板引用，然后用一个名为loadPage()的新方法链接加载事件。

<kendo-pdfviewer
#pdfViewer
[tools]="toolbarOptions"
[saveFileName]="bookName"
[url]="pdfAssetUrl"
style="height: 600px;"
(pageChange)="saveCurrentPage($event)"
(load)="loadPage()"
>
</kendo-pdfviewer>

在app.component.ts中，声明一个与模板引用同名的ViewChild pdfViewer来访问PDFViewerComponent引用和bookPage来存储来自服务的getPage：

@ViewChild('pdfViewer') pdfViewer!: PDFViewerComponent;
bookPage = this.readerService.getPage();

添加loadPage方法，该方法利用pdfViewer的scrollToPage函数导航到readerService.getPage返回的页面。

loadPage() {
this.bookPage = this.readerService.getPage();
this.pdfViewer.scrollToPage(this.bookPage);
}

保存更改，PDF将跳转到您查看的最后一页。

界面组件Kendo UI for Angular教程 - 构建强大的PDF阅读器

显示Paywall

为了锦上添花，我们希望在用户达到页面限制时阻塞UI，并阻止他们移动到下一页。

打开app.component.html，首先将只在选择图书时显示kendo-pdf-viewer和paywall，在ng-container中添加一个*ngIf指令来监视bookName。此外，使用另一个*ngIf指令来显示基于showMessageWall变量的paywall。

<ng-container *ngIf="bookName">
...

<div class="pay-wall" *ngIf="showMessageWall">
<h1>You reach limit to read </h1>

<button (click)="showMessageWall = false"> close</button>
</div>
</ng-container>

在app.component.ts中，添加两个新变量：

pageLimit = 2;
showMessageWall = false;

添加一个新方法来验证currentPage是否超过pageLimit，如果为true，则将showMessageWall设置为true，并使用scrollToPage方法跳转回pageLimit。

private canReadMore(currentPage: number) {
if (currentPage > this.pageLimit) {
this.pdfViewer.scrollToPage(this.pageLimit);
this.showMessageWall = true;
} else {
this.showMessageWall = false;
}
}

最后在saveCurrentPage函数中调用此方法，以便在每次用户更改页面时触发它。

saveCurrentPage($event: PDFViewerPageChangeEvent) {
const { currentPage } = $event;
this.readerService.savePage(currentPage);
this.canReadMore(currentPage);
}

继续保存它们，在那之后我们看到整个工作流程如预期的那样运行：Kendo UI for Angular PDFViewer加载、工具栏自定义，以及当页面达到限制时出现的paywall。

界面组件Kendo UI for Angular教程 - 构建强大的PDF阅读器