PDF Web Viewer Release Notes

Added

• Viewer users can create rectangle and ellipse shape annotations. Users can customize the border color, fill color, and border width, and edit these annotations by moving, resizing, locking, or deleting them.
• Toolbar buttons display dark-themed tooltips on hover.
• PDF Viewer SDK supports FDF (Forms Data Format). Save or download documents as FDF by setting the
  saveAsFdf
  option to
  true
  :
  viewer.document.save({saveAsFdf:
  true
  }) ;
• A loading spinner and progress bar provide visual feedback while the viewer uploads and opens documents.
• Viewer users can set the input document parameter when initializing the viewer to skip the document upload screen:
  viewer.initialize({inputDocument: {uri:
  'url_to_a_file'
  } ,
  ...}) ;
  viewer.initialize({inputDocument: {data: file} ,
  ...}) ;

Changed

• Redesigned the thumbnails panel. The active page displays with a blue highlight.
• Toolbar dropdown components (zoom, fit mode, page layout, and pagination) close automatically when users click outside or open another dropdown.
• The pagination component supports page number input, letting users navigate to a specific page directly.
• Updated icons throughout the viewer, including the file open icon and line ending icons in the annotation popover.
• Redesigned the document upload screen.
• Rewrote the document opening flow, removing code duplication and memory leaks.

Fixed

• Toolbar icons no longer shift position when navigating to pages with two or more digits.
• Dropdown panels (zoom, fit mode, layout, and annotation popovers) no longer overlap. Opening one panel closes any other open panel.
• Opening the search or thumbnails panel no longer deactivates the active plugin.
• The sticky notes popover closes immediately when activating stamp or redaction plugins, rather than waiting for the sidebar to open.
• Before this update, the app layout used a deprecated layout system. As a result, page margins were inconsistent on mobile and tablet devices. With this update, the app layout uses a consistent margin system across desktop, mobile, and tablet devices.

Added

• Viewer users can create redaction annotations by selecting text, drawing rectangles on the document, or redacting the current page or a specified range of pages. A dedicated Redact panel displays all redaction annotations, allowing users to lock them to prevent accidental edits or delete them.
• Viewer users can download a redacted version of the document using Apply Redactions button in the Redact panel. Annotations are not included in the downloaded file.

Changed

• Zoom level change events are debounced, which enhances performance when users rapidly zoom in and out of documents.
• Refactored the PDF Viewer SDK API. As a result, the API has reduced the number of parameters and configuration options, delivering the same functionality with greater simplicity and usability.
• Improved and faster build process, valid source maps, and reliable ECMAScript Modules (ESM) and Universal Module Definition (UMD) bundles.

Fixed

• Replaced delete and lock icons across all context menus with consistently sized icons, making actions easier to identify.

Added

• Users can add text annotations (free-text notes) to PDFs, supporting rich text formatting with options for font family, font size, text color, alignment, and styles such as bold, italic, and underline. Text annotations can be edited inline, moved by dragging, or deleted.
• Users can now add image annotations to PDFs by selecting and placing an image on the document. Existing image annotations can be moved, resized, deleted, or locked.
• With this release, the PDF Web Viewer enables developers to create custom plugins using a dedicated plugin API. Developers can register, activate, and deactivate plugins, create layers for drawing on the document view, and add buttons to control plugin state.
• The PDF Web SDK exposes accessibility events and keyboard interactions through the TextSelectionPlugin. The cursorPositionChanged event enables tracking of cursor position changes. The keyDown event exposes keyboard interactions. In text selection mode, users can click on text to display a cursor. They can move the text using the arrow keys. Users can select text with Shift + Arrow, navigate word by word with Ctrl or Cmd + Arrow, and select word by word with Shift + Ctrl or Cmd + Arrow.
• Added support for redaction annotations as a TextMarkupType in the PDF Web SDK. As a result, developers can implement redaction annotation creation in their applications.

Changed

• The textSelectionChanged event now provides additional geometry data. This includes selection quadrilaterals with page numbers, start and end page numbers, and the selected text content. The following method was changed:
  The following methods changed:
  textSelectionChanged()
  From:
  textSelectionChanged: (selectedText: string) => void
  To:
  textSelectionChanged: (textSelectionData: TextSelection) => void

• The PDF Web Viewer enhanced web components for improved accessibility, introducing updated button, menu, dropdown, and toolbar components. All components are now fully keyboard accessible and screen reader compatible.
  The following methods changed:
  hideComponents()
  From:
  hideComponents: (components: HideableComponentConfigName[]) => void
  To:
  hideComponents: (paths: string[] | string[][]) => void
  showComponents()
  From:
  showComponents: (components: HideableComponentConfigName[]) => void
  To:
  showComponents: (paths: string[] | string[][]) => void
  overrideButtonBehavior()
  From:
  overrideButtonBehavior: (buttonName: string, eventName: string, callback: () => void ) => void
  To:
  overrideButtonBehavior: (path: string | string[], eventName: OverridableButtonEventType, callback: () => void) => void;