8eda8c27f8
This is similar to the format used by a number of other viewer components, and should simplify the `PDFSidebar` initialization slightly. Furthermore, by using the `eventBus` it's no longer necessary for `PDFSidebar` to have a direct dependency on `PDFOutlineViewer`. There's still room for improvement here, but this patch is at least a start (since it's not clear to me how best to handle the viewers).
461 lines
14 KiB
JavaScript
461 lines
14 KiB
JavaScript
/* Copyright 2016 Mozilla Foundation
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
import { NullL10n } from './ui_utils';
|
|
import { RenderingStates } from './pdf_rendering_queue';
|
|
|
|
const UI_NOTIFICATION_CLASS = 'pdfSidebarNotification';
|
|
|
|
const SidebarView = {
|
|
NONE: 0,
|
|
THUMBS: 1,
|
|
OUTLINE: 2,
|
|
ATTACHMENTS: 3,
|
|
};
|
|
|
|
/**
|
|
* @typedef {Object} PDFSidebarOptions
|
|
* @property {PDFViewer} pdfViewer - The document viewer.
|
|
* @property {PDFThumbnailViewer} pdfThumbnailViewer - The thumbnail viewer.
|
|
* @property {HTMLDivElement} outerContainer - The outer container
|
|
* (encasing both the viewer and sidebar elements).
|
|
* @property {HTMLDivElement} viewerContainer - The viewer container
|
|
* (in which the viewer element is placed).
|
|
* @property {HTMLButtonElement} toggleButton - The button used for
|
|
* opening/closing the sidebar.
|
|
* @property {HTMLButtonElement} thumbnailButton - The button used to show
|
|
* the thumbnail view.
|
|
* @property {HTMLButtonElement} outlineButton - The button used to show
|
|
* the outline view.
|
|
* @property {HTMLButtonElement} attachmentsButton - The button used to show
|
|
* the attachments view.
|
|
* @property {HTMLDivElement} thumbnailView - The container in which
|
|
* the thumbnails are placed.
|
|
* @property {HTMLDivElement} outlineView - The container in which
|
|
* the outline is placed.
|
|
* @property {HTMLDivElement} attachmentsView - The container in which
|
|
* the attachments are placed.
|
|
* @property {boolean} disableNotification - (optional) Disable the notification
|
|
* for documents containing outline/attachments. The default value is `false`.
|
|
*/
|
|
|
|
class PDFSidebar {
|
|
/**
|
|
* @param {PDFSidebarOptions} options
|
|
* @param {EventBus} eventBus - The application event bus.
|
|
* @param {IL10n} l10n - Localization service.
|
|
*/
|
|
constructor(options, eventBus, l10n = NullL10n) {
|
|
this.isOpen = false;
|
|
this.active = SidebarView.THUMBS;
|
|
this.isInitialViewSet = false;
|
|
|
|
/**
|
|
* Callback used when the sidebar has been opened/closed, to ensure that
|
|
* the viewers (PDFViewer/PDFThumbnailViewer) are updated correctly.
|
|
*/
|
|
this.onToggled = null;
|
|
|
|
this.pdfViewer = options.pdfViewer;
|
|
this.pdfThumbnailViewer = options.pdfThumbnailViewer;
|
|
|
|
this.outerContainer = options.outerContainer;
|
|
this.viewerContainer = options.viewerContainer;
|
|
this.toggleButton = options.toggleButton;
|
|
|
|
this.thumbnailButton = options.thumbnailButton;
|
|
this.outlineButton = options.outlineButton;
|
|
this.attachmentsButton = options.attachmentsButton;
|
|
|
|
this.thumbnailView = options.thumbnailView;
|
|
this.outlineView = options.outlineView;
|
|
this.attachmentsView = options.attachmentsView;
|
|
|
|
this.disableNotification = options.disableNotification || false;
|
|
|
|
this.eventBus = eventBus;
|
|
this.l10n = l10n;
|
|
|
|
this._addEventListeners();
|
|
}
|
|
|
|
reset() {
|
|
this.isInitialViewSet = false;
|
|
|
|
this._hideUINotification(null);
|
|
this.switchView(SidebarView.THUMBS);
|
|
|
|
this.outlineButton.disabled = false;
|
|
this.attachmentsButton.disabled = false;
|
|
}
|
|
|
|
/**
|
|
* @returns {number} One of the values in {SidebarView}.
|
|
*/
|
|
get visibleView() {
|
|
return (this.isOpen ? this.active : SidebarView.NONE);
|
|
}
|
|
|
|
get isThumbnailViewVisible() {
|
|
return (this.isOpen && this.active === SidebarView.THUMBS);
|
|
}
|
|
|
|
get isOutlineViewVisible() {
|
|
return (this.isOpen && this.active === SidebarView.OUTLINE);
|
|
}
|
|
|
|
get isAttachmentsViewVisible() {
|
|
return (this.isOpen && this.active === SidebarView.ATTACHMENTS);
|
|
}
|
|
|
|
/**
|
|
* @param {number} view - The sidebar view that should become visible,
|
|
* must be one of the values in {SidebarView}.
|
|
*/
|
|
setInitialView(view = SidebarView.NONE) {
|
|
if (this.isInitialViewSet) {
|
|
return;
|
|
}
|
|
this.isInitialViewSet = true;
|
|
|
|
if (this.isOpen && view === SidebarView.NONE) {
|
|
this._dispatchEvent();
|
|
// If the user has already manually opened the sidebar,
|
|
// immediately closing it would be bad UX.
|
|
return;
|
|
}
|
|
let isViewPreserved = (view === this.visibleView);
|
|
this.switchView(view, /* forceOpen */ true);
|
|
|
|
if (isViewPreserved) {
|
|
// Prevent dispatching two back-to-back `sidebarviewchanged` events,
|
|
// since `this.switchView` dispatched the event if the view changed.
|
|
this._dispatchEvent();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param {number} view - The sidebar view that should be switched to,
|
|
* must be one of the values in {SidebarView}.
|
|
* @param {boolean} forceOpen - (optional) Ensure that the sidebar is open.
|
|
* The default value is `false`.
|
|
*/
|
|
switchView(view, forceOpen = false) {
|
|
if (view === SidebarView.NONE) {
|
|
this.close();
|
|
return;
|
|
}
|
|
let isViewChanged = (view !== this.active);
|
|
let shouldForceRendering = false;
|
|
|
|
switch (view) {
|
|
case SidebarView.THUMBS:
|
|
this.thumbnailButton.classList.add('toggled');
|
|
this.outlineButton.classList.remove('toggled');
|
|
this.attachmentsButton.classList.remove('toggled');
|
|
|
|
this.thumbnailView.classList.remove('hidden');
|
|
this.outlineView.classList.add('hidden');
|
|
this.attachmentsView.classList.add('hidden');
|
|
|
|
if (this.isOpen && isViewChanged) {
|
|
this._updateThumbnailViewer();
|
|
shouldForceRendering = true;
|
|
}
|
|
break;
|
|
case SidebarView.OUTLINE:
|
|
if (this.outlineButton.disabled) {
|
|
return;
|
|
}
|
|
this.thumbnailButton.classList.remove('toggled');
|
|
this.outlineButton.classList.add('toggled');
|
|
this.attachmentsButton.classList.remove('toggled');
|
|
|
|
this.thumbnailView.classList.add('hidden');
|
|
this.outlineView.classList.remove('hidden');
|
|
this.attachmentsView.classList.add('hidden');
|
|
break;
|
|
case SidebarView.ATTACHMENTS:
|
|
if (this.attachmentsButton.disabled) {
|
|
return;
|
|
}
|
|
this.thumbnailButton.classList.remove('toggled');
|
|
this.outlineButton.classList.remove('toggled');
|
|
this.attachmentsButton.classList.add('toggled');
|
|
|
|
this.thumbnailView.classList.add('hidden');
|
|
this.outlineView.classList.add('hidden');
|
|
this.attachmentsView.classList.remove('hidden');
|
|
break;
|
|
default:
|
|
console.error('PDFSidebar_switchView: "' + view +
|
|
'" is an unsupported value.');
|
|
return;
|
|
}
|
|
// Update the active view *after* it has been validated above,
|
|
// in order to prevent setting it to an invalid state.
|
|
this.active = view | 0;
|
|
|
|
if (forceOpen && !this.isOpen) {
|
|
this.open();
|
|
return; // NOTE: Opening will trigger rendering, and dispatch the event.
|
|
}
|
|
if (shouldForceRendering) {
|
|
this._forceRendering();
|
|
}
|
|
if (isViewChanged) {
|
|
this._dispatchEvent();
|
|
}
|
|
this._hideUINotification(this.active);
|
|
}
|
|
|
|
open() {
|
|
if (this.isOpen) {
|
|
return;
|
|
}
|
|
this.isOpen = true;
|
|
this.toggleButton.classList.add('toggled');
|
|
|
|
this.outerContainer.classList.add('sidebarMoving');
|
|
this.outerContainer.classList.add('sidebarOpen');
|
|
|
|
if (this.active === SidebarView.THUMBS) {
|
|
this._updateThumbnailViewer();
|
|
}
|
|
this._forceRendering();
|
|
this._dispatchEvent();
|
|
|
|
this._hideUINotification(this.active);
|
|
}
|
|
|
|
close() {
|
|
if (!this.isOpen) {
|
|
return;
|
|
}
|
|
this.isOpen = false;
|
|
this.toggleButton.classList.remove('toggled');
|
|
|
|
this.outerContainer.classList.add('sidebarMoving');
|
|
this.outerContainer.classList.remove('sidebarOpen');
|
|
|
|
this._forceRendering();
|
|
this._dispatchEvent();
|
|
}
|
|
|
|
toggle() {
|
|
if (this.isOpen) {
|
|
this.close();
|
|
} else {
|
|
this.open();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
_dispatchEvent() {
|
|
this.eventBus.dispatch('sidebarviewchanged', {
|
|
source: this,
|
|
view: this.visibleView,
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
_forceRendering() {
|
|
if (this.onToggled) {
|
|
this.onToggled();
|
|
} else { // Fallback
|
|
this.pdfViewer.forceRendering();
|
|
this.pdfThumbnailViewer.forceRendering();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
_updateThumbnailViewer() {
|
|
let { pdfViewer, pdfThumbnailViewer, } = this;
|
|
|
|
// Use the rendered pages to set the corresponding thumbnail images.
|
|
let pagesCount = pdfViewer.pagesCount;
|
|
for (let pageIndex = 0; pageIndex < pagesCount; pageIndex++) {
|
|
let pageView = pdfViewer.getPageView(pageIndex);
|
|
if (pageView && pageView.renderingState === RenderingStates.FINISHED) {
|
|
let thumbnailView = pdfThumbnailViewer.getThumbnail(pageIndex);
|
|
thumbnailView.setImage(pageView);
|
|
}
|
|
}
|
|
pdfThumbnailViewer.scrollThumbnailIntoView(pdfViewer.currentPageNumber);
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
_showUINotification(view) {
|
|
if (this.disableNotification) {
|
|
return;
|
|
}
|
|
|
|
this.l10n.get('toggle_sidebar_notification.title', null,
|
|
'Toggle Sidebar (document contains outline/attachments)').
|
|
then((msg) => {
|
|
this.toggleButton.title = msg;
|
|
});
|
|
|
|
if (!this.isOpen) {
|
|
// Only show the notification on the `toggleButton` if the sidebar is
|
|
// currently closed, to avoid unnecessarily bothering the user.
|
|
this.toggleButton.classList.add(UI_NOTIFICATION_CLASS);
|
|
} else if (view === this.active) {
|
|
// If the sidebar is currently open *and* the `view` is visible, do not
|
|
// bother the user with a notification on the corresponding button.
|
|
return;
|
|
}
|
|
|
|
switch (view) {
|
|
case SidebarView.OUTLINE:
|
|
this.outlineButton.classList.add(UI_NOTIFICATION_CLASS);
|
|
break;
|
|
case SidebarView.ATTACHMENTS:
|
|
this.attachmentsButton.classList.add(UI_NOTIFICATION_CLASS);
|
|
break;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
_hideUINotification(view) {
|
|
if (this.disableNotification) {
|
|
return;
|
|
}
|
|
|
|
let removeNotification = (view) => {
|
|
switch (view) {
|
|
case SidebarView.OUTLINE:
|
|
this.outlineButton.classList.remove(UI_NOTIFICATION_CLASS);
|
|
break;
|
|
case SidebarView.ATTACHMENTS:
|
|
this.attachmentsButton.classList.remove(UI_NOTIFICATION_CLASS);
|
|
break;
|
|
}
|
|
};
|
|
|
|
if (!this.isOpen && view !== null) {
|
|
// Only hide the notifications when the sidebar is currently open,
|
|
// or when it is being reset (i.e. `view === null`).
|
|
return;
|
|
}
|
|
this.toggleButton.classList.remove(UI_NOTIFICATION_CLASS);
|
|
|
|
if (view !== null) {
|
|
removeNotification(view);
|
|
return;
|
|
}
|
|
for (view in SidebarView) { // Remove all sidebar notifications on reset.
|
|
removeNotification(SidebarView[view]);
|
|
}
|
|
|
|
this.l10n.get('toggle_sidebar.title', null, 'Toggle Sidebar').
|
|
then((msg) => {
|
|
this.toggleButton.title = msg;
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @private
|
|
*/
|
|
_addEventListeners() {
|
|
this.viewerContainer.addEventListener('transitionend', (evt) => {
|
|
if (evt.target === this.viewerContainer) {
|
|
this.outerContainer.classList.remove('sidebarMoving');
|
|
}
|
|
});
|
|
|
|
// Buttons for switching views.
|
|
this.thumbnailButton.addEventListener('click', () => {
|
|
this.switchView(SidebarView.THUMBS);
|
|
});
|
|
|
|
this.outlineButton.addEventListener('click', () => {
|
|
this.switchView(SidebarView.OUTLINE);
|
|
});
|
|
this.outlineButton.addEventListener('dblclick', () => {
|
|
this.eventBus.dispatch('toggleoutlinetree', { source: this, });
|
|
});
|
|
|
|
this.attachmentsButton.addEventListener('click', () => {
|
|
this.switchView(SidebarView.ATTACHMENTS);
|
|
});
|
|
|
|
// Disable/enable views.
|
|
this.eventBus.on('outlineloaded', (evt) => {
|
|
let outlineCount = evt.outlineCount;
|
|
|
|
this.outlineButton.disabled = !outlineCount;
|
|
|
|
if (outlineCount) {
|
|
this._showUINotification(SidebarView.OUTLINE);
|
|
} else if (this.active === SidebarView.OUTLINE) {
|
|
// If the outline view was opened during document load, switch away
|
|
// from it if it turns out that the document has no outline.
|
|
this.switchView(SidebarView.THUMBS);
|
|
}
|
|
});
|
|
|
|
this.eventBus.on('attachmentsloaded', (evt) => {
|
|
if (evt.attachmentsCount) {
|
|
this.attachmentsButton.disabled = false;
|
|
|
|
this._showUINotification(SidebarView.ATTACHMENTS);
|
|
return;
|
|
}
|
|
|
|
// Attempt to avoid temporarily disabling, and switching away from, the
|
|
// attachment view for documents that do not contain proper attachments
|
|
// but *only* FileAttachment annotations. Hence we defer those operations
|
|
// slightly to allow time for parsing any FileAttachment annotations that
|
|
// may be present on the *initially* rendered page of the document.
|
|
Promise.resolve().then(() => {
|
|
if (this.attachmentsView.hasChildNodes()) {
|
|
// FileAttachment annotations were appended to the attachment view.
|
|
return;
|
|
}
|
|
this.attachmentsButton.disabled = true;
|
|
|
|
if (this.active === SidebarView.ATTACHMENTS) {
|
|
// If the attachment view was opened during document load, switch away
|
|
// from it if it turns out that the document has no attachments.
|
|
this.switchView(SidebarView.THUMBS);
|
|
}
|
|
});
|
|
});
|
|
|
|
// Update the thumbnailViewer, if visible, when exiting presentation mode.
|
|
this.eventBus.on('presentationmodechanged', (evt) => {
|
|
if (!evt.active && !evt.switchInProgress && this.isThumbnailViewVisible) {
|
|
this._updateThumbnailViewer();
|
|
}
|
|
});
|
|
}
|
|
}
|
|
|
|
export {
|
|
SidebarView,
|
|
PDFSidebar,
|
|
};
|