2017.7 Migration Guide

PSPDFKit for Web 2017.7 adds support for horizontal scaling, externally managed documents, an improved printing system, and much more.

This release requires changes to the server as well. Please check out our server migration guides to learn more.

Destroy API

Instance#destroy is deprecated in favor of the newly added PSPDFKit.destroy API:

1
2
3
4
5
// Change this…
instance.destroy();

// …to this
PSPDFKit.unload(instance);
1
2
3
4
5
// Change this…
instance.destroy();

// …to this
PSPDFKit.unload(instance);

Changes to CSS Classes

We changed a few CSS classes to be more consistent with the general styling. This mainly affects the selectors for note annotation icons:

Old Class New Class
PSPDFKit-Note-Annotation-Icon-comment PSPDFKit-Note-Annotation-Icon-Comment
PSPDFKit-Note-Annotation-Icon-rightPointer PSPDFKit-Note-Annotation-Icon-RightPointer
PSPDFKit-Note-Annotation-Icon-rightArrow PSPDFKit-Note-Annotation-Icon-RightArrow
PSPDFKit-Note-Annotation-Icon-check PSPDFKit-Note-Annotation-Icon-Check
PSPDFKit-Note-Annotation-Icon-circle PSPDFKit-Note-Annotation-Icon-Circle
PSPDFKit-Note-Annotation-Icon-cross PSPDFKit-Note-Annotation-Icon-Cross
PSPDFKit-Note-Annotation-Icon-insert PSPDFKit-Note-Annotation-Icon-Insert
PSPDFKit-Note-Annotation-Icon-newParagraph PSPDFKit-Note-Annotation-Icon-NewParagraph
PSPDFKit-Note-Annotation-Icon-note PSPDFKit-Note-Annotation-Icon-Note
PSPDFKit-Note-Annotation-Icon-paragraph PSPDFKit-Note-Annotation-Icon-Paragraph
PSPDFKit-Note-Annotation-Icon-help PSPDFKit-Note-Annotation-Icon-Help
PSPDFKit-Note-Annotation-Icon-star PSPDFKit-Note-Annotation-Icon-Star
PSPDFKit-Note-Annotation-Icon-key PSPDFKit-Note-Annotation-Icon-Key

Printing

We changed the default printing mode from PrintMode.EXPORT_PDF to PrintMode.DOM. This should not cause issues with existing setups.

Check out the Printing guide to learn about the differences.

For a full list of changes, check out the changelog.